翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Resource Groups で IAM を使用する方法
<a name="security_iam_service-with-iam"></a>

Resource Groups へのアクセスを管理するために IAM を使用する前に、Resource Groups でどの IAM 機能が使用できるかを理解しておく必要があります。Resource Groups およびその他の AWS のサービスが IAM と連携する方法の概要を把握するには、「IAM ユーザーガイド」の 「[IAM と連携するAWS サービス](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)」を参照してください。

**Topics**
+ [Resource Groups のアイデンティティベースのポリシー](#security_iam_service-with-iam-id-based-policies-arg-te)
+ [リソースベースのポリシー](#security_iam_resource-based-policies)
+ [Resource Groups タグに基づいた承認](#security_iam_tags)
+ [Resource Groups の IAM ロール](#security_iam_roles)

## Resource Groups のアイデンティティベースのポリシー
<a name="security_iam_service-with-iam-id-based-policies-arg-te"></a>

IAM アイデンティティベースのポリシーでは許可または拒否するアクションとリソース、またアクションを許可または拒否する条件を指定できます。Resource Groups は、特定のアクション、リソース、および条件キーをサポートしています。JSON ポリシーで使用するすべての要素については、「IAM ユーザーガイド」の「[IAM JSON ポリシー要素のリファレンス](https://docs.aws.amazon.com//IAM/latest/UserGuide/reference_policies_elements.html)」を参照してください。

### アクション
<a name="security_iam_service-with-iam-id-based-policies-actions-arg-te"></a>

管理者は JSON AWS ポリシーを使用して、誰が何にアクセスできるかを指定できます。つまり、どの**プリンシパル**がどの**リソース**に対してどのような**条件下で****アクション**を実行できるかということです。

JSON ポリシーの `Action` 要素にはポリシー内のアクセスを許可または拒否するために使用できるアクションが記述されます。このアクションは関連付けられたオペレーションを実行するためのアクセス許可を付与するポリシーで使用されます。

Resource Groups のポリシーアクションは、アクションの前にプレフィックス `resource-groups:` を使用します。タグエディタのアクションはコンソールで完全に実行されますが、ログエントリにプレフィックス `resource-explorer` が付けられます。

例えば、Resource Groups `CreateGroup` API オペレーションを使用して Resource Groups グループを作成するアクセス許可を付与するには、ポリシーに `resource-groups:CreateGroup` アクションを含めます。ポリシーステートメントには`Action` または `NotAction` 要素を含める必要があります。Resource Groups は、このサービスで実行できるタスクを記述する独自のアクションのセットを定義します。

単一のステートメントに複数の Resource Groups およびタグエディタのアクションを指定するには、次のようにコンマで区切ります。

```
"Action": [
      "resource-groups:action1",
      "resource-groups:action2",
      "resource-explorer:action3"
```

ワイルドカード (\$1) を使用して複数アクションを指定できます。例えば、`List` という単語で始まるすべてのアクションを指定するには次のアクションを含めます。

```
"Action": "resource-groups:List*"
```

Resource Groups アクションのリストを表示するには、「IAM ユーザーガイド」の「[AWS Resource Groupsのアクション、リソース、および条件キー](https://docs.aws.amazon.com//IAM/latest/UserGuide/list_awsresourcegroups.html)」を参照してください。

### リソース
<a name="security_iam_service-with-iam-id-based-policies-resources-arg-te"></a>

管理者は JSON AWS ポリシーを使用して、誰が何にアクセスできるかを指定できます。つまり、どの**プリンシパル**がどの**リソース**に対してどのような**条件**下で**アクション**を実行できるかということです。

`Resource` JSON ポリシー要素はアクションが適用されるオブジェクトを指定します。ベストプラクティスとして、[Amazon リソースネーム (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) を使用してリソースを指定します。リソースレベルのアクセス許可をサポートしないアクションの場合は、ステートメントがすべてのリソースに適用されることを示すために、ワイルドカード (\$1) を使用します。

```
"Resource": "*"
```



Resource Groups の唯一のリソースは、グループです。グループリソースには、次の形式の ARN があります。

```
arn:${Partition}:resource-groups:${Region}:${Account}:group/${GroupName}
```

ARN の形式の詳細については、[「Amazon リソースネーム (ARNs AWS 「サービス名前空間](https://docs.aws.amazon.com//general/latest/gr/aws-arns-and-namespaces.html)」を参照してください。

例えば、ステートメントで `my-test-group` リソースグループを指定するには、次の ARN を使用します。

```
"Resource": "arn:aws:resource-groups:us-east-1:123456789012:group/my-test-group"
```

特定のアカウントに属するすべてのグループを指定するには、ワイルドカード (\$1) を使用します。

```
"Resource": "arn:aws:resource-groups:us-east-1:123456789012:group/*"
```

リソースの作成など、一部の Resource Groups アクションは、特定のリソースで実行できません。このような場合はワイルドカード \$1を使用する必要があります。

```
"Resource": "*"
```

一部の Resource Groups API アクションには、複数のリソースを関連させることができます。例えば、`DeleteGroup` はグループを削除するため、呼び出し元のプリンシパルは特定のグループまたはすべてのグループを削除するためのアクセス許可を持っている必要があります。複数リソースを単一ステートメントで指定するには、ARN をカンマで区切ります。

```
"Resource": [
  "resource1",
  "resource2"
]
```

Resource Groups のリソースタイプとその ARN のリスト、およびどのアクションで各リソースの ARN を指定できるかについては、「[IAM ユーザーガイド](https://docs.aws.amazon.com//IAM/latest/UserGuide/list_awsresourcegroups.html)」の「 AWS Resource Groupsのアクション、リソース、および条件キー」を参照してください。

### 条件キー
<a name="security_iam_id-based-policies-conditionkeys"></a>

管理者は JSON AWS ポリシーを使用して、誰が何にアクセスできるかを指定できます。つまり、どの**プリンシパル**がどの**リソース**に対してどのような**条件下で****アクション**を実行できるかということです。

`Condition` 要素は、定義された基準に基づいてステートメントが実行される時期を指定します。イコールや未満などの[条件演算子](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html)を使用して条件式を作成して、ポリシーの条件とリクエスト内の値を一致させることができます。すべての AWS グローバル条件キーを確認するには、*「IAM ユーザーガイド*」の[AWS 「グローバル条件コンテキストキー](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html)」を参照してください。

Resource Groups は独自の条件キーを定義し、一部のグローバル条件キーの使用もサポートしています。すべての AWS グローバル条件キーを確認するには、*IAM ユーザーガイド*の[AWS 「グローバル条件コンテキストキー](https://docs.aws.amazon.com//IAM/latest/UserGuide/reference_policies_condition-keys.html)」を参照してください。

Resource Groups の条件キーのリスト、およびどのアクションおよびリソースで条件キーを使用できるかについては、「IAM ユーザーガイド」の「[AWS Resource Groupsのアクション、リソース、条件キー](https://docs.aws.amazon.com//IAM/latest/UserGuide/list_awsresourcegroups.html)」を参照してください。

### 例
<a name="security_iam-id-based-policies-examples"></a>

Resource Groups のアイデンティティベースポリシーの例を確認するには、「[AWS Resource Groups アイデンティティベースのポリシーの例](security_iam_id-based-policy-examples.md)」を参照してください。

## リソースベースのポリシー
<a name="security_iam_resource-based-policies"></a>

Resource Groups では、リソースベースのポリシーはサポートされていません。

## Resource Groups タグに基づいた承認
<a name="security_iam_tags"></a>

Resource Groups のグループにタグをアタッチしたり、リクエスト内のタグを Resource Groups に渡したりできます。タグに基づいてアクセスを管理するには、`aws:ResourceTag/key-name`、`aws:RequestTag/key-name`、または `aws:TagKeys` の条件キーを使用して、ポリシーの [[条件要素](https://docs.aws.amazon.com//IAM/latest/UserGuide/reference_policies_elements_condition.html)] でタグ情報を提供します。グループを作成または更新するときに、グループにタグを適用することができます。Resource Groups でのグループのタグ付けの詳細については、このガイドの「[でのクエリベースのグループの作成 AWS Resource Groups](gettingstarted-query.md)」および「[でのグループの更新 AWS Resource Groups](updating-resource-groups.md)」を参照してください。

リソースのタグに基づいてリソースへのアクセスを制限するためのアイデンティティベースポリシーの例を表示するには、「[タグに基づいたグループの表示](security_iam_id-based-policy-examples.md#security_iam_policy-examples-view-tags)」を参照してください。

## Resource Groups の IAM ロール
<a name="security_iam_roles"></a>

[IAM ロール](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles.html)は、特定のアクセス許可を持つ AWS アカウント内のエンティティです。Resource Groups にはサービスロールがないか、または使用しません。

### Resource Groups を使用した一時的な認証情報の使用
<a name="security_iam_roles-tempcreds"></a>

Resource Groups では、一時的な認証情報を使用して、フェデレーションでサインイン、IAM ロールを引き受ける、またはクロスアカウントロールを引き受けることができます。一時的なセキュリティ認証情報を取得するには、[AssumeRole](https://docs.aws.amazon.com//STS/latest/APIReference/API_AssumeRole.html) や [GetFederationToken](https://docs.aws.amazon.com//STS/latest/APIReference/API_GetFederationToken.html) などの AWS STS API オペレーションを呼び出します。

### サービスリンクロール
<a name="security_iam_roles-service-linked"></a>

[サービスにリンクされたロール](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role)を使用すると、 AWS サービスは他の サービスのリソースにアクセスして、ユーザーに代わってアクションを実行できます。

Resource Groups にはサービスリンクロールがないか、または使用しません。

### サービス役割
<a name="security_iam_roles-service"></a>

この機能により、ユーザーに代わってサービスが[サービスロール](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-role)を引き受けることが許可されます。

Resource Groups にはサービスロールがないか、または使用しません。