View a markdown version of this page

In che modo Secrets Manager autorizza la replica tra account - AWS Secrets Manager

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à.

In che modo Secrets Manager autorizza la replica tra account

Ogni volta che Secrets Manager replica un valore segreto, decrittografa il valore con la chiave KMS del segreto primario e lo crittografa nuovamente con la chiave KMS del segreto di replica. Secrets Manager necessita di un'identità autorizzata per entrambe le operazioni. Sei tu a scegliere l'identità: un ruolo di replica che Secrets Manager assume o l'identità del chiamante tramite una sessione di accesso diretto (FAS). Questo argomento spiega entrambi gli approcci.

Come viene attivata la replica

Secrets Manager mantiene la replica sincronizzata replicando ogni modifica sul valore segreto primario. Ad esempio, quando chiami PutSecretValue sul segreto primario, Secrets Manager crea la nuova versione, sposta il AWSCURRENT assegnando un'etichetta temporanea ad essa e quindi replica la versione nella replica. La replica è asincrona e alla fine coerente, pertanto la replica potrebbe non riflettere immediatamente il valore più recente. Per seguire i progressi, vedere Monitora la replica su più account.

La replica ne esegue due AWS KMS operazioni

Per spostare un valore segreto dal primario alla replica, Secrets Manager esegue le due operazioni seguenti AWS KMS operazioni nell'ordine:

  1. Decifrare — Secrets Manager chiama kms:Decrypt con la chiave KMS del segreto primario per decrittografare la chiave dati che protegge il valore segreto.

  2. Crittografa — Chiamate da Secrets Manager kms:Encrypt con la chiave KMS segreta della replica per crittografare nuovamente la chiave dati per l'archiviazione nella replica.

Poiché le due chiavi KMS si trovano in account diversi, la politica delle chiavi della chiave di replica deve consentire la chiamata all'account del segreto primario kms:Encrypt. È possibile definire questo criterio utilizzando il contesto di crittografia SecretARN per limitare l'uso al segreto della replica. Per la dichiarazione politica chiave, vedere Crea una replica segreta. Per ulteriori informazioni su come Secrets Manager utilizza le chiavi KMS e il contesto di crittografia durante la replica, vedere AWS KMS chiavi per la replica tra account.

Importante

Una politica di controllo delle risorse (RCP) o una politica di controllo dei servizi (SCP) a livello di organizzazione possono bloccarli AWS KMS operazioni, anche se l'identità e le politiche chiave le consentono.

Scegli in che modo Secrets Manager ottiene le autorizzazioni

La differenza tra i due approcci è l'identità che Secrets Manager utilizza per creare i due AWS KMS chiamate.

Ruolo di replica (consigliato)

Quando si fornisce un ruolo di replica, Secrets Manager assume tale ruolo IAM e lo utilizza come identità per entrambi AWS KMS chiamate. Secrets Manager utilizza il ruolo per chiamare kms:Decrypt sulla chiave KMS del segreto primario e kms:Encrypt sulla chiave KMS del segreto della replica. Poiché il ruolo prevede le autorizzazioni per più account, i singoli chiamanti di PutSecretValue non è necessario che tutti abbiano bisogno di più account AWS KMS autorizzazioni. Con questo approccio, il segreto principale deve utilizzare una chiave KMS gestita dal cliente.

Per informazioni su come impostare il ruolo, la relativa politica di fiducia e la politica di autorizzazione, consulta Imposta il ruolo del servizio di replica.

Inoltro delle sessioni di accesso

UN sessione di accesso diretto (FAS) consente a Secrets Manager di effettuare chiamate API downstream utilizzando le autorizzazioni dell'identità che ha attivato l'operazione. Quando non si fornisce un ruolo di replica, Secrets Manager utilizza una sessione di accesso diretto: le due AWS KMS chiamate con l'identità che ha richiamato l'operazione di attivazione, ad esempio PutSecretValue.

Nota

Con una sessione di accesso diretto, la replica iniziale viene eseguita utilizzando l'identità chiamata AssociateCrossAccountReplica.

Con questo approccio, l'identità che attiva deve possedere entrambe le seguenti autorizzazioni:

  • kms:Decrypt sulla chiave KMS del segreto primario. Questa chiave si trova nello stesso account del chiamante, quindi il chiamante di solito è già in possesso di questa autorizzazione.

  • kms:Encrypt sulla chiave KMS del segreto della replica. Questa chiave si trova nell'account di replica, quindi il chiamante deve avere l'autorizzazione per utilizzarla su più account. Questo è il requisito che FAS rende più difficile da soddisfare.

