

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

# Connect Customer が IAM と連携する方法
<a name="security_iam_service-with-iam"></a>

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

**Topics**
+ [Connect カスタマー ID ベースのポリシー](#security_iam_service-with-iam-id-based-policies)
+ [Connect Customer タグに基づく認可](#security_iam_service-with-iam-tags)
+ [お客様の IAM ロールを接続する](#security_iam_service-with-iam-roles)

## Connect カスタマー ID ベースのポリシー
<a name="security_iam_service-with-iam-id-based-policies"></a>

IAM アイデンティティベースのポリシーでは許可または拒否するアクションとリソース、またアクションを許可または拒否する条件を指定できます。Connect Customer は、特定のアクション、リソース、および条件キーをサポートしています。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"></a>

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

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

Connect Customer のポリシーアクションは、アクションの前にプレフィックス を使用します`connect:`。ポリシーステートメントには`Action` または `NotAction` 要素を含める必要があります。Connect Customer は、このサービスで実行できるタスクを記述する独自のアクションのセットを定義します。

単一のステートメントに複数のアクションを指定するには次のようにコンマで区切ります。

```
"Action": [
      "connect:action1",
      "connect:action2"
```

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

```
"Action": "connect:Describe*"
```

Connect Customer のアクション、[アクション、リソース、および条件キー](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonconnect.html)のリストを表示するには。

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

Connect Customer は、リソースレベルのアクセス許可 (IAM ポリシーでリソース ARN を指定) をサポートしています。Connect Customer リソースのリストを次に示します。
+ インスタンス
+ 問い合わせ
+ ユーザー
+ ルーティングプロファイル
+ セキュリティプロファイル
+ 階層グループ
+ [キュー]
+ システム
+ フロー
+ オペレーション時間
+ Phone number (電話番号)
+ タスクテンプレート
+ 顧客プロファイルのドメイン
+ 顧客プロファイルでのオブジェクトタイプ
+ アウトバウンドキャンペーン

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

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

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

Connect Customer インスタンスリソースには次の ARN があります。

```
arn:${Partition}:connect:${Region}:${Account}:instance/${InstanceId}
```

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

例えば、ステートメントで `i-1234567890abcdef0` インスタンスを指定するには、次の ARN を使用します。

```
"Resource": "arn:aws:connect:us-east-1:123456789012:instance/i-1234567890abcdef0"
```

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

```
"Resource": "arn:aws:connect:us-east-1:123456789012:instance/*"
```

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

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

多くの Connect Customer; API アクションには複数のリソースが含まれます。以下に例を挙げます。

複数リソースを単一ステートメントで指定するには、ARN をカンマで区切ります。

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

Connect Customer リソースタイプとその ARNs[「Connect Customer のアクション、リソース、および条件キー](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonconnect.html)」を参照してください。同じ記事で、各リソースの ARN を指定できるアクションについても説明します。

### 条件キー
<a name="security_iam_service-with-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)」を参照してください。

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

すべての Amazon EC2 アクションは `aws:RequestedRegion` および `ec2:Region` 条件キーをサポートします。詳細については、「[例: 特定のリージョンへのアクセスの制限](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ExamplePolicies_EC2.html#iam-example-region)」を参照してください。

Connect Customer 条件キーのリストを確認するには、[「Connect Customer のアクション、リソース、および条件キー](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonconnect.html)」を参照してください。

### 例
<a name="security_iam_service-with-iam-id-based-policies-examples"></a>

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

## Connect Customer タグに基づく認可
<a name="security_iam_service-with-iam-tags"></a>

Connect Customer リソースにタグをアタッチするか、Connect Customer へのリクエストでタグを渡すことができます。タグに基づいてアクセスを管理するには、`connect:ResourceTag/{{key-name}}`、`aws:RequestTag/{{key-name}}`、または `aws:TagKeys` の条件キーを使用して、ポリシーの[条件要素](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html)でタグ情報を提供します。

リソースのタグに基づいてリソースへのアクセスを制限するためのアイデンティティベースポリシーの例を表示するには、「[タグに基づいて Connect Customer ユーザーを記述および更新する](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-view-widget-tags)」を参照してください。

## お客様の IAM ロールを接続する
<a name="security_iam_service-with-iam-roles"></a>

[IAM ロール](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)は、特定のアクセス許可を持つ AWS アカウント内のエンティティです。

### Connect Customer での一時的な認証情報の使用
<a name="security_iam_service-with-iam-roles-tempcreds"></a>

一時的な認証情報を使用して、フェデレーションでサインインする、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 オペレーションを呼び出します。

Connect Customer は、一時的な認証情報の使用をサポートしています。

### サービスリンクロール
<a name="security_iam_service-with-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 サービスは他の サービスのリソースにアクセスして、ユーザーに代わってアクションを実行できます。サービスリンクロールは IAM アカウント内に表示され、サービスによって所有されます。IAM 管理者は、サービスリンクロールの許可を表示できますが、編集することはできません。

Connect Customer は、サービスにリンクされたロールをサポートしています。Connect Customer サービスにリンクされたロールの作成または管理の詳細については、「」を参照してください[Connect Customer のサービスにリンクされたロールとロールのアクセス許可を使用する](connect-slr.md)。

### Connect Customer での IAM ロールの選択
<a name="security_iam_service-with-iam-roles-choose"></a>

Connect Customer でリソースを作成するときは、Connect Customer がユーザーに代わって Amazon EC2 にアクセスすることを許可するロールを選択する必要があります。以前にサービスロールまたはサービスにリンクされたロールを作成している場合、Connect Customer は選択するロールのリストを提供します。Amazon EC2 インスタンスの起動と停止のためのアクセスを、許可するロールを選択することが重要です。