Crittografa il tuo motore AgentCore di policy con una chiave KMS gestita dal cliente

Policy in AgentCore fornisce la crittografia di default per proteggere i dati sensibili dei clienti archiviati utilizzando chiavi AWS di crittografia proprietarie. Come ulteriore livello di protezione, Policy in AgentCore consente di crittografare i motori delle policy utilizzando le AWS chiavi gestite dai clienti (CMK) del AWS Key Management Service (KMS). Questa funzionalità garantisce la protezione dei dati sensibili tramite la crittografia inattiva, che consente di:

Le sezioni seguenti spiegano come configurare la crittografia per i nuovi motori di policy e gestire le chiavi di crittografia.

AWS Tipi di chiavi KMS per Policy in AgentCore

Policy in AgentCore si integra con AWS KMS per gestire le chiavi di crittografia utilizzate per crittografare e decrittografare i dati dei clienti. Per ulteriori informazioni sui tipi e sugli stati delle chiavi, consulta i concetti del servizio di gestione delle AWS chiavi nella Guida per sviluppatori KMS. AWS Quando crei un nuovo motore di policy, puoi scegliere tra i seguenti tipi di chiavi AWS KMS per crittografare i tuoi dati:

AWS chiave di proprietà

Il tipo di crittografia predefinito. Policy in AgentCore possiede la chiave senza costi aggiuntivi per l'utente e crittografa i dati delle risorse inattivi al momento della creazione. Non è richiesta alcuna configurazione aggiuntiva nel codice o nelle applicazioni per crittografare o decrittografare i dati utilizzando la chiave di proprietà di Policy in. AgentCore Non è necessario visualizzare, gestire, utilizzare o controllare queste chiavi. Per ulteriori informazioni, consulta le chiavi AWS possedute nella AWS KMS Developer Guide.

Chiave gestita dal cliente

Crei, possiedi e gestisci la chiave nel tuo AWS account. Hai il pieno controllo sulla chiave KMS. AWS Le tariffe KMS si applicano per le chiavi gestite dal cliente. Per ulteriori informazioni, consulta la pagina dei prezzi AWS KMS. Per ulteriori informazioni sui tipi di chiave, consulta Customer managed keys nella AWS KMS Developer Guide.

Quando si specifica una chiave gestita dal cliente per la crittografia di un motore di policy, Policy in AgentCore crittografa il motore delle policy e tutte le relative risorse secondarie (politiche, generazioni di policy) con quella chiave. Per crittografare un motore di policy utilizzando una chiave gestita dal cliente, devi concedere l'accesso a Policy AgentCore nella tua policy chiave. Una politica chiave è una politica basata sulle risorse che alleghi alla chiave gestita dal cliente per controllarne l'accesso. Per maggiori dettagli, consulta la sezione Autorizzazione dell'uso della chiave AWS KMS per la politica. AgentCore

Inoltre, per creare un motore di policy crittografato con una chiave gestita dal cliente o per effettuare chiamate API a un motore di policy crittografate da una chiave gestita dal cliente, anche l'utente o il ruolo IAM che effettua la chiamata deve avere accesso alla chiave. Se Policy in non AgentCore è in grado di accedere alla chiave, tutte le decisioni di autorizzazione che coinvolgono risorse crittografate da tale chiave verranno negate. Se non si ha accesso alla chiave, non sarà possibile leggere, aggiornare o eliminare le risorse crittografate da tale chiave e qualsiasi chiamata di creazione per utilizzare la chiave per la crittografia avrà esito negativo.

Utilizzo AWS KMS e chiavi dati con Policy in AgentCore

La funzionalità Policy in AgentCore encryption at rest utilizza una chiave KMS e una gerarchia di chiavi dati per proteggere i dati delle risorse.

Policy in AgentCore utilizza un modello basato sulle sovvenzioni per accedere alla chiave gestita dal cliente. Quando si crea un motore di policy con una chiave gestita dal cliente, Policy in AgentCore esegue i seguenti passaggi:

Le due sovvenzioni hanno scopi diversi:

Entrambe le concessioni sono vincolate dal contesto di crittografia che utilizza la chiaveaws:bedrock-agentcore-policy:policy-engine-arn, che lega le concessioni alla specifica risorsa del motore delle politiche.

Quando si elimina un motore di policy con una chiave gestita dal cliente, Policy in AgentCore ritira automaticamente entrambe le concessioni.

Autorizzare l'uso del AWS Chiave KMS per Policy in AgentCore

Per utilizzare una chiave gestita dal cliente con Policy in AgentCore, la policy relativa alla chiave AWS KMS deve concedere le autorizzazioni al tuo account. AWS Quando si crea un motore di policy, Policy effettua AgentCore chiamate kms:CreateGrant utilizzando l'identità dell'utente tramite una sessione di accesso diretto (FAS). Di conseguenza, la policy chiave deve concedere tutte kms:CreateGrant le altre autorizzazioni necessarie al responsabile dell'account (non al responsabile del servizio) e utilizza la kms:ViaService condizione per garantire che la chiave venga utilizzata solo tramite Policy in. AgentCore