Se l'identità di attivazione è priva di una delle due AWS KMS autorizzazione, la replica non può essere completata e lo stato della replica diventa Failed. Per informazioni sulla lettura dello stato e sul ripristino, consulta Monitora la replica su più account.

La seguente politica di identità consente a PutSecretValue chiamante per utilizzare il cross-account kms:Encrypt l'autorizzazione necessaria sulla chiave KMS del segreto della replica. L'istruzione è basata sul contesto di crittografia SecretARN in modo che l'identità possa utilizzare la chiave KMS del segreto di replica solo per il segreto di replica. Allega una policy come questa all'identità che chiama PutSecretValue sul segreto primario.

Esempio Politica di identità per un chiamante da crittografare con la chiave KMS del segreto di replica
{ "Version": "2012-10-17", "Statement": [ { "Sid": "EncryptReplicaSecretKey", "Effect": "Allow", "Action": "kms:Encrypt", "Resource": "arn:aws:kms:us-east-2:444455556666:key/replica-key-id", "Condition": { "StringEquals": { "kms:EncryptionContext:SecretARN": "arn:aws:secretsmanager:us-east-2:444455556666:secret:MyReplicaSecret-a1b2c3" } } } ] }

Raccomandazione

Per la maggior parte dei casi d'uso, il ruolo di replica è l'approccio consigliato. Secrets Manager assume il ruolo e lo utilizza come identità singola per entrambi AWS KMS chiamate, quindi non è necessario concedere a tutti gli account di Writer Identity l'autorizzazione per la chiave KMS della replica segreta. Le sessioni di accesso diretto possono essere utili nei casi in cui le identità che modificano il segreto primario detengono già il cross-account kms:Encrypt autorizzazione sulla chiave KMS del segreto di replica e preferisci non gestire un ruolo di replica.

Imposta il ruolo del servizio di replica

Il ruolo del servizio deve fidarsi secretsmanager.amazonaws.come può essere condizionato aws:SourceAccount e aws:SourceArn per aiutare a prevenire il confuso problema dei vice. La sua politica di autorizzazione deve consentire kms:Decrypt sulla chiave KMS del segreto primario (opzionalmente con il contesto di crittografia SecretARN impostato sull'ARN segreto primario) e kms:Encrypt sulla chiave KMS del segreto di replica (opzionalmente con il contesto di crittografia SecretARN impostato sull'ARN segreto di replica).

Esempio Politica di fiducia per il ruolo del servizio di replica (esempio rappresentativo)
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "secretsmanager.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "aws:SourceAccount": "111122223333" }, "ArnEquals": { "aws:SourceArn": "arn:aws:secretsmanager:us-east-2:111122223333:secret:MyPrimarySecret-a1b2c3" } } } ] }
Esempio Politica di autorizzazione per il ruolo del servizio di replica (esempio rappresentativo)
{ "Version": "2012-10-17", "Statement": [ { "Sid": "DecryptPrimarySecretKey", "Effect": "Allow", "Action": "kms:Decrypt", "Resource": "arn:aws:kms:us-east-2:111122223333:key/primary-key-id", "Condition": { "StringEquals": { "kms:EncryptionContext:SecretARN": "arn:aws:secretsmanager:us-east-2:111122223333:secret:MyPrimarySecret-a1b2c3" } } }, { "Sid": "EncryptReplicaSecretKey", "Effect": "Allow", "Action": "kms:Encrypt", "Resource": "arn:aws:kms:us-east-2:444455556666:key/replica-key-id", "Condition": { "StringEquals": { "kms:EncryptionContext:SecretARN": "arn:aws:secretsmanager:us-east-2:444455556666:secret:MyReplicaSecret-a1b2c3" } } } ] }

La Chiave gestita da AWS (aws/secretsmanager) non supporta kms:Decrypt chiamate da un ruolo di servizio. È necessario utilizzare una chiave gestita dal cliente per il segreto primario quando si utilizza un ruolo di replica. Aggiungi una dichiarazione come la seguente alla policy della chiave primaria per consentire al ruolo di replica di decrittografare la chiave dati del segreto primario.

Esempio Dichiarazione politica della chiave primaria che consente la decrittografia del ruolo di replica (esempio rappresentativo)
{ "Sid": "AllowReplicationRoleDecrypt", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:role/SecretsManagerCrossAccountReplicationRole" }, "Action": "kms:Decrypt", "Resource": "*", "Condition": { "StringEquals": { "kms:EncryptionContext:SecretARN": "arn:aws:secretsmanager:us-east-2:111122223333:secret:MyPrimarySecret-a1b2c3" } } }