建议加密

当您根据推荐指定时，该服务会使用带有加密 SDK 的信封加密来加密推荐配置和推荐结果。kmsKeyArn AWS 所有其他推荐元数据（名称、类型、状态）仍使用所 AWS 拥有的密钥进行加密。

kmsKeyArn是在创建时通过指定的StartRecommendation。

工作原理

建议加密使用加 AWS 密 SDK 进行信封加密。当服务写入或读取推荐数据时，它会调用 KMS 来生成或解密数据密钥。推荐结果也 SSE-KMS 使用相同的客户托管密钥存储在 S3 中。

在 API 时，该服务使用试运行检查（转发访问会话）来验证呼叫者是否具有 KMS 权限。这样可以立即发现权限问题，而不是在推荐工作流程中异步失败。

当推荐工作流程异步运行时，服务主体 (bedrock-agentcore.amazonaws.com) 会解密配置并对结果进行加密。服务主体必须拥有kms:GenerateDataKey密钥策略中的kms:Decrypt权限。

AgentCore 优化仅支持对称加密 KMS 密钥。KMS 密钥必须与建议位于同一 AWS 区域。

配置使用客户托管 KMS 密钥的权限

以下密钥策略提供了建议加密所需的最低权限。该策略包含三条语句：

{
"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"
}

您可以在密钥策略条件中使用此加密上下文将 KMS 操作限制在特定的建议范围内，如上面示例密钥策略中的AllowCallerCryptoOps声明所示。请注意，AllowServicePrincipalAccess它aws:SourceArn用于范围界定而不是加密上下文。

使用客户托管的 KMS 密钥开始推荐

调用时指定kmsKeyArn参数StartRecommendation：

监控 KMS 使用情况以获取建议

建议的 KMS 操作会出现以下 CloudTrail 事件名称：

密钥不可用时的行为

如果您禁用或删除建议使用的客户托管 KMS 密钥：