権限管理 - ApsaraMQ for RocketMQ - Alibaba Cloud ドキュメントセンター

Resource Access Management (RAM) は Alibaba Cloud によって提供される、ユーザーのアイデンティティとリソースの権限を管理するためのサービスです。RAM を使用すると、Alibaba Cloud アカウント (root ユーザー) のキーを他のユーザーと共有することを回避でき、ユーザーに必要最小限の権限を付与できます。RAM ではポリシーを使用して権限付与を定義します。このトピックでは、RAM ポリシーの一般的な構造と、のポリシーステートメントを構成する要素である「アクション (Action)」「リソース (Resource)」および「条件 (Condition) 」について説明します。は、RAM コード (RamCode) が rocketmq で、 RESOURCE での権限付与がサポートされています。

一般的なポリシー構造

RAM ポリシーは、一般的に以下のような JSON 構造で構成されます。

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "<Effect>",
      "Action": "<Action>",
      "Resource": "<Resource>",
      "Condition": {
        "<Condition_operator>": {
          "<Condition_key>": [
            "<Condition_value>"
          ]
        }
      }
    }
  ]
}

ポリシーのフィールドに関する説明：

Version：ポリシーのバージョン番号。現在のポリシーバージョンは 1 です。
Statement：
- Effect：「許可するか、拒否するか」という、最終的な結果を定義します。有効な値：Allow (許可) または Deny (拒否)。
- Action：「何をすることができるか、できないか」を定義する、リソースへの具体的な操作を指します。
- Resource：「何に対して操作を行うか」を定義する、操作の具体的な対象です。対象となるリソースは、ARN (Alibaba Cloud Resource Name) を使用して指定できます。
- Condition：「どのような状況下でポリシーが適用されるか」という、権限が有効になるための付加的な制約条件を定義します。このフィールドは任意です。
  - Condition operator：条件の演算子。条件キーの値とリクエスト値をどのように比較するかを定義する「比較方法」です。条件演算子は、条件のタイプによって異なります。
  - Condition_key：条件のキー。ポリシーの条件が満たされているかを判断するために、リクエストから参照・チェックされる特定の属性を指します。
  - Condition_value：条件の値。条件キーから取得されたリクエスト値と比較するための、具体的な「基準値」です。

アクション (Action)

