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

AWS CodeStar Notifications および の ID とアクセスの管理 AWS CodeConnections

AWS Identity and Access Management （IAM) は、管理者が AWS リソースへのアクセスを安全に制御 AWS のサービス するのに役立つ です。IAM 管理者は、誰を認証 (サインイン) し、 AWS CodeStar 誰に通知と AWS CodeConnections リソースを使用する権限 (アクセス許可を持つ) を付与できるかを制御します。IAM は、追加料金なしで AWS のサービス 使用できる です。

対象者

AWS Identity and Access Management （IAM) の使用方法は、 AWS CodeStar Notifications と で実行する作業によって異なります AWS CodeConnections。

サービスユーザー – AWS CodeStar 通知と AWS CodeConnections サービスを使用してジョブを実行する場合、管理者は必要な認証情報とアクセス許可を提供します。より多くの AWS CodeStar 通知と AWS CodeConnections 機能を使用して作業を行う際に、追加のアクセス許可が必要になる場合があります。アクセスの管理方法を理解しておくと、管理者に適切な許可をリクエストするうえで役立ちます。Notifications と の機能にアクセスできない場合は AWS CodeConnections、 AWS CodeStar 「」を参照してくださいAWS CodeStar 通知と AWS CodeConnections ID とアクセスのトラブルシューティング。

サービス管理者 – 社内の AWS CodeStar 通知と AWS CodeConnections リソースを担当している場合は、 AWS CodeStar 通知と へのフルアクセスがある可能性があります AWS CodeConnections。サービスユーザーがどの AWS CodeStar 通知、 AWS CodeConnections 機能、リソースにアクセスする必要があるかを判断するのはお客様の仕事です。その後、IAM管理者にリクエストを送信して、サービスユーザーのアクセス許可を変更する必要があります。このページの情報を確認して、 の基本概念を理解しますIAM。Notifications と IAMで を使用する方法の詳細については AWS CodeConnections、 AWS CodeStar 「」を参照してくださいデベロッパーツールコンソールの の機能の仕組み IAM。

IAM 管理者 – IAM管理者の場合は、 AWS CodeStar 通知と へのアクセスを管理するためのポリシーの作成方法の詳細を知りたい場合があります AWS CodeConnections。で使用できる AWS CodeStar 通知と AWS CodeConnections アイデンティティベースのポリシーの例を表示するにはIAM、「」を参照してください アイデンティティベースポリシーの例。

アイデンティティを使用した認証

認証は、アイデンティティ認証情報 AWS を使用して にサインインする方法です。として、ユーザーとして、またはロールを引き受けることで認証 ( にサインイン AWS) される必要があります。 AWS アカウントのルートユーザー IAM IAM

ID ソースを介して提供された認証情報を使用して、フェデレーティッド ID AWS として にサインインできます。 AWS IAM Identity Center （IAM Identity Center) ユーザー、会社のシングルサインオン認証、Google または Facebook の認証情報は、フェデレーティッド ID の例です。フェデレーティッド ID としてサインインすると、管理者は以前に IAMロールを使用して ID フェデレーションをセットアップしていました。フェデレーション AWS を使用して にアクセスすると、間接的にロールを引き受けることになります。

ユーザーの種類に応じて、 AWS Management Console または AWS アクセスポータルにサインインできます。へのサインインの詳細については AWS、 AWS サインイン ユーザーガイドの「 へのサインイン方法 AWS アカウント」を参照してください。

AWS プログラムで にアクセスする場合、 はソフトウェア開発キット (SDK) とコマンドラインインターフェイス (CLI) AWS を提供し、認証情報を使用してリクエストに暗号化して署名します。 AWS ツールを使用しない場合は、自分でリクエストに署名する必要があります。推奨される方法を使用してリクエストに署名する方法の詳細については、 IAM ユーザーガイドのAWS API「リクエストの署名バージョン 4」を参照してください。

使用する認証方法を問わず、追加セキュリティ情報の提供をリクエストされる場合もあります。例えば、 は、アカウントのセキュリティを高めるために多要素認証 (MFA) を使用する AWS ことをお勧めします。詳細については、AWS IAM Identity Center 「 ユーザーガイド」の「多要素認証」とIAM「 ユーザーガイド」のAWS 「多要素認証IAM」を参照してください。

