View a markdown version of this page

Crittografia inattiva per AgentCore le valutazioni - Fondamento Amazon AgentCore
Opzioni di crittografiaIn che modo AgentCore Evaluations utilizza una chiave KMS gestita dal clienteConfigurazione di una chiave KMS gestita dal clienteMonitoraggio e AgentCore valutazione: interazione con AWS KMSComportamento quando una chiave diventa non disponibile

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Crittografia inattiva per AgentCore le valutazioni

Nota

Questa pagina illustra la crittografia a chiave gestita dal cliente per valutatori personalizzati. Per la crittografia dei set di dati, vedere Crittografia dei set di dati.

Opzioni di crittografia

Amazon Bedrock AgentCore Evaluations crittografa tutti i dati inattivi per impostazione predefinita utilizzando una chiave AWS di proprietà senza costi aggiuntivi. Non è possibile visualizzare, gestire o verificare l'uso di questa chiave.

Facoltativamente, puoi crittografare i dati sensibili del valutatore con una chiave gestita dal cliente. Quando si specifica una chiave AWS KMS gestita dal cliente su un valutatore personalizzato, il servizio crittografa le istruzioni e la scala di valutazione del valutatore utilizzando la crittografia a inviluppo con Encryption SDK. AWS Tutti gli altri metadati del valutatore (nome, livello, configurazione del modello, stato) rimangono crittografati con la chiave proprietaria. AWS

L'utilizzo di una chiave gestita dal cliente offre un maggiore controllo sul processo di crittografia, inclusa la possibilità di:

  • Creare e gestire la chiave, inclusa l'impostazione delle politiche chiave

  • Ruota la chiave secondo i tuoi orari

  • Disabilita o elimina la chiave per controllare l'accesso ai dati crittografati

  • Verifica l'utilizzo della chiave tramite AWS CloudTrail

Per ulteriori informazioni, consulta le chiavi gestite dal cliente nella AWS Key Management Service Developer Guide.

In che modo AgentCore Evaluations utilizza una chiave KMS gestita dal cliente

Quando si specifica una chiave gestita dal cliente su un valutatore personalizzato, il servizio utilizza le credenziali del chiamante (tramite Forward Access Sessions) per crittografare e decrittografare le istruzioni e la scala di valutazione del valutatore. Il chiamante deve disporre kms:GenerateDataKey delle autorizzazioni necessarie per la chiave. kms:Decrypt kms:DescribeKey

Per la valutazione online, il servizio decrittografa le istruzioni del valutatore in modo asincrono utilizzando il proprio service principal (). bedrock-agentcore.amazonaws.com Il responsabile del servizio deve disporre kms:Decrypt dell'autorizzazione nella politica chiave.

Nota

AgentCore Le valutazioni non utilizzano le concessioni KMS o le chiavi di dati della cache. Le configurazioni di valutazione online non accettano alcun kmsKeyArn parametro: ereditano la crittografia CMK dai valutatori a cui fanno riferimento.

Configurazione di una chiave KMS gestita dal cliente

AgentCore Evaluations supporta solo chiavi KMS di crittografia simmetrica. La chiave KMS deve trovarsi nella stessa AWS regione del valutatore. Per informazioni sulla creazione di una chiave KMS simmetrica, consulta Creazione di chiavi KMS di crittografia simmetrica nella Key Management Service Developer Guide. AWS

Configurazione delle autorizzazioni per l'utilizzo di una chiave KMS gestita dal cliente

La seguente politica chiave fornisce le autorizzazioni minime richieste per le valutazioni. AgentCore La policy ha tre istruzioni:

  • AllowCallerAccess— Consente all'utente o al ruolo IAM di convalidare la chiave tramiteDescribeKey, con ambito di. kms:ViaService

  • AllowCallerCryptoOps— Consente all'utente o al ruolo IAM di crittografare e decrittografare, in base all'ambito e al contesto di crittografia. kms:ViaService

  • AllowServicePrincipalDecrypt— Consente al responsabile del AgentCore servizio di decriptare durante la valutazione online, in base all'account di origine e all'ARN di origine.

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

