View a markdown version of this page

Überwachen Sie die kontoübergreifende Replikation - AWS Secrets Manager

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Überwachen Sie die kontoübergreifende Replikation

Cross-account Die Replikation erfolgt asynchron. Um den Fortschritt zu überwachen, rufen Sie DescribeSecret regelmäßig von einem der beiden Konten aus und überprüfen Sie das ReplicationStatus Feld.

Felder für den Replikationsstatus

Die Felder, die DescribeSecret Die Ergebnisse hängen davon ab, ob Sie das Replikat oder das primäre Geheimnis beschreiben:

  • Wenn Sie das beschreiben Replik geheim, Secrets Manager kehrt zurück CrossAccountPrimary, das beinhaltet PrimarySecretARN, ReplicationStatus, und StatusMessage.

  • Wenn du das beschreibst primär geheim, Secrets Manager kehrt zurück CrossAccountReplicas, eine Liste, in der jeder Eintrag Folgendes enthält ReplicaSecretARN, ReplicationRoleARN, ReplicationStatus, und StatusMessage.

Das StatusMessage Das Feld enthält Details, wenn die Replikation fehlschlägt oder zum Stillstand kommt, z. B. wenn ein AWS KMS Die Schlüsselberechtigung fehlt.

Werte für den Replikationsstatus

Die ReplicationStatus Feld meldet einen der folgenden Werte:

Ausstehend

Secrets Manager hat die Replikationsbeziehung aufgezeichnet, aber noch nicht mit dem Kopieren des Geheimwerts begonnen. Nur das Replikatgeheimnis zeigt diesen Status an.

InProgress

Secrets Manager kopiert den geheimen Wert vom Primärwert in das Replikat.

InSync

Das Replikat enthält denselben geheimen Wert wie das primäre Replikat.

Fehlgeschlagen

Secrets Manager konnte die Replikation nicht abschließen. Siehe Ermitteln Sie die Ursache einer fehlgeschlagenen Replikation.

Detached (Getrennt)

Eines der beiden Konten hat die Replikation gestoppt, sodass das primäre und das Replikatgeheimnis nicht mehr verknüpft sind. Weitere Informationen finden Sie unter Kontoübergreifende Replikation beenden.

Ermitteln Sie die Ursache einer fehlgeschlagenen Replikation

A Failed Status bedeutet, dass Secrets Manager die Replikation nicht abschließen konnte. Überprüfen Sie den StatusMessage um zu ermitteln, warum die Replikation fehlgeschlagen ist; es enthält zusätzliche Informationen zur Ursache. Die häufigsten Gründe dafür, dass die Replikation fehlschlägt, hängen mit der Autorisierung zusammen. Bei diesen Fehlern handelt es sich in der Regel um eine der folgenden Ursachen:

  • Secrets Manager ist nicht berechtigt, anzurufen kms:Decrypt auf dem primären KMS-Schlüssel oder kms:Encrypt auf dem Replikat-KMS-Schlüssel.

  • Secrets Manager kann die Replikationsrolle nicht übernehmen.

Für AWS KMS Fehler, überprüfen Sie das StatusMessage um die Ursache des Fehlers zu identifizieren. Wenn Sie eine Forward-Access-Sitzung (FAS) anstelle einer Replikationsrolle verwenden, stellen Sie sicher, dass die Identität des Anrufers die erforderliche kms:Decrypt und kms:Encrypt Genehmigungen. Weitere Informationen zu den Berechtigungen, die für die Replikation erforderlich sind, finden Sie unter Wie Secrets Manager die kontoübergreifende Replikation autorisiert.

Beispiel StatusMessage Werte

Die folgenden Beispiele zeigen Gemeinsamkeiten StatusMessage Werte für fehlgeschlagene Replikationen.

Beispiel kms:Decrypt mit dem Schlüssel des primären Geheimnisses verweigert
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)
Beispiel kms:Die Verschlüsselung wurde für den Schlüssel des Replikatgeheimnisses verweigert
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)
Beispiel Die Replikationsrolle kann nicht übernommen werden
Replication failed: Secrets Manager failed to assume role arn:aws:iam::111122223333:role/CrossAccountReplicationRole

Nach einer fehlgeschlagenen Replikation wiederherstellen

Nachdem Sie die Berechtigungen korrigiert haben, ruft der Inhaber des primären Kontos an AssociateCrossAccountReplica erneut für dasselbe Replikat, um die Replikation erneut zu versuchen. Durch diesen Aufruf werden die Berechtigungen nicht korrigiert; er löst lediglich den Replikationsversuch erneut aus. Wenn weiterhin Berechtigungsprobleme bestehen, aktualisiert Secrets Manager das StatusMessage. Wenn alle Berechtigungsprobleme behoben sind, wird die Replikation abgeschlossen und der Status ändert sich zu InSync.

Beispiel Versuchen Sie eine fehlgeschlagene Replikation erneut
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