Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Asociar la réplica a un secreto principal
Una vez que el propietario de la cuenta de réplica crea el secreto de la réplica, el propietario de la cuenta principal asocia la réplica al secreto principal para iniciar la replicación. Para saber cómo crear el secreto de la réplica, consulte Crea un secreto de réplica.
Cómo funciona la asociación
El propietario de la cuenta principal ejecuta AssociateCrossAccountReplica con SecretId para el secreto principal y CrossAccountReplicaARN para el secreto de la réplica.
Durante la asociación, Secrets Manager hace lo siguiente:
-
Realiza un ensayo en seco AWS KMS comprueba los permisos de las claves de KMS del secreto principal y de la réplica.
-
Configura los metadatos de replicación para los secretos principales y de réplica.
-
Activa el proceso de replicación para comenzar a replicar los datos del secreto principal al secreto de la réplica.
AcceptCrossAccountReplication
AcceptCrossAccountReplication es una operación exclusivamente interna a la que Secrets Manager invoca AssociateCrossAccountReplica. Esta operación actúa sobre el secreto de la réplica utilizando la identidad del AssociateCrossAccountReplica persona que llama.
El AcceptCrossAccountReplication la llamada realiza el simulacro kms:Encrypt comprueba la clave KMS del secreto de la réplica y actualiza los metadatos de replicación del secreto de la réplica. Solo después AcceptCrossAccountReplication tiene éxito AssociateCrossAccountReplica actualiza los metadatos de replicación en el secreto principal.
Permisos para asociar una réplica
La identidad que asocia la réplica necesita los siguientes permisos:
-
secretsmanager:AssociateCrossAccountReplicaen el secreto principal. -
secretsmanager:GetSecretValuesobre el secreto principal. -
secretsmanager:AcceptCrossAccountReplicationen el secreto de la réplica. -
kms:Decrypten la clave KMS del secreto principal. -
kms:Encrypten la clave KMS del secreto de la réplica (multicuenta).
Si transfieres una función de replicación con ReplicationRoleARN, la persona que llama también necesita iam:PassRole para ese papel.
Permisos de replicación
Para satisfacer las cuentas cruzadas kms:Encrypt sin conceder a todas las personas que llamen acceso multicuenta a la clave de réplica, recomendamos una función de replicación. Secrets Manager asume la función y la utiliza como identidad única para las operaciones de clave de cifrado. Para conocer los dos enfoques que puede utilizar Secrets Manager, consulte Cómo autoriza Secrets Manager la replicación entre cuentas.
Restricción de réplica
La restricción de réplicas es un parámetro del AssociateCrossAccountReplica operación. Este parámetro controla si Secrets Manager bloquea la replicación a una réplica secreta ajena a su AWS organización.
De forma predeterminada, la restricción de réplicas es SameOrg, que requiere que ambas cuentas estén en la misma AWS organización. Para permitir la replicación fuera de su AWS organización, defina la restricción en NoRestriction.
Secrets Manager aplica la restricción de réplicas solo durante la asociación inicial. Llamando AssociateCrossAccountReplica de nuevo con un valor de restricción diferente no cambia una asociación existente.
Si la cuenta de réplica no cumple con la restricción, Secrets Manager devuelve un AccessDeniedException en la interna AcceptCrossAccountReplication llamada.
AWS CLI
Desde la cuenta principal, ejecuta AssociateCrossAccountReplica.
ejemplo Asocia la réplica con el secreto 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" }
ejemplo La restricción de réplicas deniega una réplica fuera del AWS organización
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
Para replicar en una cuenta ajena a su AWS organización, agrega --replica-restriction NoRestriction.
La replicación es asincrónica. Llame DescribeSecret periódicamente y compruebe el ReplicationStatus campo hasta que aparezca InSync.
ejemplo Compruebe el estado de replicación
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" } ] }
Para obtener más información acerca de los campos de estado de replicación, consulte Supervise la replicación entre cuentas.
AWS SDK
Para asociar la réplica al secreto principal, utilice el AssociateCrossAccountReplica comando. Para obtener más información, consulte AWS SDK.