

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Associez la réplique à un secret principal

Une fois que le propriétaire du compte de réplication a créé le secret de réplication, le propriétaire du compte principal associe le réplica au secret principal pour démarrer la réplication. Pour savoir comment créer le secret de réplique, voir [Créer un secret de réplique](cross-account-replicate-create.md).

## Fonctionnement de l’association
<a name="cross-account-replicate-associate_how"></a>

Le titulaire principal du compte gère [`AssociateCrossAccountReplica`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_AssociateCrossAccountReplica.html) avec `SecretId` pour le secret principal et `CrossAccountReplicaARN` pour la réplique secrète.

Lors de l'association, Secrets Manager effectue les opérations suivantes :
+ Effectue un fonctionnement à sec AWS KMS contrôles d'autorisation sur les clés KMS du secret principal et de la clé secrète de réplication.
+ Configure les métadonnées de réplication pour le secret principal et le secret de réplication.
+ Déclenche le processus de réplication pour commencer à répliquer les données du secret principal vers le secret de réplication.

### AcceptCrossAccountReplication
<a name="cross-account-replicate-associate_accept"></a>

`AcceptCrossAccountReplication` est une opération interne uniquement que Secrets Manager appelle dans `AssociateCrossAccountReplica`. Cette opération agit sur le secret de la réplique en utilisant l'identité du `AssociateCrossAccountReplica` appelant.

Le `AcceptCrossAccountReplication` call effectue le fonctionnement à sec `kms:Encrypt` vérifie la clé KMS du secret de réplication et met à jour les métadonnées de réplication du secret de réplication. Seulement après `AcceptCrossAccountReplication` réussit `AssociateCrossAccountReplica` mettre à jour les métadonnées de réplication sur le secret principal.

## Autorisations pour associer un réplica
<a name="cross-account-replicate-associate_permissions"></a>

L'identité qui associe le réplica nécessite les autorisations suivantes :
+ `secretsmanager:AssociateCrossAccountReplica` sur le secret principal.
+ `secretsmanager:GetSecretValue` sur le secret principal.
+ `secretsmanager:AcceptCrossAccountReplication` sur la réplique secrète.
+ `kms:Decrypt` sur la clé KMS du secret principal.
+ `kms:Encrypt` sur la clé KMS de la réplique secrète (compte croisé).

Si vous passez un rôle de réplication avec `ReplicationRoleARN`, l'appelant doit également `iam:PassRole` pour ce rôle.

## Autorisations pour la réplication
<a name="cross-account-replicate-associate_permissions-for-replication"></a>

Pour satisfaire le multicompte `kms:Encrypt` sans donner à chaque appelant un accès intercompte à la clé de réplication, nous recommandons un rôle de réplication. Secrets Manager assume le rôle et l'utilise comme identité unique pour les opérations relatives aux clés de chiffrement. Pour les deux approches que Secrets Manager peut utiliser, voir [Comment Secrets Manager autorise la réplication entre comptes](cross-account-replicate-permissions.md).

## Restriction en matière
<a name="cross-account-replicate-associate_restriction"></a>

La restriction de réplication est un paramètre de `AssociateCrossAccountReplica` opération. Ce paramètre contrôle si Secrets Manager bloque la réplication vers un secret de réplication extérieur à votre AWS organisation.

Par défaut, la restriction de réplication est `SameOrg`, ce qui nécessite que les deux comptes soient dans le même AWS organisation. Pour autoriser la réplication en dehors de votre AWS organisation, définissez la restriction sur `NoRestriction`.

Secrets Manager applique la restriction de réplication uniquement lors de l'association initiale. Appel [`AssociateCrossAccountReplica`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_AssociateCrossAccountReplica.html) toujours avec une valeur de restriction différente, cela ne modifie pas une association existante.

Si le compte de réplication ne répond pas à la restriction, Secrets Manager renvoie un `AccessDeniedException` sur l'intérieur `AcceptCrossAccountReplication` appel.

## AWS CLI
<a name="cross-account-replicate-associate_CLI"></a>

Depuis le compte principal, exécutez [`AssociateCrossAccountReplica`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_AssociateCrossAccountReplica.html).

**Example Associez la réplique au secret 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 restriction de réplication refuse une réplique en dehors de AWS organization**  

```
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
```

Pour effectuer une réplication vers un compte autre que votre AWS organisation, ajouter `--replica-restriction NoRestriction`.

La réplication est asynchrone. Appel [`DescribeSecret`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_DescribeSecret.html) périodiquement et vérifiez les `ReplicationStatus` champ jusqu'à ce qu'il apparaisse `InSync`.

**Example Vérifiez l'état de la réplication**  

```
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"
        }
    ]
}
```

Pour plus d'informations sur les champs d'état de réplication, voir [Surveillez la réplication entre comptes](cross-account-replicate-status.md).

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

Pour associer la réplique au secret principal, utilisez [`AssociateCrossAccountReplica`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_AssociateCrossAccountReplica.html) commande. Pour plus d'informations, consultez [AWS Kits SDK](asm_access.md#asm-sdks).