下表に、で定義されたアクションを示します。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定する必要があります。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。詳細については、「共通条件キー」をご参照ください。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション	API	アクセスレベル	リソースタイプ	条件キー	依存アクション
rocketmq:DeleteTopic	DeleteTopic	delete	*Topic `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/topic/{#TopicName}`	なし	なし
rocketmq:ListDisasterRecoveryItems	ListDisasterRecoveryItems	get	*Instance `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}`	なし	なし
rocketmq:DeleteDisasterRecoveryPlan	DeleteDisasterRecoveryPlan	update	*Instance `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}`	なし	なし
rocketmq:DeleteInstance	DeleteInstance	delete	*Instance `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}`	なし	なし
rocketmq:GetDisasterRecoveryPlan	GetDisasterRecoveryPlan	get	*Instance `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}`	なし	なし
rocketmq:ListMessages	ListMessages	list	*Topic `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/topic/{#TopicName}`	なし	なし
rocketmq:UpdateDisasterRecoveryPlan	UpdateDisasterRecoveryPlan	update	*Instance `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}`	なし	なし
rocketmq:StopDisasterRecoveryItem	StopDisasterRecoveryItem	update	*Topic `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/topic/{#TopicName}`	なし	なし
rocketmq:UpdateInstanceAcl	UpdateInstanceAcl	update	*Instance `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}`	なし	なし
rocketmq:CreateDisasterRecoveryPlan	CreateDisasterRecoveryPlan	update	*Instance `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}`	なし	なし
rocketmq:CreateInstanceIpWhitelist	CreateInstanceIpWhitelist	create	*Instance `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}`	なし	なし
rocketmq:CreateInstanceAcl	CreateInstanceAcl	create	*Instance `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}`	なし	なし
rocketmq:GetTopic	GetTopic	get	*Topic `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/topic/{#TopicName}`	なし	なし
rocketmq:ListDisasterRecoveryCheckpoints	ListDisasterRecoveryCheckpoints	list	All Resource ``	なし	なし
rocketmq:GetInstance	GetInstance	get	*Instance `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}`	なし	なし
rocketmq:ListTopics	ListTopics	list	Topic `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/topic/`	なし	なし
rocketmq:GetConsumeTimespan	GetConsumeTimespan	get	*ConsumerGroup `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/topic/{#TopicName}/consumergroup/{#ConsumerGroupId}`	なし	なし
rocketmq:VerifySendMessage	VerifySendMessage	update	*Topic `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/topic/{#TopicName}`	なし	なし
rocketmq:TagResources	TagResources	update	All Resource ``	なし	なし
rocketmq:UpdateInstance	UpdateInstance	update	*Instance `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}`	なし	なし
rocketmq:CreateInstanceAccount	CreateInstanceAccount	create	*Instance `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}`	なし	なし
rocketmq:ListConsumerConnections	ListConsumerConnections	list	*ConsumerGroup `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/consumergroup/{#ConsumerGroupId}`	なし	なし
rocketmq:VerifyConsumeMessage	VerifyConsumeMessage	update	*Topic `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/topic/{#TopicName}`	なし	なし
rocketmq:ResetConsumeOffset	ResetConsumeOffset	update	*ConsumerGroup `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/consumergroup/{#ConsumerGroupId}`	なし	なし
rocketmq:UpdateDisasterRecoveryItem	UpdateDisasterRecoveryItem	update	*DisasterRecoveryItem `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/topic/{#TopicName}`	なし	なし
rocketmq:ListTagResources	ListTagResources	list	All Resource ``	なし	なし
rocketmq:GetMessageDetail	GetMessageDetail	get	*Topic `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/topic/{#TopicName}`	なし	なし
rocketmq:GetTrace	GetTrace	get	*Topic `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/topic/{#TopicName}`	なし	なし
rocketmq:GetInstanceIpWhitelist	GetInstanceIpWhitelist	get	*IpWhitelist `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}`	なし	なし
rocketmq:ListTraces	ListTraces	get	*Topic `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/topic/{#TopicName}`	なし	なし
rocketmq:SyncDisasterRecoveryCheckpoint	SyncDisasterRecoveryCheckpoint	update	All Resource ``	なし	なし
rocketmq:ListInstanceAcl	ListInstanceAcl	list	*Instance `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}`	なし	なし
rocketmq:ListConsumerGroupSubscriptions	ListConsumerGroupSubscriptions	list	*ConsumerGroup `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/consumergroup/{#ConsumerGroupId}`	なし	なし
rocketmq:ListInstances	ListInstances	list	Instance `acs:rocketmq:{#regionId}:{#accountId}:instance/`	なし	なし
rocketmq:ListMigrations	ListMigrations	list	All Resource ``	なし	なし
rocketmq:DeleteDisasterRecoveryItem	DeleteDisasterRecoveryItem	update	*Topic `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/topic/{#TopicName}`	なし	なし
rocketmq:ExecuteMigrationOperation	ExecuteMigrationOperation	update	*Instance `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}`	なし	なし
rocketmq:DeleteConsumerGroupSubscription	DeleteConsumerGroupSubscription	delete	*ConsumerGroup `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/consumergroup/{#ConsumerGroupId}`	なし	なし
rocketmq:GetDisasterRecoveryItem	GetDisasterRecoveryItem	get	*Topic `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/topic/{#TopicName}`	なし	なし
rocketmq:ListTopicSubscriptions	ListTopicSubscriptions	list	*Topic `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/topic/{#TopicName}`	なし	なし
rocketmq:GetInstanceAccount	GetInstanceAccount	get	*Instance `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}`	なし	なし
rocketmq:UpdateInstanceAccount	UpdateInstanceAccount	update	*Instance `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}`	なし	なし
rocketmq:FinishMigrationStage	FinishMigrationStage	update	*Instance `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}`	なし	なし
rocketmq:GetInstanceAcl	GetInstanceAcl	get	*Acl `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}`	なし	なし
rocketmq:GetConsumerGroup	GetConsumerGroup	get	*ConsumerGroup `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/consumergroup/{#ConsumerGroupId}`	なし	なし
rocketmq:GetConsumerGroupLag	GetConsumerGroupLag	get	*ConsumerGroup `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/consumergroup/{#ConsumerGroupId}`	なし	なし
rocketmq:AddDisasterRecoveryItem	AddDisasterRecoveryItem	update	*Topic `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/topic/{#TopicName}`	なし	なし
rocketmq:DeleteConsumerGroup	DeleteConsumerGroup	delete	*ConsumerGroup `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/consumergroup/{#ConsumerGroupId}`	なし	なし
rocketmq:ListDisasterRecoveryPlans	ListDisasterRecoveryPlans	get	All Resource ``	なし	なし
rocketmq:ListInstanceIpWhitelist	ListInstanceIpWhitelist	list	*Instance `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}`	なし	なし
rocketmq:CreateInstance	CreateInstance	create	Instance `acs:rocketmq:{#regionId}:{#accountId}:Instance/`	なし	なし
rocketmq:UpdateTopic	UpdateTopic	update	*Topic `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/topic/{#TopicName}`	なし	なし
rocketmq:CreateTopic	CreateTopic	create	*Topic `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/topic/{#TopicName}`	なし	なし
rocketmq:UpdateConsumerGroup	UpdateConsumerGroup	update	*ConsumerGroup `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/consumergroup/{#ConsumerGroupId}`	なし	なし
rocketmq:ListInstanceAccount	ListInstanceAccount	list	*Instance `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}`	なし	なし
rocketmq:ListMigrationOperations	ListMigrationOperations	list	*Instance `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}`	なし	なし
rocketmq:CreateConsumerGroup	CreateConsumerGroup	create	*ConsumerGroup `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/consumergroup/{#ConsumerGroupId}`	なし	なし
rocketmq:StartDisasterRecoveryItem	StartDisasterRecoveryItem	update	*Topic `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/topic/{#TopicName}`	なし	なし
rocketmq:UntagResources	UntagResources	update	All Resource ``	なし	なし
rocketmq:DeleteInstanceAccount	DeleteInstanceAccount	delete	*Instance `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}`	なし	なし
rocketmq:GetConsumerStack	GetConsumerStack	get	*ConsumerGroup `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/consumergroup/{#ConsumerGroupId}`	なし	なし
rocketmq:ListConsumerGroups	ListConsumerGroups	list	ConsumerGroup `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/consumergroup/`	なし	なし
rocketmq:GetConsumerGroupSubscription	GetConsumerGroupSubscription	get	*ConsumerGroup `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/consumergroup/{#ConsumerGroupId}`	なし	なし
rocketmq:DeleteInstanceAcl	DeleteInstanceAcl	delete	*Instance `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}`	なし	なし
rocketmq:ListMetricMeta	ListMetricMeta	list	All Resource ``	なし	なし
rocketmq:DeleteInstanceIpWhitelist	DeleteInstanceIpWhitelist	delete	*Instance `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}`	なし	なし
rocketmq:ChangeResourceGroup	ChangeResourceGroup	update	*Instance `acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}`	なし	なし