La policy contiene le seguenti dichiarazioni:

  • AllowCallerAccess— Concede l'kms:DescribeKeyautorizzazione al ruolo IAM, limitata alle richieste effettuate tramite il AgentCore servizio ()kms:ViaService. Sostituiscilo 111122223333 con l'ID del tuo account, MyEvaluationRole con il ruolo o l'utente IAM che gestisce i valutatori e us-east-1 con la tua regione. AWS

  • AllowCallerCryptoOps— Concede il ruolo kms:GenerateDataKey e le kms:Decrypt autorizzazioni IAM, in base all'ambito kms:ViaService e al contesto di crittografia. aws:bedrock-agentcore:evaluatorArn Sostituisci111122223333, MyEvaluationRoleus-east-1, e my-evaluator-id con i tuoi valori. Per consentire l'accesso a tutti i valutatori del tuo account, usa una jolly conStringLike:. arn:aws:bedrock-agentcore:us-east-1:111122223333:evaluator/ Nota che quando usi un carattere jolly, devi cambiare l'operatore di condizione da StringEquals aStringLike, perché viene StringEquals trattato come un carattere letterale.

  • AllowServicePrincipalDecrypt— Concede al principale del AgentCore servizio l'kms:Decryptautorizzazione per la decrittografia dei dati del valutatore durante l'esecuzione della valutazione online. Elaborato in base all'account di origine e all'ARN di origine (aws:SourceArn) per prevenire attacchi confusi da parte dei vice. Sostituisci us-east-1 e 111122223333 con la tua regione e l'ID dell'account.

Creazione di un valutatore con una chiave KMS gestita dal cliente

Per crittografare un valutatore personalizzato, specifica il parametro al momento della kmsKeyArn chiamata. CreateEvaluator

Esempio
CLI
aws bedrock-agentcore-control create-evaluator \
  --evaluator-name "MyEncryptedEvaluator" \
  --level SESSION \
  --kms-key-arn "arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab" \
  --evaluator-config '{
    "llmAsAJudge": {
      "instructions": "Rate the session quality using {available_tools} and {context}",
      "ratingScale": {
        "categorical": [
          {"label": "Good", "definition": "The agent performed well"},
          {"label": "Bad", "definition": "The agent performed poorly"}
        ]
      },
      "modelConfig": {
        "bedrockEvaluatorModelConfig": {
          "modelId": "us.anthropic.claude-sonnet-4-20250514-v1:0"
        }
      }
    }
  }'
Python (Boto3)
import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.create_evaluator(
    evaluatorName='MyEncryptedEvaluator',
    level='SESSION',
    kmsKeyArn='arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab',
    evaluatorConfig={
        'llmAsAJudge': {
            'instructions': 'Rate the session quality using {available_tools} and {context}',
            'ratingScale': {
                'categorical': [
                    {'label': 'Good', 'definition': 'The agent performed well'},
                    {'label': 'Bad', 'definition': 'The agent performed poorly'}
                ]
            },
            'modelConfig': {
                'bedrockEvaluatorModelConfig': {
                    'modelId': 'us.anthropic.claude-sonnet-4-20250514-v1:0'
                }
            }
        }
    }
)

print(f"Evaluator ID: {response['evaluatorId']}")

Modifica della configurazione di crittografia su un valutatore esistente

È possibile modificare la configurazione di crittografia su un valutatore esistente utilizzando: UpdateEvaluator

  • Aggiungi crittografia: specifica una kmsKeyArn su un valutatore creato senza una crittografia. Il servizio crittografa le istruzioni e la scala di valutazione con la nuova chiave.

  • Chiave di rotazione: specificane una diversa. kmsKeyArn Il servizio decrittografa i dati con la vecchia chiave e li crittografa nuovamente con la nuova chiave. Il chiamante deve disporre delle autorizzazioni per entrambe le chiavi. Se la vecchia chiave non è disponibile (disattivata, eliminata o con autorizzazioni mancanti), l'aggiornamento avrà esito negativo.

