CodePipeline アイデンティティベースのポリシー CodePipeline リソースベースのポリシー CodePipeline タグに基づく許可 CodePipeline IAM ロール

と IAM の AWS CodePipeline 連携方法

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

CodePipeline アイデンティティベースのポリシー

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

アクション

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

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

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

CodePipeline のポリシーアクションは、アクションの前にプレフィックス codepipeline: を使用します：。

例えば、アカウント内の既存のパイプラインを表示するアクセス許可を他のユーザーに付与するには、ユーザーのポリシーに codepipeline:GetPipeline アクションを含めます。ポリシーステートメントにはAction または NotAction 要素を含める必要があります。CodePipeline は、このサービスで実行できるタスクを記述する独自のアクションのセットを定義します。

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


"Action": [
      "codepipeline:action1",
      "codepipeline:action2"

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


"Action": "codepipeline:Get*"

CodePipeline アクションのリストを表示するには、IAM ユーザーガイドの「 AWS CodePipelineによって定義されたアクション」を参照してください。

リソース

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

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

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


"Resource": "*"

CodePipeline のリソースとオペレーション

CodePipeline では、プライマリリソースはパイプラインです。ポリシーで Amazon リソースネーム (ARN) を使用して、ポリシーを適用するリソースを識別します。CodePipeline は、ステージ、アクション、カスタムアクションなど、プライマリリソースで使用できる他のリソースに対応しています。これらはサブリソースと呼ばれます。これらのリソースとサブリソースには、一意の Amazon リソースネーム (ARN) が関連付けられています。ARNs「Amazon リソースネーム (ARN) と AWS のサービス名前空間」を参照してくださいAmazon Web Services 全般のリファレンス。パイプラインに関連付けられたパイプラインの ARN を取得するには、「設定コンソールに表示されるパイプラインの ARN 」を参照してください。詳細については、「パイプラインの ARN とサービスロール ARN (コンソール) を表示します。」を参照してください。

リソースタイプ	ARN 形式
パイプライン	arn:aws:コードパイプライン:[`領域`]:[`アカウント`]:[`パイプライン名`]
ステージ	arn:aws:コードパイプライン:[`領域`]:[`アカウント`]:[`パイプライン名`/`ステージ名`]
アクション	arn:aws:codepipeline:`region`:`account`:`pipeline-name`/`stage-name`/`action-name`
カスタムアクション	arn:aws:codepipeline:`region`:`account`:actiontype:`owner`/`category`/`provider`/`version`
全ての CodePipeline リソース	arn:aws:codepipeline:*
特定のリージョンの特定アカウントが所有するすべての CodePipeline リソース	arn:aws:コードパイプライン:[`領域`]:[`アカウント`]:*

注記

のほとんどのサービスは、ARN でコロン (:) またはスラッシュ (/) を同じ文字として AWS 扱います。 ARNs ただし、CodePipeline では、イベントパターンおよびルールは完全に一致しています。イベントパターンの作成時に正しい ARN 文字を使用して、一致させるリソース内の ARN 構文とそれらの文字が一致する必要があります。

CodePipeline には、リソースレベルのアクセス許可に対応する API コールの機能があります。リソースレベルのアクセス許可は、API コールでリソース ARN を指定できるかどうか、または API コールでワイルドカードを使用したすべてのリソースの呼び出しのみが可能かどうかを示します。リソースレベルのアクセス許可の詳細な説明と、リソースレベルのアクセス許可をサポートする CodePipeline API コールの一覧については、CodePipeline 許可リファレンスを参照してください。

例えば、以下の要領で ARN を使用して、ステートメント内の特定のパイプライン (myPipeline) を指定することができます。


"Resource": "arn:aws:codepipeline:us-east-2:111222333444:myPipeline"

また、以下の要領でワイルドカード文字 (*) を使用して、特定のアカウントに属するすべてのパイプラインを指定することもできます。


"Resource": "arn:aws:codepipeline:us-east-2:111222333444:*"

すべてのリソースを指定する場合、または特定の API アクションが ARN をサポートしていない場合は、以下のように、Resource エレメント内でワイルドカード文字 (*) を使用します。


"Resource": "*"

注記

IAM ポリシーを作成するとき、最小限の特権を認めるという標準的なセキュリティアドバイスに従いましょう。そうすれば、タスクを実行するというリクエストのアクセス許可のみを認めることができます。API コールが ARN をサポートしている場合、リソースレベルのアクセス許可をサポートしていて、ワイルドカード文字 (*) を使用する必要はありません。

一部の CodePipeline API コールは、複数のリソース (例:GetPipeline) を受け入れます。単一のステートメントに複数のリソースを指定するには、以下のようにコンマで ARN を区切ります。


"Resource": ["arn1", "arn2"]

CodePipeline には、CodePipeline リソースを操作できる一連のオペレーションが用意されています。使用可能なオペレーションのリストについては、「CodePipeline 許可リファレンス」を参照してください。

条件キー

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

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

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

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

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

すべてのアマゾン EC2 アクションはaws:RequestedRegion および ec2:Region 条件キーをサポートします。詳細については、「例: 特定のリージョンへのアクセスの制限」を参照してください。

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

例

CodePipeline アイデンティティベースのポリシーの例については、AWS CodePipeline アイデンティティベースポリシーの例を参照してください。

CodePipeline リソースベースのポリシー

CodePipeline は、リソースベースのポリシーに対応していません。ただし、CodePipeline に関連する S3 サービスのリソースベースのポリシーの例が提供されています。

例

CodePipeline リソースベースのポリシーの例を表示する場合、AWS CodePipeline リソースベースのポリシーの例を参照してください。

CodePipeline タグに基づく許可

CodePipeline リソースにタグをアタッチしたり、リクエスト内のタグを CodePipeline に渡したりできます。タグに基づいてアクセスを制御するには、codepipeline:ResourceTag/key-name、aws:RequestTag/key-name、または aws:TagKeys の条件キーを使用して、ポリシーの条件要素でタグ情報を提供します。CodePipeline リソースのタグ付けの詳細については、リソースのタグ付けを参照してください。

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

CodePipeline IAM ロール

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

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

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

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

サービス役割

CodePipeline は、サービスロールをユーザーに代わって引き受けることをサービスに許可します。この役割により、サービスがお客様に代わって他のサービスのリソースにアクセスし、アクションを完了することが許可されます。サービス役割はIAM アカウントに表示され、アカウントによって所有されます。つまり、IAM 管理者はこの役割の権限を変更できます。ただし、それにより、サービスの機能が損なわれる場合があります。

CodePipeline はサービスロールに対応しています。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

アイデンティティ/アクセス管理

アイデンティティベースのポリシーの例