レコメンデーションの暗号化

レコメンデーションkmsKeyArnで を指定すると、サービスは AWS Encryption SDK によるエンベロープ暗号化を使用してレコメンデーション設定とレコメンデーション結果を暗号化します。他のすべてのレコメンデーションメタデータ (名前、タイプ、ステータス) は、 AWS 所有キーで暗号化されたままです。

kmsKeyArn は、 を介して作成時に指定されますStartRecommendation。

仕組み

レコメンデーション暗号化は、エンベロープ暗号化に AWS Encryption SDK を使用します。サービスがレコメンデーションデータを書き込みまたは読み取ると、KMS を呼び出してデータキーを生成または復号します。レコメンデーション結果は、同じカスタマーマネージドキーを使用して SSE-KMS で S3 にも保存されます。

API 時に、サービスは、ドライランチェック (転送アクセスセッション) を使用して発信者に KMS アクセス許可があることを検証します。これにより、レコメンデーションワークフロー中に非同期的に失敗するのではなく、アクセス許可の問題がすぐに検出されます。

レコメンデーションワークフローが非同期で実行されると、サービスプリンシパル (bedrock-agentcore.amazonaws.com) は設定を復号し、結果を暗号化します。サービスプリンシパルは、キーポリシーに kms:GenerateDataKeyおよび アクセスkms:Decrypt許可を持っている必要があります。

AgentCore 最適化は、対称暗号化 KMS キーのみをサポートします。KMS キーは、レコメンデーションと同じ AWS リージョンに存在する必要があります。

カスタマーマネージド KMS キーを使用するためのアクセス許可の設定

次のキーポリシーは、レコメンデーションの暗号化に必要な最小限のアクセス許可を提供します。このポリシーには以下の 3 つのステートメントがあります。

{
"Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowCallerAccess",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::111122223333:role/MyRecommendationRole"
      },
      "Action": "kms:DescribeKey",
      "Resource": "*"
    },
    {
      "Sid": "AllowCallerCryptoOps",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::111122223333:role/MyRecommendationRole"
      },
      "Action": [
        "kms:GenerateDataKey",
        "kms:Decrypt"
      ],
      "Resource": "*",
      "Condition": {
        "StringLike": {
          "kms:EncryptionContext:aws:bedrock-agentcore:recommendationArn": "arn:aws:bedrock-agentcore:us-east-1:111122223333:recommendation/*"
        }
      }
    },
    {
      "Sid": "AllowServicePrincipalAccess",
      "Effect": "Allow",
      "Principal": {
        "Service": "bedrock-agentcore.amazonaws.com"
      },
      "Action": [
        "kms:GenerateDataKey",
        "kms:Decrypt"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "111122223333"
        },
        "ArnLike": {
          "aws:SourceArn": "arn:aws:bedrock-agentcore:us-east-1:111122223333:recommendation/*"
        }
      }
    }
  ]
}

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

カスタマーマネージド KMS キーへのアクセスのスコープダウン

暗号化コンテキストを使用して、カスタマーマネージドキーへのアクセスの範囲を絞り込むことができます。AgentCore 最適化には、すべての KMS オペレーションに次の暗号化コンテキストが含まれます。

{
  "aws:bedrock-agentcore:recommendationArn": "arn:aws:bedrock-agentcore:us-east-1:111122223333:recommendation/recommendation-id"
}

この暗号化コンテキストをキーポリシー条件で使用して、上記のキーポリシーの例の AllowCallerCryptoOpsステートメントに示すように、KMS オペレーションを特定のレコメンデーションに制限できます。は、暗号化コンテキストではなくスコープaws:SourceArn設定に AllowServicePrincipalAccessを使用することに注意してください。

カスタマーマネージド KMS キーを使用したレコメンデーションの開始

を呼び出すときに kmsKeyArnパラメータを指定しますStartRecommendation。

推奨事項の KMS 使用状況のモニタリング

レコメンデーション KMS オペレーションには、次の CloudTrail イベント名が表示されます。

キーが使用できなくなった場合の動作

レコメンデーションで使用されるカスタマーマネージド KMS キーを無効化または削除する場合: