

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](cross-account-replicate-create.md).

## Cómo funciona la asociación
<a name="cross-account-replicate-associate_how"></a>

El propietario de la cuenta principal ejecuta [`AssociateCrossAccountReplica`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_AssociateCrossAccountReplica.html) 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
<a name="cross-account-replicate-associate_accept"></a>

`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
<a name="cross-account-replicate-associate_permissions"></a>

La identidad que asocia la réplica necesita los siguientes permisos:
+ `secretsmanager:AssociateCrossAccountReplica` en el secreto principal.
+ `secretsmanager:GetSecretValue` sobre el secreto principal.
+ `secretsmanager:AcceptCrossAccountReplication` en el secreto de la réplica.
+ `kms:Decrypt` en la clave KMS del secreto principal.
+ `kms:Encrypt` en 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
<a name="cross-account-replicate-associate_permissions-for-replication"></a>

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](cross-account-replicate-permissions.md).

## Restricción de réplica
<a name="cross-account-replicate-associate_restriction"></a>

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`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_AssociateCrossAccountReplica.html) 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
<a name="cross-account-replicate-associate_CLI"></a>

Desde la cuenta principal, ejecuta [`AssociateCrossAccountReplica`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_AssociateCrossAccountReplica.html).

**Example 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"
}
```

**Example 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`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_DescribeSecret.html) periódicamente y compruebe el `ReplicationStatus` campo hasta que aparezca `InSync`.

**Example 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](cross-account-replicate-status.md).

## AWS SDK
<a name="cross-account-replicate-associate_SDK"></a>

Para asociar la réplica al secreto principal, utilice el [`AssociateCrossAccountReplica`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_AssociateCrossAccountReplica.html) comando. Para obtener más información, consulte [AWS SDK](asm_access.md#asm-sdks).