View a markdown version of this page

Supervise la replicación entre cuentas - AWS Secrets Manager

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.

Supervise la replicación entre cuentas

Cross-account la replicación es asincrónica. Para monitorear el progreso, llame DescribeSecret periódicamente desde cualquiera de las dos cuentas y comprueba la ReplicationStatus campo.

Campos de estado de replicación

Los campos que DescribeSecret las devoluciones dependen de si se describe la réplica o el secreto principal:

  • Cuando describas el réplica secreto, Secrets Manager regresa CrossAccountPrimary, que contiene PrimarySecretARN, ReplicationStatus, y StatusMessage.

  • Cuando describes el primaria secreto, vuelve Secrets Manager CrossAccountReplicas, una lista en la que cada entrada contiene ReplicaSecretARN, ReplicationRoleARN, ReplicationStatus, y StatusMessage.

El StatusMessage El campo proporciona detalles cuando la replicación falla o se detiene, por ejemplo, cuando AWS KMS falta el permiso clave.

Valores de estado de la replicación

El ReplicationStatus el campo indica uno de los valores siguientes:

Pendiente

Secrets Manager ha registrado la relación de replicación, pero aún no ha empezado a copiar el valor secreto. Solo el secreto de la réplica muestra este estado.

InProgress

Secrets Manager está copiando el valor secreto del principal a la réplica.

InSync

La réplica tiene el mismo valor secreto que la principal.

Con error

Secrets Manager no pudo completar la replicación. Consulte Determine la causa de un error en la replicación.

Desconectado

Una de las dos cuentas detuvo la replicación, por lo que los secretos principales y de réplica ya no están vinculados. Para obtener más información, consulte Detenga la replicación entre cuentas.

Determine la causa de un error en la replicación

A Failed el estado significa que Secrets Manager no pudo completar la replicación. Revise el StatusMessage para determinar por qué falló la replicación; contiene información adicional sobre la causa. Los motivos más comunes por los que se produce un error en la replicación están relacionados con la autorización. Estos errores suelen ser uno de los siguientes:

  • Secrets Manager no tiene permiso para llamar kms:Decrypt en la clave KMS principal o kms:Encrypt en la clave de KMS de réplica.

  • Secrets Manager no puede asumir la función de replicación.

Para AWS KMS fallos, revise el StatusMessage para identificar el origen del fallo. Si utiliza una sesión de acceso directo (FAS) en lugar de una función de replicación, compruebe que la identidad de la persona que llama cumple con los requisitos kms:Decrypt y kms:Encrypt permisos. Para obtener más información acerca de los permisos que requiere la replicación, consulte Cómo autoriza Secrets Manager la replicación entre cuentas.

Ejemplo StatusMessage valora

Los siguientes ejemplos muestran los valores comunes StatusMessage valores para réplicas fallidas.

ejemplo KMS:Se ha denegado el descifrado de la clave del secreto principal
Replication failed: User: arn:aws:sts::111122223333:assumed-role/CrossAccountReplicationRole-1234567890123456789/SecretsManagerCrossAccountReplication-444455556666 is not authorized to perform: kms:Decrypt on resource: arn:aws:kms:us-west-2:111122223333:key/a8c8999a-a026-4df3-a42a-d0972222fe36 because no resource-based policy allows the kms:Decrypt action (Service: AWSKMS; Status Code: 400; Error Code: AccessDeniedException; Request ID: 12345678-1234-1234-1234-123456781234; Proxy: null)
ejemplo KMS:Se ha denegado el cifrado de la clave del secreto de la réplica
Replication failed: User: arn:aws:sts::111122223333:assumed-role/CrossAccountReplicationRole-9876543210987654321/SecretsManagerCrossAccountReplication-444455556666 is not authorized to perform: kms:Encrypt on this resource because the resource does not exist in this Region, no resource-based policies allow access, or a resource-based policy explicitly denies access (Service: AWSKMS; Status Code: 400; Error Code: AccessDeniedException; Request ID: 87654321-4321-4321-4321-aaaabbbbcccc; Proxy: null)
ejemplo No se puede asumir la función de replicación
Replication failed: Secrets Manager failed to assume role arn:aws:iam::111122223333:role/CrossAccountReplicationRole

Recupérese de una replicación fallida

Después de corregir los permisos, el propietario de la cuenta principal llama AssociateCrossAccountReplica nuevamente para que la misma réplica vuelva a intentar la replicación. Esta llamada no corrige los permisos; solo vuelve a activar el intento de replicación. Si persisten los problemas de permisos, Secrets Manager actualizará el StatusMessage. Cuando se resuelvan todos los problemas de permisos, la replicación finaliza y el estado cambia a InSync.

ejemplo Vuelva a intentar una replicación fallida
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