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

デフォルトでは、ユーザーにはリソースを作成または変更 CodeDeployするアクセス許可はありません。また、、 AWS Management Console AWS CLI、または AWS API を使用してタスクを実行することはできません。必要な指定されたリソースに対して API オペレーションを実行するためのアクセス許可を IAM ロールに付与する IAM ポリシーを作成する必要があります。続いて、それらのアクセス許可が必要なユーザーまたはグループにその IAM ロールをアタッチします。

これらの JSON ポリシードキュメント例を使用して IAM のアイデンティティベースのポリシーを作成する方法については、『IAM ユーザーガイド』の「JSON タブでのポリシーの作成」を参照してください。

では CodeDeploy、アイデンティティベースのポリシーを使用して、デプロイプロセスに関連するさまざまなリソースへのアクセス許可を管理します。次のリソースタイプへのアクセスをコントロールできます。

• アプリケーションおよびアプリケーションリビジョン。

• デプロイ。

• デプロイ設定。

• インスタンスとオンプレミスインスタンス。

リソースポリシーによって制御される機能は、次の表にあるように、リソースタイプによって異なります。

リソースタイプ	機能
すべて	リソースの詳細の閲覧および一覧表示
アプリケーション デプロイ設定 デプロイグループ	リソースの作成 リソースの削除
デプロイ	デプロイの作成 デプロイの停止
アプリケーションリビジョン	アプリケーションリビジョンの登録
アプリケーション デプロイグループ	更新されたリソース
オンプレミスインスタンス	インスタンスにタグを追加する インスタンスからタグを削除する インスタンスを登録する インスタンスを登録解除する

次の例では、us-west-2 リージョンの WordPress_App という名前のアプリケーションに関連付けられている WordPress_DepGroup という名前のデプロイグループを削除することをユーザーに許可するアクセス許可ポリシーを示しています。

{
  "Version": "2012-10-17",
  "Statement" : [
    {
      "Effect" : "Allow",
      "Action" : [
        "codedeploy:DeleteDeploymentGroup"
      ],
      "Resource" : [
        "arn:aws:codedeploy:us-west-2:444455556666:deploymentgroup:WordPress_App/WordPress_DepGroup"
      ]
    }
  ]
}

カスタマーマネージドポリシーの例

このセクションでは、さまざまな CodeDeploy アクションのアクセス許可を付与するポリシーの例を示します。これらのポリシーは、 CodeDeploy API、 AWS SDKsを使用している場合に機能します AWS CLI。コンソールで実行するアクションには、追加のアクセス許可を付与する必要があります。コンソールアクセス許可の付与の詳細については、「 CodeDeploy コンソールを使用する」を参照してください。

注記

例はすべて、米国西部 (オレゴン) リージョン (us-west-2) を使用し、架空のアカウント ID を使用しています。

例

• 例 1: 1 つのリージョンで CodeDeploy オペレーションを実行するアクセス許可を付与する

• 例 2: 単一のアプリケーションへのリビジョンの登録を許可する

• 例 3: 単一のデプロイグループへのデプロイの作成を許可する

例 1: 1 つのリージョンで CodeDeploy オペレーションを実行するアクセス許可を付与する

次の例では、 us-west-2リージョンでのみ CodeDeploy オペレーションを実行するアクセス許可を付与します。

{
  "Version": "2012-10-17",
  "Statement" : [
    {
      "Effect" : "Allow",
      "Action" : [
        "codedeploy:*"
      ],
      "Resource" : [
        "arn:aws:codedeploy:us-west-2:444455556666:*"
      ]
    }
  ]
}

例 2: 単一のアプリケーションへのリビジョンの登録を許可する

次の例では、us-west-2 リージョンの Test で始まるすべてのアプリケーションのアプリケーションリビジョンを登録するアクセス許可を付与します。

{
  "Version": "2012-10-17",
  "Statement" : [
    {
      "Effect" : "Allow",
      "Action" : [
        "codedeploy:RegisterApplicationRevision"
      ],
      "Resource" : [
        "arn:aws:codedeploy:us-west-2:444455556666:application:Test*"
      ]
    }
  ]
}

例 3: 単一のデプロイグループへのデプロイの作成を許可する

次の例では、WordPress_App という名前のアプリケーションに関連付けられた WordPress_DepGroup という名前のデプロイグループ用、ThreeQuartersHealthy という名前のカスタムデプロイ構成用、および WordPress_App という名前のアプリケーションに関連付けられたあらゆるアプリケーションリビジョン用のデプロイを作成することを許可します。これらのリソースはすべて us-west-2 リージョンにあります。