Nota

Una volta aggiunta, non è possibile rimuovere la crittografia delle chiavi gestita dal cliente da un valutatore.

Definizione dell'ambito di accesso alla chiave KMS gestita dal cliente

È possibile utilizzare il contesto di crittografia per limitare l'accesso alla chiave gestita dal cliente. AgentCore Le valutazioni includono il seguente contesto di crittografia in tutte le operazioni KMS:

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

È possibile utilizzare questo contesto di crittografia in condizioni politiche chiave per limitare le operazioni KMS a valutatori specifici, come mostrato nella AllowCallerCryptoOps dichiarazione contenuta nella politica chiave di esempio riportata sopra. Nota che AllowServicePrincipalDecrypt viene utilizzato aws:SourceArn per l'ambito anziché per il contesto di crittografia.

Monitoraggio e AgentCore valutazione: interazione con AWS KMS

Puoi utilizzarlo AWS CloudTrail per tenere traccia delle richieste API KMS effettuate da AgentCore Evaluations per tuo conto. I seguenti nomi di CloudTrail eventi vengono visualizzati nei tuoi log:

  • GenerateDataKey— Quando si crea o si aggiorna un valutatore con una chiave gestita dal cliente.

  • Decrypt— Durante il recupero dei dati del valutatore, durante la valutazione su richiesta o durante l'esecuzione della valutazione online.

  • DescribeKey— Quando si convalida la chiave durante la creazione, l'aggiornamento o la creazione della configurazione di valutazione online.

Nelle voci del CloudTrail registro, il requestParameters.encryptionContext campo contiene aws:bedrock-agentcore:evaluatorArn l'ARN del valutatore. Per le richieste fatte dal responsabile del servizio durante la valutazione online, viene visualizzato il userIdentity.invokedBy campo. bedrock-agentcore.amazonaws.com

Per ulteriori informazioni sul monitoraggio dell'utilizzo del KMS, vedi Registrazione delle chiamate API AWS KMS AWS CloudTrail nella AWS Key Management Service Developer Guide.

Comportamento quando una chiave diventa non disponibile

Se disabiliti o elimini la chiave KMS gestita dal cliente o se la policy chiave non concede più le autorizzazioni richieste:

  • GetEvaluator con ALL_DATA: non riesce perché il servizio non è in grado di decrittografare le istruzioni e la scala di valutazione.

  • GetEvaluator con METADATA_ONLY: ha esito positivo perché non è richiesta alcuna operazione KMS.

  • Valutazione (su richiesta): fallisce per i CMK-encrypted valutatori perché il servizio non è in grado di decrittografare le istruzioni.

  • UpdateEvaluator (rotazione della chiave): non riesce perché il servizio non è in grado di decrittografare i dati esistenti con la chiave non disponibile prima di crittografarli nuovamente con la nuova chiave.

  • CreateOnlineEvaluationConfig / UpdateOnlineEvaluationConfig— Fallisce perché il servizio non è in grado di convalidare l'accesso del chiamante tramite e funzionamento a secco. kms:DescribeKey kms:Decrypt

  • Esecuzione della valutazione online: non riesce perché il servizio non è in grado di decrittografare le istruzioni del valutatore per il punteggio.

  • DeleteEvaluator— Ha esito positivo perché l'eliminazione non richiede la decrittografia dei dati del valutatore.

  • DeleteOnlineEvaluationConfig— Ha esito positivo perché l'eliminazione non richiede l'accesso al KMS.

Suggerimento

includedData=METADATA_ONLYUsalo GetEvaluator per recuperare i metadati del valutatore (nome, livello, configurazione del modello, stato) senza richiedere le autorizzazioni KMS. Ciò è utile per il monitoraggio e l'inventario dei flussi di lavoro quando la chiave non è disponibile.

Per ripristinare l'accesso, riattiva la chiave o aggiorna la policy chiave per concedere le autorizzazioni richieste.

Nota

Per informazioni sulla crittografia delle chiavi gestita dal cliente per i set di dati, vedi Crittografia dei set di dati.