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 périodiquement depuis l'un ou l'autre de vos comptes et vérifiez les ReplicationStatus champ.
Champs d'état de réplication
Les domaines qui DescribeSecret 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 contientPrimarySecretARN,ReplicationStatus, etStatusMessage. -
Lorsque vous décrivez primaire secret, Secrets Manager revient
CrossAccountReplicas, une liste dans laquelle chaque entrée contientReplicaSecretARN,ReplicationRoleARN,ReplicationStatus, etStatusMessage.
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
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.
- 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.
Déterminer la cause de l'échec de la réplication
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:Decryptsur la clé KMS principale oukms:Encryptsur 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.
Exemple StatusMessage valeurs
Les exemples suivants montrent des exemples courants StatusMessage valeurs pour les réplications ayant échoué.
Exemple 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)
Exemple 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)
Exemple 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
Une fois les autorisations corrigées, le propriétaire principal du compte appelle AssociateCrossAccountReplica à 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.
Exemple 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