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:AssociateCrossAccountReplicasul segreto primario. -
secretsmanager:GetSecretValuesul segreto primario. -
secretsmanager:AcceptCrossAccountReplicationsul segreto della replica. -
kms:Decryptsulla chiave KMS del segreto primario. -
kms:Encryptsulla 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.