カスタマー管理の KMS キーを使用して AgentCore ポリシーエンジンを暗号化する

AgentCore のポリシーは、デフォルトで暗号化を提供し、 AWS 所有の暗号化キーを使用して保管中の顧客の機密データを保護します。追加の保護レイヤーとして、AgentCore の Policy を使用すると、 AWS Key Management Service (AWS KMS) カスタマーマネージドキー (CMK) を使用してポリシーエンジンを暗号化できます。この機能により、保管時の暗号化による機密データの保護が保証され、以下に役立ちます。

以下のセクションでは、新しいポリシーエンジンの暗号化を設定し、暗号化キーを管理する方法について説明します。

AWS AgentCore の Policy の KMS キータイプ

AgentCore のポリシーは AWS KMS と統合され、顧客データの暗号化と復号に使用される暗号化キーを管理します。キーのタイプと状態の詳細については、KMS デベロッパーガイドのAWS 「 Key Management Service の概念」を参照してください。 AWS 新しいポリシーエンジンを作成するときに、次の AWS KMS キータイプから選択してデータを暗号化できます。

AWS 所有キー

デフォルトの暗号化タイプ。AgentCore のポリシーは、追加料金なしでキーを所有し、作成時に保管中のリソースデータを暗号化します。AgentCore の Policy が所有するキーを使用してデータを暗号化または復号するために、コードまたはアプリケーションに追加の設定は必要ありません。これらのキーを表示、管理、使用、または監査する必要はありません。詳細については、KMS デベロッパーガイド AWS の「 AWS 所有キー」を参照してください。

カスタマーマネージドキー

AWS アカウントでキーを作成、所有、管理します。KMS キーを完全に制御できます。カスタマーマネージドキーには AWS KMS 料金が適用されます。詳細については、AWS 「KMS 料金表」ページを参照してください。キータイプの詳細については、KMS デベロッパーガイド AWS の「カスタマーマネージドキー」を参照してください。

ポリシーエンジンの暗号化にカスタマーマネージドキーを指定すると、AgentCore のポリシーはそのキーを使用してポリシーエンジンとそのすべての子リソース (ポリシー、ポリシー生成) を暗号化します。カスタマーマネージドキーを使用してポリシーエンジンを暗号化するには、キーポリシーで AgentCore のポリシーへのアクセスを許可する必要があります。キーポリシーは、カスタマーマネージドキーにアタッチしてアクセスを制御するリソースベースのポリシーです。詳細については、AgentCore のポリシーの AWS KMS キーの使用を許可する」を参照してください。

さらに、カスタマーマネージドキーを使用して暗号化されたポリシーエンジンを作成したり、カスタマーマネージドキーで暗号化されたポリシーエンジンに API コールを行ったりするには、コールを行う IAM ユーザーまたはロールもキーにアクセスできる必要があります。AgentCore のポリシーがキーにアクセスできない場合、そのキーによって暗号化されたリソースを含む承認の決定は拒否されます。キーにアクセスできない場合、そのキーによって暗号化されたリソースの読み取り、更新、削除はできず、暗号化にキーを使用するための作成呼び出しは失敗します。

AgentCore AWS の Policy で KMS とデータキーを使用する

保管時の AgentCore 暗号化のポリシー機能は、KMS キーとデータキーの階層を使用してリソースデータを保護します。

AgentCore のポリシーは、付与ベースのモデルを使用してカスタマーマネージドキーにアクセスします。カスタマーマネージドキーを使用してポリシーエンジンを作成すると、AgentCore のポリシーは次のステップを実行します。

2 つの権限はさまざまな目的を果たします。

どちらの許可も、キー aws:bedrock-agentcore-policy:policy-engine-arn を使用した暗号化コンテキストによって制約されます。これにより、許可は特定のポリシーエンジンリソースにバインドされます。

カスタマーマネージドキーを使用してポリシーエンジンを削除すると、AgentCore のポリシーは両方の許可を自動的に廃止します。

AgentCore のポリシーに AWS KMS キーの使用を許可する

AgentCore の Policy でカスタマーマネージドキーを使用するには、KMS AWS キーポリシーが AWS アカウントに許可を付与する必要があります。ポリシーエンジンを作成する場合、AgentCore のポリシーは、転送アクセスセッション (FAS) を介して ID kms:CreateGrantを使用して を呼び出します。その結果、キーポリシーは (サービスプリンシパルではなく) アカウントプリンシパルに kms:CreateGrantおよびその他の必要なアクセス許可を付与する必要があり、 kms:ViaService条件を使用して、キーが AgentCore のポリシーを介してのみ使用されるようにします。

