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 contienePrimarySecretARN,ReplicationStatus, yStatusMessage. -
Cuando describes el primaria secreto, vuelve Secrets Manager
CrossAccountReplicas, una lista en la que cada entrada contieneReplicaSecretARN,ReplicationRoleARN,ReplicationStatus, yStatusMessage.
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:Decrypten la clave KMS principal okms:Encrypten 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