{
  "Version": "2012-10-17",
  "Statement" : [
    {
      "Effect" : "Allow",
      "Action" : [
        "codedeploy:CreateDeployment"
      ],
      "Resource" : [
        "arn:aws:codedeploy:us-west-2:444455556666:deploymentgroup:WordPress_App/WordPress_DepGroup"
      ]
    },
    {
      "Effect" : "Allow",
      "Action" : [
        "codedeploy:GetDeploymentConfig"
      ],
      "Resource" : [
        "arn:aws:codedeploy:us-west-2:444455556666:deploymentconfig:ThreeQuartersHealthy"
      ]
    },
    {
      "Effect" : "Allow",
      "Action" : [
        "codedeploy:GetApplicationRevision"
      ],
      "Resource" : [
        "arn:aws:codedeploy:us-west-2:444455556666:application:WordPress_App"
      ]
    }
  ]
}

ポリシーのベストプラクティス

ID ベースのポリシーは、ユーザーのアカウントで誰かが CodeDeploy リソースを作成、アクセス、または削除できるどうかを決定します。これらのアクションを実行すると、 AWS アカウントに料金が発生する可能性があります。アイデンティティベースポリシーを作成したり編集したりする際には、以下のガイドラインと推奨事項に従ってください:

• AWS 管理ポリシーを開始し、最小特権のアクセス許可に移行する – ユーザーとワークロードにアクセス許可を付与するには、多くの一般的なユースケースにアクセス許可を付与する AWS 管理ポリシーを使用します。これらは で使用できます AWS アカウント。ユースケースに固有の AWS カスタマー管理ポリシーを定義して、アクセス許可をさらに減らすことをお勧めします。詳細については、「IAM ユーザーガイド」の「AWS マネージドポリシー」または「ジョブ機能のAWS マネージドポリシー」を参照してください。

• 最小特権を適用する – IAM ポリシーで許可を設定する場合は、タスクの実行に必要な許可のみを付与します。これを行うには、特定の条件下で特定のリソースに対して実行できるアクションを定義します。これは、最小特権アクセス許可とも呼ばれています。IAM を使用して許可を適用する方法の詳細については、IAM ユーザーガイドのIAM でのポリシーとアクセス許可を参照してください。

• IAM ポリシーで条件を使用してアクセスをさらに制限する - ポリシーに条件を追加して、アクションやリソースへのアクセスを制限できます。例えば、ポリシー条件を記述して、すべてのリクエストを SSL を使用して送信するように指定できます。条件を使用して、 などの特定の を介してサービスアクションが使用される場合に AWS のサービス、サービスアクションへのアクセスを許可することもできます AWS CloudFormation。詳細については、「IAM ユーザーガイド」の [IAM JSON policy elements: Condition] (IAM JSON ポリシー要素:条件) を参照してください。

• IAM Access Analyzer を使用して IAM ポリシーを検証し、安全で機能的な権限を確保する - IAM Access Analyzer は、新規および既存のポリシーを検証して、ポリシーが IAM ポリシー言語 (JSON) および IAM のベストプラクティスに準拠するようにします。IAM アクセスアナライザーは 100 を超えるポリシーチェックと実用的な推奨事項を提供し、安全で機能的なポリシーの作成をサポートします。詳細については、IAM ユーザーガイドのIAM Access Analyzer ポリシーの検証を参照してください。

• 多要素認証 (MFA) を要求する – で IAM ユーザーまたはルートユーザーを必要とするシナリオがある場合は AWS アカウント、セキュリティを強化するために MFA を有効にします。API オペレーションが呼び出されるときに MFA を必須にするには、ポリシーに MFA 条件を追加します。詳細については、IAM ユーザーガイドのMFA 保護 API アクセスの設定を参照してください。

IAM でのベストプラクティスの詳細については、IAM ユーザーガイドのIAM でのセキュリティのベストプラクティスを参照してください。

CodeDeploy コンソールを使用する

CodeDeploy コンソールを使用する場合は、 AWS アカウントの他の AWS リソースを記述できる最小限のアクセス許可のセットが必要です。 CodeDeploy コンソール CodeDeploy で を使用するには、次のサービスからのアクセス許可が必要です。

• Amazon EC2 Auto Scaling

• AWS CodeDeploy

• Amazon Elastic Compute Cloud

• Elastic Load Balancing

• AWS Identity and Access Management

• Amazon Simple Storage Service

• Amazon Simple Notification Service

• Amazon CloudWatch

これらの最小限必要なアクセス許可よりも制限された IAM ポリシーを作成している場合、その IAM ポリシーを使用するユーザーに対してコンソールは意図したとおりには機能しません。これらのユーザーが引き続きコンソール CodeDeployを使用できるようにするには、「」で説明されているように、ユーザーに割り当てられたロールに AWSCodeDeployReadOnlyAccess管理ポリシーもアタッチしますAWS の マネージド (事前定義) ポリシー CodeDeploy。

AWS CLI または CodeDeploy API のみを呼び出すユーザーには、最小限のコンソールアクセス許可を付与する必要はありません。

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

この例では、ユーザーアイデンティティにアタッチされたインラインおよびマネージドポリシーの表示を IAM ユーザーに許可するポリシーの作成方法を示します。このポリシーには、コンソールで、または 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": "*"
        }
    ]
}