Amazon Elastic Container Registry と の連携方法 IAM - Amazon ECR
Amazon ECR Identity ベースのポリシーAmazon ECRリソースベースのポリシーAmazon ECR タグに基づく認可Amazon ECRIAMロール

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

Amazon Elastic Container Registry と の連携方法 IAM

IAM を使用して Amazon へのアクセスを管理する前にECR、Amazon で使用できるIAM機能を理解しておく必要がありますECR。Amazon ECRおよびその他の AWS のサービスが と連携する方法の概要を把握するにはIAM、「 IAMユーザーガイド」のAWS 「 と連携IAMする のサービス」を参照してください。

Amazon ECR Identity ベースのポリシー

IAM アイデンティティベースのポリシーでは、許可または拒否されたアクションとリソース、およびアクションが許可または拒否される条件を指定できます。Amazon は、特定のアクション、リソース、および条件キーECRをサポートしています。JSON ポリシーで使用するすべての要素については、「 ユーザーガイド」のIAMJSON「 ポリシー要素リファレンスIAM」を参照してください。

アクション

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

JSON ポリシーの Action要素は、ポリシーでアクセスを許可または拒否するために使用できるアクションを記述します。ポリシーアクションの名前は通常、関連する AWS APIオペレーションと同じです。一致するAPIオペレーションがないアクセス許可のみのアクションなど、いくつかの例外があります。また、ポリシーに複数のアクションが必要なオペレーションもあります。これらの追加アクションは、依存アクションと呼ばれます。

このアクションは、関連付けられたオペレーションを実行するための権限を付与するポリシーで使用されます。

Amazon のポリシーアクションは、アクションの前にプレフィックス ECRを使用しますecr:。例えば、Amazon ECRCreateRepositoryAPIオペレーションを使用して Amazon ECRリポジトリを作成するアクセス許可を付与するには、ポリシーに ecr:CreateRepositoryアクションを含めます。ポリシーステートメントには、Action または NotAction 要素を含める必要があります。Amazon ECRは、このサービスで実行できるタスクを記述する独自のアクションのセットを定義します。

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