少なくとも、AgentCore のポリシーでは、カスタマーマネージドキーに対して次のアクセス許可が必要です。

ソースコンテキストについて

ソースコンテキストは、特定のキーに対して KMS AWS アクションを実行しようとするソース発信者に関する情報を提供します。これにより、コンテキストをデータのソースにバインドすることで、暗号化されたデータの混乱や誤用を防ぐことができます。

AgentCore のポリシーがユーザーに代わって許可を通じて AWS KMS オペレーションを実行すると、ソースコンテキストはリクエストを開始した AgentCore リソースのポリシーを識別します。ソースコンテキストをキーポリシーのグラントベースのオペレーションの追加条件として使用して、キーの使用を特定のアカウントまたはリソースから送信されるリクエストに制限できます。

たとえば、キーポリシーの KMS オペレーションと検証ステートメントに aws:SourceAccount および aws:SourceArn条件を追加して、リクエストがアカウントから発信され、ポリシーエンジンリソースに対してのみこれらのオペレーションが成功するようにできます。

{
  "Sid": "Allow Policy for KMS operations with source context",
  "Effect": "Allow",
  "Principal": {
    "AWS": "arn:aws:iam::111122223333:root"
  },
  "Action": [
    "kms:Decrypt",
    "kms:GenerateDataKey"
  ],
  "Resource": "*",
  "Condition": {
    "StringEquals": {
      "kms:ViaService": "bedrock-agentcore.us-east-1.amazonaws.com",
      "aws:SourceAccount": "111122223333"
    },
    "StringLike": {
      "aws:SourceArn": "arn:aws:bedrock-agentcore:us-east-1:111122223333:policy-engine/*",
      "kms:EncryptionContext:aws:bedrock-agentcore-policy:policy-engine-arn": "arn:aws*:bedrock-agentcore:*:*:policy-engine/*"
    }
  }
}

このキーポリシーは、ソースアカウントがこの AWS KMS キーが存在するアカウントと同じ場合、AgentCoreのポリシーがユーザーに代わって許可を通じて KMS 呼び出しを行うことを許可します。これらの値は、KMS キーの CloudTrail 監査ログを確認するときに検証可能である必要があります。グローバル AWS 条件キーの詳細については、KMS デベロッパーガイドの「aws:SourceArn または aws:SourceAccount 条件キーの使用」を参照してください。 AWS

kms:ViaService について

kms:ViaService 条件キーは、指定された AWS サービスからのリクエストに KMS キーの使用を制限します。この条件キーは、転送アクセスセッション (FAS) に適用されます。の詳細についてはkms:ViaService、KMS デベロッパーガイドのkms:ViaService AWS 」を参照してください。

キーポリシーでは、kms:ViaService値は bedrock-agentcore.REGION.amazonaws.com の形式に従います。REGION はポリシーエンジンが作成された AWS リージョンです (例: bedrock-agentcore.us-east-1.amazonaws.com )。

暗号化コンテキストについて

暗号化コンテキストは、暗号化整合性チェックのための追加の認証済みデータを含むキーと値のペアのセットです。データを暗号化するリクエストに暗号化コンテキストを含めると、 AWS KMS は暗号化コンテキストを暗号化されたデータに暗号化的にバインドします。データを復号するには、同じ暗号化コンテキストを渡す必要があります。詳細については、KMS デベロッパーガイド AWS の「暗号化コンテキスト」を参照してください。

AgentCore のポリシーは、すべての AWS KMS 暗号化オペレーションで次の暗号化コンテキストを使用し、AgentCore のポリシーが暗号化および復号プロセスのためにユーザーに代わって AWS KMS 呼び出しを行うときに CloudTrail ログ内で検証できます。

{
  "aws:bedrock-agentcore-policy:policy-engine-arn": "arn:aws:bedrock-agentcore:REGION:ACCOUNT_ID:policy-engine/POLICY_ENGINE_ID"
}

この暗号化コンテキストをキーポリシー条件で使用して、キーを使用できるポリシーエンジンを制限できます。たとえば、次のセクションのキーポリシーは、 kms:EncryptionContext条件を使用して、キーをポリシーエンジンリソースにのみ使用できるようにします。

KMS AWS キーポリシーを完了する

前のセクションの概念に基づいて、次のキーポリシーの例では、ポリシーエンジンを暗号化し、暗号化されたポリシーエンジンを使用するために必要なアクセス許可を提供します。このポリシーには、セキュリティのベストプラクティスに準拠するための条件キーが含まれています。

