

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.

# Replicación AWS Secrets Manager secretos en todas las cuentas

Cross-account la replicación le permite replicar valores secretos de un *primaria* secreto para un nuevo *réplica* secreto en una forma diferente AWS cuenta. El secreto de la réplica es un secreto independiente que tiene sus propias políticas de acceso, clave de KMS y ciclo de vida. Cuando el valor secreto del secreto principal cambia, Secrets Manager propaga el nuevo valor al secreto de la réplica. Cross-account la replicación es útil cuando se quiere usar el mismo valor secreto en varias cuentas y administrar el secreto por separado en cada cuenta.

Cross-account la replicación implica dos AWS cuentas: las *cuenta principal* que posee el secreto principal, y *cuenta de réplica* que guarda el secreto de la réplica. Ambos secretos deben estar en el mismo lugar AWS Región.

Para obtener información sobre precios para secretos de réplica, consulte [Precios de AWS Secrets Manager](https://aws.amazon.com/secrets-manager/pricing/).

**Topics**
+ [Cómo funciona la replicación entre cuentas](#cross-account-replicate-secrets_model)
+ [Estado de la replicación](#cross-account-replicate-secrets_status)
+ [Restricciones](#cross-account-replicate-secrets_constraints)
+ [Qué replica Secrets Manager](#cross-account-replicate-secrets_whatreplicates)
+ [Crea un secreto de réplica](cross-account-replicate-create.md)
+ [Asociar la réplica a un secreto principal](cross-account-replicate-associate.md)
+ [Cómo autoriza Secrets Manager la replicación entre cuentas](cross-account-replicate-permissions.md)
+ [Supervise la replicación entre cuentas](cross-account-replicate-status.md)
+ [Detenga la replicación entre cuentas](cross-account-replicate-remove.md)

## Cómo funciona la replicación entre cuentas
<a name="cross-account-replicate-secrets_model"></a>

Cross-account la replicación es un proceso bipartidista. Participan ambos propietarios de la cuenta:
+ El *propietario de la cuenta de réplica* crea el secreto de la réplica, establece los permisos necesarios y lo configura para que haga referencia al secreto principal.
+ El *propietario de la cuenta principal* asocia la réplica con el secreto principal. Esta asociación inicia la replicación del secreto principal al secreto de la réplica.

La replicación es asincrónica y, en última instancia, coherente. Una vez que el propietario de la cuenta principal asocia la réplica, Secrets Manager copia el valor secreto en segundo plano, por lo que es posible que la réplica no refleje el valor más reciente de forma inmediata. Para realizar un seguimiento del progreso, llama [`DescribeSecret`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_DescribeSecret.html) y compruebe el estado de la replicación. Para obtener más información, consulte [Supervise la replicación entre cuentas](cross-account-replicate-status.md).

## Estado de la replicación
<a name="cross-account-replicate-secrets_status"></a>

Cada secreto informa de un estado de replicación que pasa por los siguientes valores a medida que avanza la replicación:

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. Este es el estado estable de una réplica en buen estado.

Con error  
Secrets Manager no pudo completar la replicación. El mensaje de estado describe la causa. Para saber cómo recuperarse, consulte [Supervise la replicación entre cuentas](cross-account-replicate-status.md).

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.

## Restricciones
<a name="cross-account-replicate-secrets_constraints"></a>

Cross-account la replicación tiene las siguientes restricciones:
+ **Misma región** — El secreto principal y el secreto de la réplica deben estar en la misma AWS Región.
+ **Una réplica por primaria** — Un secreto principal puede tener como máximo una réplica multicuenta. Si ya existe una réplica, se produce un error en la solicitud para asociar otra réplica.
+ **Se requiere una clave gestionada por el cliente** — Debe cifrar el secreto de la réplica con una clave de KMS administrada por el cliente. La réplica no puede usar la Clave administrada de AWS `aws/secretsmanager`. Para obtener más información, consulte [Crea un secreto de réplica](cross-account-replicate-create.md).

## Qué replica Secrets Manager
<a name="cross-account-replicate-secrets_whatreplicates"></a>

Secrets Manager replica lo siguiente desde el secreto principal hasta la réplica:
+ El valor secreto y sus datos de versión
+ La descripción secreta
+ El tipo secreto
+ Los mapeos de las etiquetas de versión y fase

Secrets Manager no replica lo siguiente. Cada cuenta administra la suya propia:
+ Tags
+ Política de recursos
+ Clave de KMS