AWS アカウントのルートユーザー

を作成するときは AWS アカウント、アカウント内のすべての および リソースへの AWS のサービス 完全なアクセス権を持つ 1 つのサインイン ID から始めます。この ID は AWS アカウント ルートユーザーと呼ばれ、アカウントの作成に使用した E メールアドレスとパスワードでサインインしてアクセスします。日常的なタスクには、ルートユーザーを使用しないことを強くお勧めします。ルートユーザーの認証情報は保護し、ルートユーザーでしか実行できないタスクを実行するときに使用します。ルートユーザーとしてサインインする必要があるタスクの完全なリストについては、IAM「 ユーザーガイド」の「ルートユーザーの認証情報を必要とするタスク」を参照してください。

IAM ユーザーとグループ

IAM ユーザーとは、1 人のユーザーまたはアプリケーションに対して特定のアクセス許可 AWS アカウント を持つ 内の ID です。可能であれば、パスワードやアクセスキーなどの長期的な認証情報を持つIAMユーザーを作成する代わりに、一時的な認証情報に依存することをお勧めします。ただし、IAMユーザーとの長期的な認証情報を必要とする特定のユースケースがある場合は、アクセスキーをローテーションすることをお勧めします。詳細については、IAM「 ユーザーガイド」の「長期的な認証情報を必要とするユースケースのアクセスキーを定期的にローテーションする」を参照してください。

IAM グループは、IAMユーザーのコレクションを指定する ID です。グループとしてサインインすることはできません。グループを使用して、複数のユーザーに対して一度に権限を指定できます。多数のユーザーグループがある場合、グループを使用することで権限の管理が容易になります。例えば、 という名前のグループがありIAMAdmins、そのグループにIAMリソースを管理するアクセス許可を付与できます。

ユーザーは、ロールとは異なります。ユーザーは 1 人の人または 1 つのアプリケーションに一意に関連付けられますが、ロールはそれを必要とする任意の人が引き受けるようになっています。ユーザーには永続的な長期の認証情報がありますが、ロールでは一時認証情報が提供されます。詳細については、「 ユーザーガイド」のIAM「ユーザーのユースケース」を参照してください。 IAM

IAM ロール

IAM ロールは、特定のアクセス許可 AWS アカウント を持つ 内の ID です。ユーザーと似ていますがIAM、特定の人物には関連付けられていません。でIAMロールを一時的に引き受けるには AWS Management Console、ユーザーからIAMロール (コンソール) に切り替えることができます。または AWS API オペレーションを AWS CLI 呼び出すか、カスタム を使用してロールを引き受けることができますURL。ロールを使用する方法の詳細については、 IAM ユーザーガイドの「ロールを引き受ける方法」を参照してください。

IAM 一時的な認証情報を持つ ロールは、以下の状況で役立ちます。

ポリシーを使用したアクセスの管理

でアクセスを制御する AWS には、ポリシーを作成して AWS ID またはリソースにアタッチします。ポリシーは AWS 、アイデンティティまたはリソースに関連付けられているときにアクセス許可を定義する オブジェクトです。 は、プリンシパル (ユーザー、ルートユーザー、またはロールセッション) がリクエストを行うときに、これらのポリシー AWS を評価します。ポリシーでの権限により、リクエストが許可されるか拒否されるかが決まります。ほとんどのポリシーはJSONドキュメント AWS として に保存されます。JSON ポリシードキュメントの構造と内容の詳細については、IAM「 ユーザーガイド」のJSON「ポリシーの概要」を参照してください。

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

デフォルトでは、ユーザーやロールに権限はありません。必要なリソースに対してアクションを実行するアクセス許可をユーザーに付与するには、IAM管理者はIAMポリシーを作成できます。その後、管理者はIAMポリシーをロールに追加し、ユーザーはロールを引き受けることができます。

IAM ポリシーは、オペレーションの実行に使用する方法に関係なく、アクションのアクセス許可を定義します。例えば、iam:GetRoleアクションを許可するポリシーがあるとします。そのポリシーを持つユーザーは、 AWS Management Console、、 AWS CLIまたは AWS からロール情報を取得できますAPI。

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

