

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.

# Surveillez la réplication entre comptes

Cross-account la réplication est asynchrone. Pour suivre les progrès, appelez [`DescribeSecret`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_DescribeSecret.html) périodiquement depuis l'un ou l'autre de vos comptes et vérifiez les `ReplicationStatus` champ.

## Champs d'état de réplication
<a name="cross-account-replicate-status_fields"></a>

Les domaines qui [`DescribeSecret`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_DescribeSecret.html) les retours varient selon que vous décrivez la réplique ou le secret principal :
+ Lorsque vous décrivez *réplique* secret, Secrets Manager revient `CrossAccountPrimary`, qui contient `PrimarySecretARN`, `ReplicationStatus`, et `StatusMessage`.
+ Lorsque vous décrivez *primaire* secret, Secrets Manager revient `CrossAccountReplicas`, une liste dans laquelle chaque entrée contient `ReplicaSecretARN`, `ReplicationRoleARN`, `ReplicationStatus`, et `StatusMessage`.

Le `StatusMessage` le champ fournit des informations en cas d'échec ou de blocage de la réplication, par exemple lorsqu'un AWS KMS l'autorisation clé est manquante.

## Valeurs d'état de réplication
<a name="cross-account-replicate-status_values"></a>

Le `ReplicationStatus` Le champ indique l'une des valeurs suivantes :

En attente  
Secrets Manager a enregistré la relation de réplication mais n'a pas encore commencé à copier la valeur secrète. Seul le secret de la réplique indique ce statut.

InProgress  
Secrets Manager copie la valeur secrète du serveur principal vers la réplique.

InSync  
La réplique possède la même valeur secrète que la principale.

Échec  
Secrets Manager n'a pas pu terminer la réplication. Consultez [Déterminer la cause de l'échec de la réplication](#cross-account-replicate-status_cause).

Detached  
L'un des deux comptes a arrêté la réplication, de sorte que le secret principal et le secret de réplication ne sont plus liés. Pour plus d’informations, consultez [Arrêtez la réplication entre comptes](cross-account-replicate-remove.md).

## Déterminer la cause de l'échec de la réplication
<a name="cross-account-replicate-status_cause"></a>

UNE `Failed` l'état signifie que Secrets Manager n'a pas pu terminer la réplication. Passez en revue le `StatusMessage` pour déterminer pourquoi la réplication a échoué ; il contient des informations supplémentaires sur la cause. Les raisons les plus courantes d'échec de la réplication sont liées à l'autorisation. Ces défaillances sont généralement l'une des suivantes :
+ Secrets Manager n'est pas autorisé à appeler `kms:Decrypt` sur la clé KMS principale ou `kms:Encrypt` sur la réplique de la clé KMS.
+ Secrets Manager n'est pas en mesure d'assumer le rôle de réplication.

Pour AWS KMS échecs, passez en revue les `StatusMessage` pour identifier la source de la panne. Si vous utilisez une session d'accès direct (FAS) au lieu d'un rôle de réplication, vérifiez que l'identité de l'appelant possède les informations requises `kms:Decrypt` et `kms:Encrypt` autorisations. Pour plus d'informations sur les autorisations requises pour la réplication, consultez [Comment Secrets Manager autorise la réplication entre comptes](cross-account-replicate-permissions.md).

### Exemple StatusMessage valeurs
<a name="cross-account-replicate-status_statusmessage-examples"></a>

Les exemples suivants montrent des exemples courants `StatusMessage` valeurs pour les réplications ayant échoué.

**Example KMS : Déchiffrement refusé sur la clé du secret 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)
```

**Example KMS : Chiffrement refusé sur la clé secrète de la réplique**  

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

**Example Impossible d'assumer le rôle de réplication**  

```
Replication failed: Secrets Manager failed to assume role arn:aws:iam::111122223333:role/CrossAccountReplicationRole
```

## Restaurer après un échec de réplication
<a name="cross-account-replicate-status_failed"></a>

Une fois les autorisations corrigées, le propriétaire principal du compte appelle [`AssociateCrossAccountReplica`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_AssociateCrossAccountReplica.html) à nouveau pour la même réplique afin de réessayer la réplication. Cet appel ne fixe pas les autorisations ; il ne fait que relancer la tentative de réplication. Si les problèmes d'autorisation persistent, Secrets Manager mettra à jour le `StatusMessage`. Lorsque tous les problèmes d'autorisation sont résolus, la réplication est terminée et le statut passe à `InSync`.

**Example Réessayer une réplication qui a échoué**  

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