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

AWS CodeStar Notifications and AWS CodeConnections の ID とアクセスの管理

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

対象者

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

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

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

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

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

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

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

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

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

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

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

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

IAM ユーザーとグループ

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

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

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

IAM ロール

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ワイルドカードの使用

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

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

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

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

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

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

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

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

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

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

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 コールが発信されます。例えば、サービスは API https://api.bitbucket.org/2.0/repositories/username を呼び出すことで Bitbucket 接続のリポジトリを一覧表示する場合があります。

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

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

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

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

次の IAM オペレーションは、接続リソースにタグ付けするときに使用されます。

codeconnections:ListTagsForResource
codeconnections:TagResource
codeconnections:UntagResource

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

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

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

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

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

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

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

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

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

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

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

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

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

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

この例では、IAM ユーザーがユーザー ID にアタッチされているインラインポリシーとマネージドポリシーを表示できるようにするポリシーを作成する方法を示します。このポリシーには、コンソールで、または AWS CLI or 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": "*"
        }
    ]
}