ID ベースのポリシーは、IAMユーザー、ユーザーのグループ、ロールなどの ID にアタッチできるJSONアクセス許可ポリシードキュメントです。これらのポリシーは、ユーザーとロールが実行できるアクション、リソース、および条件をコントロールします。ID ベースのポリシーを作成する方法については、IAM「 ユーザーガイド」の「カスタマーマネージドポリシーによるカスタムIAMアクセス許可の定義」を参照してください。

アイデンティティベースのポリシーは、さらにインラインポリシーまたはマネージドポリシーに分類できます。インラインポリシーは、単一のユーザー、グループ、またはロールに直接埋め込まれています。マネージドポリシーは、 内の複数のユーザー、グループ、ロールにアタッチできるスタンドアロンポリシーです AWS アカウント。管理ポリシーには AWS 、管理ポリシーとカスタマー管理ポリシーが含まれます。管理ポリシーまたはインラインポリシーを選択する方法については、 IAM ユーザーガイドの「管理ポリシーとインラインポリシーの選択」を参照してください。

AWS CodeConnections アクセス許可リファレンス

次の表に、各 AWS CodeConnections APIオペレーション、アクセス許可を付与できる対応するアクション、アクセス許可を付与ARNするために使用するリソースの形式を示します。は、その AWS CodeConnections APIsで許可されるアクションの範囲に基づいてテーブルにグループ化されますAPI。IAM ID にアタッチできるアクセス許可ポリシー (アイデンティティベースのポリシー) を記述する場合は、これを参照してください。

アクセス許可ポリシーを作成するときに、ポリシーの Action フィールドでアクションを指定します。ポリシーの Resource フィールドのリソース値は、ワイルドカード文字 (*) の有無にかかわらずARN、 として指定します。

接続ポリシーで条件を示すには、ここで説明され、条件キー に一覧表示されている条件キーを使用します。 AWS全体の条件キーを使用することもできます。 AWS全体のキーの完全なリストについては、「 ユーザーガイド」の「使用可能なキー」を参照してください。 IAM

アクションを指定するには、codeconnectionsプレフィックスの後にAPIオペレーション名 (例: codeconnections:ListConnectionsまたは ) を使用しますcodeconnections:CreateConnection。

ワイルドカードの使用

複数のアクションまたはリソースを指定するには、 でワイルドカード文字 (*) を使用しますARN。例えば、 codeconnections:*はすべての AWS CodeConnections アクションを指定し、 という単語で始まるすべての AWS CodeConnections アクションcodeconnections:Get*を指定しますGet。次の例では、MyConnection で始まる名前のすべてのリソースへのアクセスを許可します。

