Verschlüsselung im Ruhezustand für AgentCore Evaluierungen

Verschlüsselungsoptionen

Amazon Bedrock AgentCore Evaluations verschlüsselt standardmäßig alle Daten im Ruhezustand mit einem AWS eigenen Schlüssel ohne zusätzliche Kosten. Sie können die Verwendung dieses Schlüssels nicht einsehen, verwalten oder überprüfen.

Optional können Sie sensible Evaluator-Daten mit einem vom Kunden verwalteten Schlüssel verschlüsseln. Wenn Sie einen vom Kunden verwalteten AWS KMS-Schlüssel in einem benutzerdefinierten Evaluator angeben, verschlüsselt der Service die Anweisungen und die Bewertungsskala des Evaluators mithilfe der Umschlagverschlüsselung mit dem Encryption SDK. AWS Alle anderen Evaluator-Metadaten (Name, Ebene, Modellkonfiguration, Status) bleiben mit dem eigenen Schlüssel verschlüsselt. AWS

Durch die Verwendung eines vom Kunden verwalteten Schlüssels haben Sie mehr Kontrolle über den Verschlüsselungsprozess und können unter anderem:

Weitere Informationen finden Sie unter Vom Kunden verwaltete Schlüssel im AWS Key Management Service Developer Guide.

Wie AgentCore Evaluations einen vom Kunden verwalteten KMS-Schlüssel verwendet

Wenn Sie einen vom Kunden verwalteten Schlüssel in einem benutzerdefinierten Evaluator angeben, verwendet der Service die Anmeldeinformationen des Anrufers (über Forward Access Sessions), um die Anweisungen und die Bewertungsskala des Evaluators zu verschlüsseln und zu entschlüsseln. Der Anrufer muss über Berechtigungenkms:GenerateDataKey, und für den Schlüssel kms:Decrypt verfügen. kms:DescribeKey

Bei der Online-Evaluierung entschlüsselt der Dienst die Anweisungen des Evaluators asynchron mit seinem eigenen Dienstprinzipal (). bedrock-agentcore.amazonaws.com Der Dienstprinzipal muss in der Schlüsselrichtlinie über die kms:Decrypt entsprechende Berechtigung verfügen.

Konfiguration eines vom Kunden verwalteten KMS-Schlüssels

AgentCore Evaluations unterstützt nur KMS-Schlüssel mit symmetrischer Verschlüsselung. Der KMS-Schlüssel muss sich in derselben AWS Region wie der Evaluator befinden. Informationen zum Erstellen eines symmetrischen KMS-Schlüssels finden Sie unter Erstellen von KMS-Schlüsseln mit symmetrischer Verschlüsselung im AWS Key Management Service Developer Guide.

Konfiguration von Berechtigungen zur Verwendung eines vom Kunden verwalteten KMS-Schlüssels

Die folgende wichtige Richtlinie bietet die Mindestberechtigungen, die für AgentCore Evaluierungen erforderlich sind. Die Richtlinie enthält drei Anweisungen:

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

Die Richtlinie enthält die folgenden Aussagen:

Einen Evaluator mit einem vom Kunden verwalteten KMS-Schlüssel erstellen

Um einen benutzerdefinierten Evaluator zu verschlüsseln, geben Sie den kmsKeyArn Parameter beim Aufrufen an. CreateEvaluator

Ändern der Verschlüsselungskonfiguration eines vorhandenen Evaluators

Sie können die Verschlüsselungskonfiguration eines vorhandenen Evaluators wie folgt ändern: UpdateEvaluator

Einschränkung des Zugriffs auf den vom Kunden verwalteten KMS-Schlüssel

Sie können den Verschlüsselungskontext verwenden, um den Zugriff auf den vom Kunden verwalteten Schlüssel einzuschränken. AgentCore Die Evaluierungen umfassen den folgenden Verschlüsselungskontext in allen KMS-Vorgängen:

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

Sie können diesen Verschlüsselungskontext in wichtigen Richtlinienbedingungen verwenden, um KMS-Operationen auf bestimmte Evaluatoren zu beschränken, wie in der AllowCallerCryptoOps Anweisung im obigen Beispiel für eine Schlüsselrichtlinie dargestellt. Beachten Sie, dass der Kontext eher aws:SourceArn für das Scoping als für den Verschlüsselungskontext AllowServicePrincipalDecrypt verwendet wird.

Überwachung, AgentCore Evaluationen, Interaktion mit AWS KMS

Sie können AWS CloudTrail damit die KMS-API-Anfragen verfolgen, die AgentCore Evaluations in Ihrem Namen stellt. Die folgenden CloudTrail Ereignisnamen erscheinen in Ihren Protokollen:

In den CloudTrail Protokolleinträgen enthält das requestParameters.encryptionContext Feld den aws:bedrock-agentcore:evaluatorArn ARN des Evaluators. Bei Anfragen, die der Dienstleiter während der Online-Evaluierung gestellt hat, wird das userIdentity.invokedBy Feld angezeigtbedrock-agentcore.amazonaws.com.

Weitere Informationen zur Überwachung der KMS-Nutzung finden Sie unter Protokollieren von AWS KMS-API-Aufrufen mit AWS CloudTrail im AWS Key Management Service Developer Guide.

Verhalten, wenn ein Schlüssel nicht mehr verfügbar ist

Wenn Sie Ihren vom Kunden verwalteten KMS-Schlüssel deaktivieren oder löschen oder wenn die Schlüsselrichtlinie nicht mehr die erforderlichen Berechtigungen gewährt:

Um den Zugriff wiederherzustellen, aktivieren Sie den Schlüssel erneut oder aktualisieren Sie die Schlüsselrichtlinie, um die erforderlichen Berechtigungen zu gewähren.