"Action": [
      "ecr:action1",
      "ecr:action2"

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

"Action": "ecr:Describe*"

Amazon ECRアクションのリストを確認するには、「 IAMユーザーガイド」の「Amazon Elastic Container Registry のアクション、リソース、および条件キー」を参照してください。

リソース

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

Policy ResourceJSON要素は、アクションが適用されるオブジェクトを指定します。ステートメントには、Resource または NotResource 要素を含める必要があります。ベストプラクティスとして、Amazon リソースネーム (ARN) を使用してリソースを指定します。これは、リソースレベルの許可と呼ばれる特定のリソースタイプをサポートするアクションに対して実行できます。

オペレーションのリスト化など、リソースレベルの権限をサポートしないアクションの場合は、ステートメントがすべてのリソースに適用されることを示すために、ワイルドカード (*) を使用します。

"Resource": "*"

Amazon ECRリポジトリリソースには、次の がありますARN。

arn:${Partition}:ecr:${Region}:${Account}:repository/${Repository-name}

の形式の詳細についてはARNs、「Amazon リソースネーム (ARNs）」および AWS 「サービス名前空間」を参照してください。

例えば、 ステートメントの us-east-1リージョンでmy-repoリポジトリを指定するには、次の を使用しますARN。

"Resource": "arn:aws:ecr:us-east-1:123456789012:repository/my-repo"

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

"Resource": "arn:aws:ecr:us-east-1:123456789012:repository/*"

1 つのステートメントで複数のリソースを指定するには、 をカンマARNsで区切ります。

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

Amazon ECRリソースタイプとその のリストを確認するにはARNs、「 ユーザーガイド」の「Amazon Elastic Container Registry で定義されるリソースIAM」を参照してください。各リソースARNの を指定できるアクションについては、「Amazon Elastic Container Registry で定義されるアクション」を参照してください。

条件キー

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

Condition 要素 (または Condition ブロック) を使用すると、ステートメントが有効な条件を指定できます。Condition 要素はオプションです。イコールや未満などの 条件演算子 を使用して条件式を作成することで、ポリシーの条件とリクエスト内の値を一致させることができます。

1 つのステートメントに複数の Condition 要素を指定する場合、または 1 つの Condition 要素に複数のキーを指定する場合、 AWS では AND 論理演算子を使用してそれらを評価します。1 つの条件キーに複数の値を指定すると、 は論理ORオペレーションを使用して条件 AWS を評価します。ステートメントの権限が付与される前にすべての条件が満たされる必要があります。

条件を指定する際にプレースホルダー変数も使用できます。例えば、IAMユーザー名でタグ付けされている場合にのみ、リソースにアクセスするアクセス許可をIAMユーザーに付与できます。詳細については、「 ユーザーガイド」のIAM「ポリシー要素: 変数とタグIAM」を参照してください。

AWS は、グローバル条件キーとサービス固有の条件キーをサポートします。すべての AWS グローバル条件キーを確認するには、「 ユーザーガイド」のAWS 「 グローバル条件コンテキストキーIAM」を参照してください。

Amazon は独自の条件キーのセットECRを定義し、一部のグローバル条件キーの使用もサポートしています。すべての AWS グローバル条件キーを確認するには、「 IAMユーザーガイドAWS 」の「グローバル条件コンテキストキー」を参照してください。

ほとんどの Amazon ECRアクションは、 aws:ResourceTagおよび ecr:ResourceTag条件キーをサポートしています。詳細については、「タグベースのアクセスコントロールを使用する」を参照してください。

Amazon ECR条件キーのリストを確認するには、「 IAMユーザーガイド」の「Amazon Elastic Container Registry で定義される条件キー」を参照してください。条件キーを使用できるアクションとリソースについては、「Amazon Elastic Container Registry で定義されるアクション」を参照してください。

例

Amazon ECRアイデンティティベースのポリシーの例を表示するには、「」を参照してくださいAmazon Elastic Container Registry のアイデンティティベースのポリシーの例。

Amazon ECRリソースベースのポリシー

リソースベースのポリシーは、指定されたプリンシパルが Amazon ECRリソースに対して実行できるアクションと条件を指定するJSONポリシードキュメントです。Amazon ECRは、Amazon ECRリポジトリのリソースベースのアクセス許可ポリシーをサポートしています。リソースベースのポリシーでは、リソースごとに他の アカウントに使用許可を付与することができます。リソースベースのポリシーを使用して、 サービスが Amazon ECR リポジトリにアクセスすることを許可 AWS することもできます。

クロスアカウントアクセスを有効にするには、リソースベースのポリシー のプリンシパルとして、アカウント全体または別のアカウントのIAMエンティティを指定できます。リソースベースのポリシーにクロスアカウントのプリンシパルを追加しても、信頼関係は半分しか確立されない点に注意してください。プリンシパルとリソースが異なる AWS アカウントにある場合は、プリンシパルエンティティにリソースへのアクセス許可も付与する必要があります。アクセス許可は、アイデンティティベースのポリシーをエンティティにアタッチすることで付与します。ただし、リソースベースのポリシーで、同じアカウントのプリンシパルへのアクセス権が付与されている場合は、ID ベースのポリシーをさらに付与する必要はありません。詳細については、「 ユーザーガイド」のIAM「ロールとリソースベースのポリシーの違い」を参照してください。 IAM

Amazon ECRサービスは、リポジトリポリシー と呼ばれるリソースベースのポリシーの 1 つのタイプのみをサポートします。このポリシーはリポジトリ にアタッチされます。このポリシーは、リポジトリに対してアクションを実行できるプリンシパルエンティティ (アカウント、ユーザー、ロール、フェデレーティッドユーザー) を定義します。リソースベースのポリシーをリポジトリにアタッチする方法については、「Amazon ECR のプライベートリポジトリポリシー」を参照してください。

注記

Amazon ECRリポジトリポリシーでは、ポリシー要素は、IAMポリシーでサポートされていない追加の文字と間隔Sidをサポートします。

例

Amazon ECRリソースベースのポリシーの例を表示するには、「」、「」を参照してくださいAmazon ECR のプライベートリポジトリポリシーの例。

Amazon ECR タグに基づく認可

Amazon ECRリソースにタグをアタッチするか、Amazon へのリクエストでタグを渡すことができますECR。タグに基づいてアクセスを管理するには、ecr:ResourceTag/key-name、aws:RequestTag/key-name、または aws:TagKeys の条件キーを使用して、ポリシーの 条件要素でタグ情報を提供します。Amazon ECRリソースのタグ付けの詳細については、「」を参照してくださいAmazon でのプライベートリポジトリのタグ付け ECR。

リソースのタグに基づいてリソースへのアクセスを制限するためのアイデンティティベースポリシーの例を表示するには、「タグベースのアクセスコントロールを使用する」を参照してください。

Amazon ECRIAMロール

IAM ロールは、特定のアクセス許可を持つ AWS アカウント内のエンティティです。

Amazon での一時的な認証情報の使用 ECR

一時的な認証情報を使用して、フェデレーションでサインインしたり、 IAMロールを引き受けたり、クロスアカウントロールを引き受けたりすることができます。一時的なセキュリティ認証情報を取得するには、 AssumeRoleや などのオペレーションを呼び出し AWS STS APIますGetFederationToken。

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

サービスリンクロール

サービスにリンクされたロールを使用すると、 AWS サービスは他の サービスのリソースにアクセスして、ユーザーに代わってアクションを実行できます。サービスにリンクされたロールはIAMアカウントに表示され、サービスによって所有されます。IAM 管理者は、サービスにリンクされたロールのアクセス許可を表示できますが、編集することはできません。

Amazon ECRは、サービスにリンクされたロールをサポートしています。詳細については、「Amazon のサービスにリンクされたロールの使用 ECR」を参照してください。