arn:aws:codeconnections:us-west-2:account-ID:connection/*

ワイルドカードは、 でのみ使用できます。connection リソースを次の表に示します。ワイルドカードは では使用できません region または account-id リソースの使用料金を見積もることができます。ワイルドカードの詳細については、IAM「 ユーザーガイドIAM」の「識別子」を参照してください。

接続を管理するアクセス許可

AWS CLI または を使用して接続SDKを表示、作成、または削除するように指定されたロールまたはユーザーには、以下に制限されたアクセス許可が必要です。

codeconnections:CreateConnection
codeconnections:DeleteConnection
codeconnections:GetConnection
codeconnections:ListConnections

スクロールバーを使用して、テーブルの残りの部分を確認します。

これらのオペレーションでは、次の条件キーがサポートされます。

ホストを管理するためのアクセス許可

AWS CLI ホストを表示、作成、または削除SDKするために または を使用するように指定されたロールまたはユーザーには、以下に限定されるアクセス許可が必要です。

codeconnections:CreateHost
codeconnections:DeleteHost
codeconnections:GetHost
codeconnections:ListHosts

スクロールバーを使用して、テーブルの残りの部分を確認します。

これらのオペレーションでは、次の条件キーがサポートされます。

接続を完了するためのアクセス許可

コンソールで接続を管理するように指定されたロールまたはユーザーは、コンソールで接続を完了し、インストールを作成するために必要なアクセス許可を持っている必要があります。これには、プロバイダーへのハンドシェイクの許可と、使用する接続用のインストールの作成が含まれます。上記のアクセス許可に加えて、次のアクセス許可を使用します。

以下のIAMオペレーションは、ブラウザベースのハンドシェイクを実行するときにコンソールで使用されます。ListInstallationTargets、GetInstallationUrl、StartOAuthHandshake、 UpdateConnectionInstallationはIAMポリシーアクセス許可GetIndividualAccessTokenです。これらはAPIアクションではありません。

codeconnections:GetIndividualAccessToken
codeconnections:GetInstallationUrl
codeconnections:ListInstallationTargets
codeconnections:StartOAuthHandshake
codeconnections:UpdateConnectionInstallation

これに基づいて、コンソールで接続を使用、作成、更新、または削除するには、次のアクセス許可が必要です。

codeconnections:CreateConnection
codeconnections:DeleteConnection
codeconnections:GetConnection
codeconnections:ListConnections
codeconnections:UseConnection
codeconnections:ListInstallationTargets
codeconnections:GetInstallationUrl
codeconnections:StartOAuthHandshake
codeconnections:UpdateConnectionInstallation
codeconnections:GetIndividualAccessToken

スクロールバーを使用して、テーブルの残りの部分を確認します。

これらのオペレーションでは、次の条件キーがサポートされます。

ホスト設定のアクセス許可

コンソールで接続を管理するように指定されたロールまたはユーザーは、コンソールでホストをセットアップするために必要なアクセス許可が必要です。これには、プロバイダーへのハンドシェイクの許可とホストアプリのインストールが含まれます。上記のホストのアクセス許可に加えて、次のアクセス許可を使用します。

以下のIAMオペレーションは、ブラウザベースのホスト登録を実行するときにコンソールで使用されます。 RegisterAppCode および StartAppRegistrationHandshakeはIAMポリシーアクセス許可です。これらはAPIアクションではありません。

codeconnections:RegisterAppCode
codeconnections:StartAppRegistrationHandshake

これに基づき、以下のアクセス許可を使用して、コンソールでホストを必要とする接続 (インストール済プロバイダータイプなど) を使用、作成、更新、または削除します。

codeconnections:CreateConnection
codeconnections:DeleteConnection
codeconnections:GetConnection
codeconnections:ListConnections
codeconnections:UseConnection
codeconnections:ListInstallationTargets
codeconnections:GetInstallationUrl
codeconnections:StartOAuthHandshake
codeconnections:UpdateConnectionInstallation
codeconnections:GetIndividualAccessToken
codeconnections:RegisterAppCode
codeconnections:StartAppRegistrationHandshake

スクロールバーを使用して、テーブルの残りの部分を確認します。

これらのオペレーションでは、次の条件キーがサポートされます。

サービスに接続を渡す

接続がサービスに渡ARNされる場合 (パイプライン定義で接続を提供してパイプラインを作成または更新する場合など）、ユーザーは アクセスcodeconnections:PassConnection許可を持っている必要があります。

スクロールバーを使用して、テーブルの残りの部分を確認します。

このオペレーションでは、次の条件キーもサポートされます。

接続の使用

のようなサービスが接続 CodePipeline を使用する場合、サービスロールには特定の接続に対するcodeconnections:UseConnectionアクセス許可が必要です。

コンソールで接続を管理するには、ユーザーポリシーに codeconnections:UseConnection アクセス許可が必要です。

スクロールバーを使用して、テーブルの残りの部分を確認します。

このオペレーションでは、次の条件キーもサポートされます。

一部の機能に必要な条件キーは、時間の経過とともに変化する可能性があります。アクセスコントロールの要件で、異なるアクセス許可が必要でない限り、codeconnections:UseConnection を使用して接続へのアクセスを制御することをお勧めします。

ProviderAction でサポートされるアクセスタイプ

接続が AWS サービスによって使用されると、ソースコードプロバイダーにAPI呼び出しが行われます。例えば、 サービスを呼び出すことで、Bitbucket https://api.bitbucket.org/2.0/repositories/username 接続のリポジトリを一覧表示できますAPI。

ProviderAction 条件キーを使用すると、プロバイダーAPIsのどの を呼び出すことができるかを制限できます。API パスは動的に生成され、パスはプロバイダーによって異なるため、ProviderAction値は URLの ではなく抽象アクション名にマッピングされますAPI。これにより、接続のプロバイダーの種類に関係なく、同じ効果を持つポリシーを書くことができます。

サポートされている各 ProviderAction 値に対して許可されるアクセスタイプは次のとおりです。以下は、IAMポリシーのアクセス許可です。これらはAPIアクションではありません。

スクロールバーを使用して、テーブルの残りの部分を確認します。

接続リソースにタグ付けするためにサポートされているアクセス許可

接続リソースにタグ付けするときは、次のIAM操作を使用します。

codeconnections:ListTagsForResource
codeconnections:TagResource
codeconnections:UntagResource

スクロールバーを使用して、テーブルの残りの部分を確認します。

リポジトリリンクに接続を渡す

リポジトリリンクが同期設定で提供される場合、ユーザーはリポジトリリンクARN/リソースのcodeconnections:PassRepositoryアクセス許可を持っている必要があります。

スクロールバーを使用して、テーブルの残りの部分を確認します。

このオペレーションでは、次の条件キーもサポートされます。

リポジトリリンクでサポートされる条件キー

リポジトリリンクと同期設定リソースの操作は、以下の条件キーでサポートされています。

コンソールでの通知と接続の使用

通知エクスペリエンスは CodeBuild、、 CodeCommit CodeDeploy、および CodePipeline コンソール、および 設定ナビゲーションバー自体のデベロッパーツールコンソールに組み込まれています。コンソールで通知にアクセスするには、それらのサービスにいずれかの管理ポリシーを適用するか、最小限のアクセス許可のセットが必要です。これらのアクセス許可により、 AWS アカウントの AWS CodeStar 通知と AWS CodeConnections リソースの詳細を一覧表示および表示できます。最低限必要なアクセス許可よりも制限の厳しいアイデンティティベースのポリシーを作成すると、そのポリシーを持つエンティティ (IAMユーザーまたはロール) に対してコンソールは意図したとおりに機能しません。これらのコンソールへのアクセス AWS CodePipelineを含む AWS CodeBuild、、 AWS CodeCommit AWS CodeDeploy、および へのアクセスの許可の詳細については、以下のトピックを参照してください。

AWS CodeStar 通知には AWS 管理ポリシーがありません。通知機能へのアクセスを提供するには、上記のいずれかのサービスに対する管理ポリシーの 1 つを適用するか、ユーザーまたはエンティティに付与するアクセス許可のレベルでポリシーを作成してから、これらのアクセス許可が必要なユーザー、グループ、またはロールにそれらのポリシーをアタッチする必要があります。詳細については、次の例を参照してください。

AWS CodeConnections には AWS 管理ポリシーがありません。接続を完了するためのアクセス許可 で詳しく説明している許可など、アクセスの許可や許可の組み合わせを使用します。

詳細については、次を参照してください。

AWS CLI または のみを呼び出すユーザーにコンソールアクセス許可を付与する必要はありません AWS API。代わりに、実行しようとしているAPIオペレーションに一致するアクションのみへのアクセスを許可します。

自分の権限の表示をユーザーに許可する

この例では、IAMユーザーがユーザー ID にアタッチされているインラインポリシーとマネージドポリシーを表示できるようにするポリシーを作成する方法を示します。このポリシーには、コンソールで、または AWS CLI または を使用してプログラムでこのアクションを実行するアクセス許可が含まれています AWS API。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "ViewOwnUserInfo",
            "Effect": "Allow",
            "Action": [
                "iam:GetUserPolicy",
                "iam:ListGroupsForUser",
                "iam:ListAttachedUserPolicies",
                "iam:ListUserPolicies",
                "iam:GetUser"
            ],
            "Resource": ["arn:aws:iam::*:user/${aws:username}"]
        },
        {
            "Sid": "NavigateInConsole",
            "Effect": "Allow",
            "Action": [
                "iam:GetGroupPolicy",
                "iam:GetPolicyVersion",
                "iam:GetPolicy",
                "iam:ListAttachedGroupPolicies",
                "iam:ListGroupPolicies",
                "iam:ListPolicyVersions",
                "iam:ListPolicies",
                "iam:ListUsers"
            ],
            "Resource": "*"
        }
    ]
}