{
"Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "Allow Policy to create grants",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::111122223333:role/ExampleRole"
      },
      "Action": "kms:CreateGrant",
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "kms:ViaService": "bedrock-agentcore.us-east-1.amazonaws.com",
          "kms:GrantConstraintType": "EncryptionContextSubset"
        },
        "StringLike": {
          "kms:EncryptionContext:aws:bedrock-agentcore-policy:policy-engine-arn": "arn:aws*:bedrock-agentcore:*:*:policy-engine/*"
        },
        "ForAllValues:StringEquals": {
          "kms:GrantOperations": [
            "Encrypt",
            "Decrypt",
            "GenerateDataKey",
            "GenerateDataKeyWithoutPlaintext",
            "ReEncryptFrom",
            "ReEncryptTo"
          ]
        }
      }
    },
    {
      "Sid": "Allow Policy for KMS operations",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::111122223333:role/ExampleRole"
      },
      "Action": [
        "kms:Decrypt",
        "kms:GenerateDataKey"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "kms:ViaService": "bedrock-agentcore.us-east-1.amazonaws.com"
        },
        "StringLike": {
          "kms:EncryptionContext:aws:bedrock-agentcore-policy:policy-engine-arn": "arn:aws*:bedrock-agentcore:*:*:policy-engine/*"
        }
      }
    },
    {
      "Sid": "Allow Policy for KMS validation",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::111122223333:role/ExampleRole"
      },
      "Action": "kms:DescribeKey",
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "kms:ViaService": "bedrock-agentcore.us-east-1.amazonaws.com"
        }
      }
    }
  ]
}

ポリシーには、次のステートメントが含まれています。

ポリシーエンジンを暗号化するための前提条件

ポリシーエンジンを暗号化する前に、次の前提条件を満たしていることを確認してください。

KMS キーの IAM アクセス許可の制御の詳細については、KMS デベロッパーガイドの「KMS キーのアクセスとアクセス許可」を参照してください。 AWS

暗号化されたポリシーエンジンの作成

暗号化されたポリシーエンジンを作成する前に、使用しているカスタマーマネージドキーに、暗号化と復号にキーを使用するように AgentCore のポリシーに適切なキーポリシーステートメントが設定されていることを確認してください。必要なアクセス許可については、AgentCore のポリシーの AWS KMS キーの使用を許可する」を参照してください。

AWS CLI を使用してポリシーエンジンを暗号化するには、create-policy-engineリクエストの送信時に --encryption-key-arnパラメータを含めます。

aws bedrock-agentcore-control create-policy-engine \
  --name "MyPolicyEngine" \
  --description "Policy engine with customer-managed encryption" \
  --encryption-key-arn "arn:aws:kms:us-east-1:123456789012:key/1234abcd-12ab-34cd-56ef-1234567890ab"

レスポンスには、ポリシーエンジンの ARN とステータスが含まれます。

{
  "policyEngineId": "MyPolicyEngine-abc123",
  "name": "MyPolicyEngine",
  "description": "Policy engine with customer-managed encryption",
  "policyEngineArn": "arn:aws:bedrock-agentcore:us-east-1:123456789012:policy-engine/MyPolicyEngine-abc123",
  "status": "CREATING",
  "statusReasons": [],
  "encryptionKeyArn": "arn:aws:kms:us-east-1:123456789012:key/1234abcd-12ab-34cd-56ef-1234567890ab",
  "createdAt": "2026-02-24T12:00:00Z",
  "updatedAt": "2026-02-24T12:00:00Z"
}

制限事項

ポリシーエンジンのカスタマーマネージドキー暗号化には、次の制限が適用されます。

トラブルシューティング

このセクションでは、AgentCore で ポリシーを使用する際に発生する可能性がある一般的なカスタマーマネージドキー関連のエラーと、それらを解決するためのトラブルシューティング手順について説明します。

アクセス拒否: AWS KMS アクセス許可の問題

エラー: "指定された KMS キーのアクセスが拒否されました。キーポリシーが必要なアクセス許可を付与していることを確認します。」

これは、発信者が IAM ポリシーまたは KMS キーポリシーに必要な kms:* AWS アクションのアクセス許可を持っていないか、参照されているキーが存在しないか、存在しなくなったことを意味します。

この問題を解決するには:

検証例外: AWS KMS キー設定

エラー: 「指定された KMS キーは使用可能な状態ではありません。キーが有効で、削除が保留中でないことを確認します。」

つまり、参照されているキーは、現在の設定のため、カスタマーマネージドキーの暗号化には使用できません。考えられる理由は以下のとおりです。

この問題を解決するには: キーがポリシーエンジンを暗号化するための前提条件で説明されている前提条件を満たしていることを確認します。