リソース (Resource)

下表に、で定義されたリソースを示します。ポリシーステートメントのResource要素で指定することで、特定のアクションの適用対象を設定できます。各リソースは対応する ARN を持ち、一意的に識別されます。ARN はacs:{#ramcode}:{#regionId}:{#accountId}:{#resourceType}形式で、構成要素は以下のとおりです。

acs：Alibaba Cloud Service の頭文字で、Alibaba Cloud のパブリッククラウドを指します。
{#ramcode}：RAM における具体的な Alibaba Cloud サービスの識別コード。
{#regionId}：リージョン ID。アスタリスク (*) に設定した場合、リソースがすべてのリージョンに適用することを示します。
{#accountId}：Alibaba Cloud アカウントの ID。アスタリスク (*) に設定した場合、リソースがすべての Alibaba Cloud アカウントに適用することを示します。
{#resourceType}：具体的な Alibaba Cloud サービスによって定義されたリソースの識別子で、ファイルパスに似た階層構造をサポートしています。アスタリスク (*) に設定した場合、ステートメントがすべてのリソースに適用することを示します。

リソースタイプ	ARN
Topic	acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/topic/{#TopicName} acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/topic/*
Instance	acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId} acs:rocketmq:{#regionId}:{#accountId}:instance/* acs:rocketmq::{#accountId}: acs:rocketmq:{#regionId}:{#accountId}:* acs:rocketmq:{#regionId}:{#accountId}:Instance/*
ConsumerGroup	acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/topic/{#TopicName}/consumergroup/{#ConsumerGroupId} acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/consumergroup/{#ConsumerGroupId} acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/consumergroup/*
DisasterRecoveryItem	acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}/topic/{#TopicName}
IpWhitelist	acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}
Acl	acs:rocketmq:{#regionId}:{#accountId}:instance/{#InstanceId}

条件 (Condition)

下表に、で定義されたプロダクトレベルの条件キーを示します。このほかに、Alibaba Cloud の共通条件キーを使用することもできます。これらのキーをポリシーステートメントのCondition要素として指定することで、きめ細かい権限付与ルールを定義できます。条件キーで、ポリシーのCondition_value要素で条件の値を指定します。

各条件キーには、文字列、数値、ブール値、IP アドレスといった特定のデータ型が定められています。データ型によって使用できる条件演算子が異なるため、キーのデータ型に基づいて適切な演算子を指定する必要があります。不適切な演算子を指定した場合、ポリシーステートメントは機能しません。データ型と条件演算子の対応関係については、「Condition_operator」をご参照ください。

条件キー	説明	データ型
rocketmq:InternetSpec	インターネットアクセス機能を有効にするかどうか	String

カスタム RAM ポリシーの作成方法

カスタムポリシーを作成し、RAM ユーザー、RAM ユーザーグループ、または RAM ロールに付与できます。詳細については、以下をご参照ください。