Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Associez la réplique à un secret principal
Une fois que le propriétaire du compte de réplication a créé le secret de réplication, le propriétaire du compte principal associe le réplica au secret principal pour démarrer la réplication. Pour savoir comment créer le secret de réplique, voir Créer un secret de réplique.
Fonctionnement de l’association
Le titulaire principal du compte gère AssociateCrossAccountReplica avec SecretId pour le secret principal et CrossAccountReplicaARN pour la réplique secrète.
Lors de l'association, Secrets Manager effectue les opérations suivantes :
-
Effectue un fonctionnement à sec AWS KMS contrôles d'autorisation sur les clés KMS du secret principal et de la clé secrète de réplication.
-
Configure les métadonnées de réplication pour le secret principal et le secret de réplication.
-
Déclenche le processus de réplication pour commencer à répliquer les données du secret principal vers le secret de réplication.
AcceptCrossAccountReplication
AcceptCrossAccountReplication est une opération interne uniquement que Secrets Manager appelle dans AssociateCrossAccountReplica. Cette opération agit sur le secret de la réplique en utilisant l'identité du AssociateCrossAccountReplica appelant.
Le AcceptCrossAccountReplication call effectue le fonctionnement à sec kms:Encrypt vérifie la clé KMS du secret de réplication et met à jour les métadonnées de réplication du secret de réplication. Seulement après AcceptCrossAccountReplication réussit AssociateCrossAccountReplica mettre à jour les métadonnées de réplication sur le secret principal.
Autorisations pour associer un réplica
L'identité qui associe le réplica nécessite les autorisations suivantes :
-
secretsmanager:AssociateCrossAccountReplicasur le secret principal. -
secretsmanager:GetSecretValuesur le secret principal. -
secretsmanager:AcceptCrossAccountReplicationsur la réplique secrète. -
kms:Decryptsur la clé KMS du secret principal. -
kms:Encryptsur la clé KMS de la réplique secrète (compte croisé).
Si vous passez un rôle de réplication avec ReplicationRoleARN, l'appelant doit également iam:PassRole pour ce rôle.
Autorisations pour la réplication
Pour satisfaire le multicompte kms:Encrypt sans donner à chaque appelant un accès intercompte à la clé de réplication, nous recommandons un rôle de réplication. Secrets Manager assume le rôle et l'utilise comme identité unique pour les opérations relatives aux clés de chiffrement. Pour les deux approches que Secrets Manager peut utiliser, voir Comment Secrets Manager autorise la réplication entre comptes.
Restriction en matière
La restriction de réplication est un paramètre de AssociateCrossAccountReplica opération. Ce paramètre contrôle si Secrets Manager bloque la réplication vers un secret de réplication extérieur à votre AWS organisation.
Par défaut, la restriction de réplication est SameOrg, ce qui nécessite que les deux comptes soient dans le même AWS organisation. Pour autoriser la réplication en dehors de votre AWS organisation, définissez la restriction sur NoRestriction.
Secrets Manager applique la restriction de réplication uniquement lors de l'association initiale. Appel AssociateCrossAccountReplica toujours avec une valeur de restriction différente, cela ne modifie pas une association existante.
Si le compte de réplication ne répond pas à la restriction, Secrets Manager renvoie un AccessDeniedException sur l'intérieur AcceptCrossAccountReplication appel.
AWS CLI
Depuis le compte principal, exécutez AssociateCrossAccountReplica.
Exemple Associez la réplique au secret principal
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" }
Exemple La restriction de réplication refuse une réplique en dehors de AWS organization
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
Pour effectuer une réplication vers un compte autre que votre AWS organisation, ajouter --replica-restriction NoRestriction.
La réplication est asynchrone. Appel DescribeSecret périodiquement et vérifiez les ReplicationStatus champ jusqu'à ce qu'il apparaisse InSync.
Exemple Vérifiez l'état de la réplication
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" } ] }
Pour plus d'informations sur les champs d'état de réplication, voir Surveillez la réplication entre comptes.
AWS Kit SDK
Pour associer la réplique au secret principal, utilisez AssociateCrossAccountReplica commande. Pour plus d'informations, consultez AWS Kits SDK.