Policy in AgentCore richiede almeno le seguenti autorizzazioni su una chiave gestita dal cliente:

Comprensione del contesto di origine

Il contesto di origine fornisce informazioni sul chiamante di origine che tenta di eseguire azioni AWS KMS su una determinata chiave. Ciò impedisce la confusione o l'uso improprio dei dati crittografati associando il contesto alla fonte dei dati.

Quando Policy in AgentCore esegue operazioni AWS KMS tramite concessioni per conto dell'utente, il contesto di origine identifica la Policy nella AgentCore risorsa che ha avviato la richiesta. Puoi utilizzare il contesto di origine come condizione aggiuntiva alle operazioni basate sulle sovvenzioni nella tua politica chiave per limitare l'utilizzo delle chiavi alle richieste provenienti da account o risorse specifici.

Ad esempio, puoi aggiungere aws:SourceArn condizioni alle operazioni KMS aws:SourceAccount e alle dichiarazioni di convalida nella tua politica chiave per garantire che queste operazioni abbiano successo solo quando la richiesta proviene dal tuo account e dalle risorse del tuo motore di gestione delle politiche:

{
  "Sid": "Allow Policy for KMS operations with source context",
  "Effect": "Allow",
  "Principal": {
    "AWS": "arn:aws:iam::111122223333:root"
  },
  "Action": [
    "kms:Decrypt",
    "kms:GenerateDataKey"
  ],
  "Resource": "*",
  "Condition": {
    "StringEquals": {
      "kms:ViaService": "bedrock-agentcore.us-east-1.amazonaws.com",
      "aws:SourceAccount": "111122223333"
    },
    "StringLike": {
      "aws:SourceArn": "arn:aws:bedrock-agentcore:us-east-1:111122223333:policy-engine/*",
      "kms:EncryptionContext:aws:bedrock-agentcore-policy:policy-engine-arn": "arn:aws*:bedrock-agentcore:*:*:policy-engine/*"
    }
  }
}

Questa politica chiave consente a Policy in di AgentCore effettuare chiamate AWS KMS per tuo conto tramite sovvenzioni, se l'account di origine è lo stesso dell'account in cui risiede questa chiave KMS. Questi valori devono essere verificabili quando si controllano i registri di CloudTrail controllo per la chiave KMS. Per ulteriori informazioni sulle chiavi di AWS condizione globali, consulta Using aws: SourceArn or aws: SourceAccount condition keys nella KMS Developer Guide. AWS

Comprendere kms: ViaService

La chiave kms:ViaService condition limita l'uso di una chiave KMS alle richieste provenienti da servizi specifici AWS . Questa chiave condizionale si applica alle Forward Access Sessions (FAS). Per ulteriori informazioni sukms:ViaService, consulta kms: ViaService nella KMS Developer AWS Guide.

Nella politica chiave, il kms:ViaService valore segue il formatobedrock-agentcore.REGION.amazonaws.com, dov'è la AWS regione in cui REGION viene creato il motore delle politiche (ad esempio,bedrock-agentcore.us-east-1.amazonaws.com).

Comprensione del contesto di crittografia

Il contesto di crittografia è un insieme di coppie chiave-valore che contengono dati autenticati aggiuntivi per i controlli di integrità della crittografia. Quando includi un contesto di crittografia in una richiesta di crittografia dei dati, AWS KMS associa crittograficamente il contesto di crittografia ai dati crittografati. Per decrittografare i dati, è necessario passare lo stesso contesto di crittografia. Per ulteriori informazioni, consulta Encryption context nella AWS KMS Developer Guide.

Policy in AgentCore utilizza il seguente contesto di crittografia in tutte le operazioni crittografiche AWS KMS e può essere verificato nei CloudTrail log quando Policy in AgentCore effettua chiamate AWS KMS per conto dell'utente per processi di crittografia e decrittografia:

{
  "aws:bedrock-agentcore-policy:policy-engine-arn": "arn:aws:bedrock-agentcore:REGION:ACCOUNT_ID:policy-engine/POLICY_ENGINE_ID"
}

È possibile utilizzare questo contesto di crittografia nelle condizioni politiche chiave per limitare i motori delle politiche che possono utilizzare la chiave. Ad esempio, la politica chiave riportata nella sezione seguente utilizza una kms:EncryptionContext condizione per consentire l'utilizzo della chiave solo per le risorse del policy engine.

Completa AWS Policy della chiave KMS

In base ai concetti delle sezioni precedenti, la policy chiave di esempio seguente fornisce le autorizzazioni necessarie per crittografare un motore di policy e utilizzare un motore di policy crittografato. La policy contiene le chiavi delle condizioni per conformarsi alle migliori pratiche di sicurezza.

