AgentCore 評価の保管時の暗号化

暗号化オプション

Amazon Bedrock AgentCore Evaluations は、デフォルトでは AWS 所有キーを使用して保管中のすべてのデータを追加料金なしで暗号化します。このキーの使用を表示、管理、または監査することはできません。

オプションで、カスタマーマネージドキーを使用して機密評価者データを暗号化できます。カスタム評価者でカスタマーマネージド KMS AWS キーを指定すると、サービスは AWS Encryption SDK によるエンベロープ暗号化を使用して評価者の指示と評価スケールを暗号化します。その他のすべての評価者メタデータ (名前、レベル、モデル設定、ステータス) は、 AWS 所有キーで暗号化されたままになります。

カスタマーマネージドキーを使用すると、次の機能を含め、暗号化プロセスをより詳細に制御できます。

詳細については、「 Key Management Service デベロッパーガイド」の「カスタマーマネージド AWS キー」を参照してください。

AgentCore Evaluations がカスタマーマネージド KMS キーを使用する方法

カスタム評価者でカスタマーマネージドキーを指定すると、サービスは発信者の認証情報 (フォワードアクセスセッション経由) を使用して、評価者の指示と評価スケールを暗号化および復号します。呼び出し元にはkms:GenerateDataKey、キーに対する 、kms:Decrypt、および アクセスkms:DescribeKey許可が必要です。

オンライン評価の場合、サービスは独自のサービスプリンシパル () を使用して評価者の指示を非同期的に復号しますbedrock-agentcore.amazonaws.com。サービスプリンシパルには、キーポリシーで kms:Decrypt アクセス許可が必要です。

カスタマーマネージド KMS キーの設定

AgentCore Evaluations は、対称暗号化 KMS キーのみをサポートします。KMS キーは、評価者と同じ AWS リージョンに存在する必要があります。対称 KMS キーの作成については、「 Key Management Service AWS デベロッパーガイド」の「対称暗号化 KMS キーの作成」を参照してください。

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

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

{
"Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowCallerAccess",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::111122223333:role/MyEvaluationRole"
      },
      "Action": "kms:DescribeKey",
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "kms:ViaService": "bedrock-agentcore.us-east-1.amazonaws.com"
        }
      }
    },
    {
      "Sid": "AllowCallerCryptoOps",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::111122223333:role/MyEvaluationRole"
      },
      "Action": [
        "kms:GenerateDataKey",
        "kms:Decrypt"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "kms:ViaService": "bedrock-agentcore.us-east-1.amazonaws.com",
          "kms:EncryptionContext:aws:bedrock-agentcore:evaluatorArn": "arn:aws:bedrock-agentcore:us-east-1:111122223333:evaluator/my-evaluator-id"
        }
      }
    },
    {
      "Sid": "AllowServicePrincipalDecrypt",
      "Effect": "Allow",
      "Principal": {
        "Service": "bedrock-agentcore.amazonaws.com"
      },
      "Action": "kms:Decrypt",
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "111122223333",
          "aws:SourceArn": "arn:aws:bedrock-agentcore:us-east-1:111122223333:evaluator/my-evaluator-id"
        }
      }
    }
  ]
}

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

カスタマーマネージド KMS キーを使用した評価者の作成

カスタム評価者を暗号化するには、CreateEvaluator を呼び出すときに kmsKeyArnパラメータを指定します。

既存の評価者の暗号化設定を変更する

UpdateEvaluator を使用して、既存の評価者の暗号化設定を変更できます。

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

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

{
  "aws:bedrock-agentcore:evaluatorArn": "arn:aws:bedrock-agentcore:us-east-1:111122223333:evaluator/evaluator-id"
}

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

AgentCore Evaluations と KMS AWS のインタラクションのモニタリング

AWS CloudTrail を使用して、AgentCore評価がユーザーに代わって行う KMS API リクエストを追跡できます。ログには、次の CloudTrail イベント名が表示されます。

CloudTrail ログエントリの requestParameters.encryptionContextフィールドには、評価者の ARN aws:bedrock-agentcore:evaluatorArnとともに が含まれます。オンライン評価中にサービスプリンシパルによって行われたリクエストの場合、 userIdentity.invokedByフィールドには が表示されますbedrock-agentcore.amazonaws.com。

KMS 使用状況のモニタリングの詳細については、 AWS 「 Key Management Service デベロッパーガイドAWS 」の AWS CloudTrail を使用した KMS API コールのログ記録」を参照してください。

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

カスタマーマネージド KMS キーを無効化または削除した場合、またはキーポリシーが必要なアクセス許可を付与しなくなった場合:

アクセスを復元するには、キーを再度有効にするか、キーポリシーを更新して必要なアクセス許可を付与します。