View a markdown version of this page

Associa la replica a un segreto primario - 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à.

Associa la replica a un segreto primario

Dopo che il proprietario dell'account di replica ha creato il segreto di replica, il proprietario dell'account principale associa la replica al segreto primario per avviare la replica. Per informazioni su come creare il segreto della replica, vedi Crea una replica segreta.

Funzionamento dell’associazione

Il proprietario principale dell'account gestisce AssociateCrossAccountReplica con SecretId per il segreto primario e CrossAccountReplicaARN per il segreto della replica.

Durante l'associazione, Secrets Manager esegue le seguenti operazioni:

  • Esegue la corsa a secco AWS KMS controlli delle autorizzazioni sulla chiave KMS primaria e sulla chiave segreta di replica.

  • Imposta i metadati di replica per i segreti primari e di replica.

  • Attiva il processo di replica per avviare la replica dei dati dal segreto primario al segreto di replica.

AcceptCrossAccountReplication

AcceptCrossAccountReplication è un'operazione solo interna che Secrets Manager chiama all'interno AssociateCrossAccountReplica. Questa operazione agisce sul segreto della replica utilizzando l'identità del AssociateCrossAccountReplica chiamante.

Il AcceptCrossAccountReplication la chiamata esegue la corsa a secco kms:Encrypt controlla la chiave KMS del segreto di replica e aggiorna i metadati di replica del segreto di replica. Solo dopo AcceptCrossAccountReplication ha successo AssociateCrossAccountReplica aggiorna i metadati di replica sul segreto primario.

Autorizzazioni per associare una replica

L'identità che associa la replica richiede le seguenti autorizzazioni:

  • secretsmanager:AssociateCrossAccountReplica sul segreto primario.

  • secretsmanager:GetSecretValue sul segreto primario.

  • secretsmanager:AcceptCrossAccountReplication sul segreto della replica.

  • kms:Decrypt sulla chiave KMS del segreto primario.

  • kms:Encrypt sulla chiave KMS del segreto di replica (cross-account).

Se si passa un ruolo di replica con ReplicationRoleARN, il chiamante ha anche bisogno iam:PassRole per quel ruolo.

Autorizzazioni per la replica

Per soddisfare le esigenze di più account kms:Encrypt l'autorizzazione senza concedere a tutti i chiamanti l'accesso alla chiave di replica con più account, consigliamo un ruolo di replica. Secrets Manager assume il ruolo e lo utilizza come identità singola per le operazioni con la chiave di crittografia. Per i due approcci che Secrets Manager può utilizzare, vedi In che modo Secrets Manager autorizza la replica tra account.

Restrizione della replica

La restrizione della replica è un parametro di AssociateCrossAccountReplica operazione. Questo parametro controlla se Secrets Manager blocca la replica su un segreto di replica esterno al tuo AWS organizzazione.

Per impostazione predefinita, la restrizione relativa alla replica è SameOrg, che richiede che entrambi gli account siano nello stesso AWS organizzazione. Per consentire la replica all'esterno AWS organizzazione, imposta la restrizione su NoRestriction.

Secrets Manager applica la restrizione della replica solo durante l'associazione iniziale. Chiamata AssociateCrossAccountReplica nuovamente con un valore di restrizione diverso non modifica un'associazione esistente.

Se l'account di replica non soddisfa la restrizione, Secrets Manager restituisce un AccessDeniedException sul lato interno AcceptCrossAccountReplication chiamata.

AWS CLI

Dall'account principale, esegui AssociateCrossAccountReplica.

Esempio Associa la replica al segreto principale
aws secretsmanager associate-cross-account-replica \ --secret-id MyPrimarySecret \ --cross-account-replica-arn arn:aws:secretsmanager:us-east-2:444455556666:secret:MyReplicaSecret-a1b2c3 \ --replication-role-arn arn:aws:iam::111122223333:role/SecretsManagerCrossAccountReplicationRole
{ "ARN": "arn:aws:secretsmanager:us-east-2:111122223333:secret:MyPrimarySecret-a1b2c3", "CrossAccountReplicaARN": "arn:aws:secretsmanager:us-east-2:444455556666:secret:MyReplicaSecret-a1b2c3", "ReplicationStatus": "InProgress" }
Esempio La restrizione delle repliche nega una replica al di fuori del AWS organizzazione
aws secretsmanager associate-cross-account-replica \ --secret-id MyPrimarySecret \ --cross-account-replica-arn arn:aws:secretsmanager:us-east-2:555555555555:secret:MyReplicaSecret-a1b2c3 \ --replica-restriction SameOrg
An error occurred (AccessDeniedException) when calling the AssociateCrossAccountReplica operation: User: arn:aws:sts::111122223333:assumed-role/Admin/secretsmanager-Test is not authorized to perform: secretsmanager:AcceptCrossAccountReplication on resource: arn:aws:secretsmanager:us-east-2:555555555555:secret:MyReplicaSecret-a1b2c3 with an explicit deny in a resource-based policy

Per eseguire la replica su un account esterno al tuo AWS organizzazione, aggiungi --replica-restriction NoRestriction.

La replica è asincrona. Chiama DescribeSecret periodicamente e controlla ReplicationStatus campo finché non viene visualizzato InSync.

Esempio Verificare lo stato della replica
aws secretsmanager describe-secret \ --secret-id MyPrimarySecret
{ "ARN": "arn:aws:secretsmanager:us-east-2:111122223333:secret:MyPrimarySecret-a1b2c3", "Name": "MyPrimarySecret", "KmsKeyId": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", "LastChangedDate": 1793805184.669, "LastAccessedDate": 1793664000.0, "VersionIdsToStages": { "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111": [ "AWSCURRENT" ], "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222": [ "AWSPREVIOUS" ] }, "CreatedDate": 1793314703.348, "CrossAccountReplicas": [ { "ReplicaSecretARN": "arn:aws:secretsmanager:us-east-2:444455556666:secret:MyReplicaSecret-a1b2c3", "ReplicationRoleARN": "arn:aws:iam::111122223333:role/SecretsManagerCrossAccountReplicationRole", "ReplicationStatus": "InSync" } ] }

Per ulteriori informazioni sui campi relativi allo stato della replica, vedere Monitora la replica su più account.

AWS SDK

Per associare la replica al segreto principale, usa AssociateCrossAccountReplica comando. Per ulteriori informazioni, consulta AWS SDK.