AgentCore 평가에 대한 저장 데이터 암호화

암호화 옵션

Amazon Bedrock AgentCore Evaluations는 기본적으로 추가 비용 없이 AWS 소유 키를 사용하여 저장된 모든 데이터를 암호화합니다. 이 키의 사용을 보거나 관리하거나 감사할 수 없습니다.

고객 관리형 키를 사용하여 민감한 평가자 데이터를 암호화할 수도 있습니다. 사용자 지정 평가자에 고객 관리형 AWS KMS 키를 지정하면 서비스는 Encryption SDK를 사용한 봉투 암호화를 사용하여 평가자의 지침과 등급 조정을 AWS 암호화합니다. 다른 모든 평가자 메타데이터(이름, 레벨, 모델 구성, 상태)는 AWS 소유 키로 암호화된 상태로 유지됩니다.

고객 관리형 키를 사용하면 다음과 같은 기능을 포함하여 암호화 프로세스를 더 잘 제어할 수 있습니다.

자세한 내용은 Key Management Service 개발자 안내서의 고객 관리형 키를 참조하세요. AWS

AgentCore Evaluations가 고객 관리형 KMS 키를 사용하는 방법

사용자 지정 평가자에 고객 관리형 키를 지정하면 서비스는 호출자의 자격 증명(전달 액세스 세션을 통해)을 사용하여 평가자의 지침 및 등급 조정을 암호화하고 해독합니다. 호출자는 키에 대한 kms:GenerateDataKeykms:Decrypt, 및 kms:DescribeKey 권한이 있어야 합니다.

온라인 평가의 경우 서비스는 자체 서비스 보안 주체()를 사용하여 평가자 지침을 비동기적으로 복호화합니다bedrock-agentcore.amazonaws.com. 서비스 보안 주체는 키 정책에 kms:Decrypt 권한이 있어야 합니다.

고객 관리형 KMS 키 구성

AgentCore Evaluations는 대칭 암호화 KMS 키만 지원합니다. KMS 키는 평가자와 동일한 AWS 리전에 있어야 합니다. 대칭 KMS 키 생성에 대한 자세한 내용은 AWS Key Management Service 개발자 안내서의 대칭 암호화 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 평가에는 모든 KMS 작업에 다음과 같은 암호화 컨텍스트가 포함됩니다.

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

위의 예제 키 정책의 AllowCallerCryptoOps 문과 같이 키 정책 조건에서이 암호화 컨텍스트를 사용하여 KMS 작업을 특정 평가자로 제한할 수 있습니다. 는 암호화 컨텍스트가 아닌 범위 지정aws:SourceArn에를 AllowServicePrincipalDecrypt 사용합니다.

AWS KMS와의 AgentCore 평가 상호 작용 모니터링

AWS CloudTrail을 사용하여 AgentCore Evaluations가 사용자를 대신하여 수행하는 KMS API 요청을 추적할 수 있습니다. 로그에 다음과 같은 CloudTrail 이벤트 이름이 나타납니다.

CloudTrail 로그 항목에서 requestParameters.encryptionContext 필드에는가 평가자의 ARN과 aws:bedrock-agentcore:evaluatorArn 함께 포함되어 있습니다. 온라인 평가 중에 서비스 보안 주체가 수행한 요청의 경우 userIdentity.invokedBy 필드에가 표시됩니다bedrock-agentcore.amazonaws.com.

KMS 사용량 모니터링에 대한 자세한 내용은 AWS Key Management Service 개발자 안내서의 AWS CloudTrail을 사용하여 AWS KMS API 호출 로깅을 참조하세요.

키를 사용할 수 없게 될 때의 동작

고객 관리형 KMS 키를 비활성화하거나 삭제하거나 키 정책이 더 이상 필요한 권한을 부여하지 않는 경우:

액세스를 복원하려면 키를 다시 활성화하거나 키 정책을 업데이트하여 필요한 권한을 부여합니다.