{
"Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "Allow Policy to create grants",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::111122223333:role/ExampleRole"
      },
      "Action": "kms:CreateGrant",
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "kms:ViaService": "bedrock-agentcore.us-east-1.amazonaws.com",
          "kms:GrantConstraintType": "EncryptionContextSubset"
        },
        "StringLike": {
          "kms:EncryptionContext:aws:bedrock-agentcore-policy:policy-engine-arn": "arn:aws*:bedrock-agentcore:*:*:policy-engine/*"
        },
        "ForAllValues:StringEquals": {
          "kms:GrantOperations": [
            "Encrypt",
            "Decrypt",
            "GenerateDataKey",
            "GenerateDataKeyWithoutPlaintext",
            "ReEncryptFrom",
            "ReEncryptTo"
          ]
        }
      }
    },
    {
      "Sid": "Allow Policy for KMS operations",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::111122223333:role/ExampleRole"
      },
      "Action": [
        "kms:Decrypt",
        "kms:GenerateDataKey"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "kms:ViaService": "bedrock-agentcore.us-east-1.amazonaws.com"
        },
        "StringLike": {
          "kms:EncryptionContext:aws:bedrock-agentcore-policy:policy-engine-arn": "arn:aws*:bedrock-agentcore:*:*:policy-engine/*"
        }
      }
    },
    {
      "Sid": "Allow Policy for KMS validation",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::111122223333:role/ExampleRole"
      },
      "Action": "kms:DescribeKey",
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "kms:ViaService": "bedrock-agentcore.us-east-1.amazonaws.com"
        }
      }
    }
  ]
}

La politica contiene le seguenti dichiarazioni:

Prerequisiti per la crittografia del motore di policy

Prima di crittografare il tuo motore di policy, assicurati di aver soddisfatto i seguenti prerequisiti:

Per ulteriori informazioni sul controllo delle autorizzazioni IAM per una chiave KMS, consulta l'accesso e le autorizzazioni delle chiavi KMS nella KMS Developer Guide. AWS

Creazione di un motore di policy crittografato

Prima di creare un motore di policy crittografato, assicurati che la chiave gestita dal cliente che stai utilizzando abbia le istruzioni chiave appropriate impostate per Policy in AgentCore to use la chiave per la crittografia e la decrittografia. Vedi Autorizzazione dell'uso della chiave AWS KMS per Policy per le autorizzazioni richieste AgentCore.

Per crittografare il tuo motore di policy utilizzando la AWS CLI, includi --encryption-key-arn il parametro quando create-policy-engine invii una richiesta:

aws bedrock-agentcore-control create-policy-engine \
  --name "MyPolicyEngine" \
  --description "Policy engine with customer-managed encryption" \
  --encryption-key-arn "arn:aws:kms:us-east-1:123456789012:key/1234abcd-12ab-34cd-56ef-1234567890ab"

La risposta include l'ARN e lo status del motore di policy:

{
  "policyEngineId": "MyPolicyEngine-abc123",
  "name": "MyPolicyEngine",
  "description": "Policy engine with customer-managed encryption",
  "policyEngineArn": "arn:aws:bedrock-agentcore:us-east-1:123456789012:policy-engine/MyPolicyEngine-abc123",
  "status": "CREATING",
  "statusReasons": [],
  "encryptionKeyArn": "arn:aws:kms:us-east-1:123456789012:key/1234abcd-12ab-34cd-56ef-1234567890ab",
  "createdAt": "2026-02-24T12:00:00Z",
  "updatedAt": "2026-02-24T12:00:00Z"
}

Limitazioni

Le seguenti limitazioni si applicano alla crittografia a chiave gestita dal cliente per i motori di policy:

Risoluzione dei problemi

Questa sezione descrive gli errori più comuni relativi alle chiavi gestite dai clienti che potresti riscontrare durante l'utilizzo di Policy in AgentCore e fornisce le procedure di risoluzione dei problemi per risolverli.

Accesso negato: AWS Problema di autorizzazione KMS

Errore: «Accesso negato per la chiave KMS specificata. Verifica che la politica chiave conceda le autorizzazioni richieste».

Ciò potrebbe significare che al chiamante non sono disponibili i permessi di azione kms: * richiesti nella policy IAM o nella policy della chiave AWS KMS, oppure che la chiave a cui si fa riferimento non esiste o non esiste più.

Per risolvere questo problema:

Eccezione di convalida: AWS Configurazione della chiave KMS

Errore: «La chiave KMS specificata non è in uno stato utilizzabile. Verifica che la chiave sia abilitata e non sia in attesa di eliminazione».

Ciò significa che la chiave a cui si fa riferimento non può essere utilizzata per la crittografia a chiave gestita dal cliente a causa della sua configurazione attuale. Le ragioni possibili sono:

Per risolvere questo problema: verifica che la chiave soddisfi i prerequisiti descritti in Prerequisiti per la crittografia del motore delle politiche.