View a markdown version of this page

Ordnen Sie das Replikat einem primären Schlüssel zu - 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.

Ordnen Sie das Replikat einem primären Schlüssel zu

Nachdem der Besitzer des Replikatkontos das Replikatgeheimnis erstellt hat, ordnet der Besitzer des primären Kontos das Replikat dem primären Schlüssel zu, um die Replikation zu starten. Informationen zum Erstellen des Replikatgeheimnisses finden Sie unter Erstellen Sie ein Replikatgeheimnis.

Funktionsweise der Zuordnung

Der Hauptkontoinhaber läuft AssociateCrossAccountReplica mit SecretId für das primäre Geheimnis und CrossAccountReplicaARN für das Replikatgeheimnis.

Während der Verknüpfung führt Secrets Manager Folgendes aus:

  • Führt einen Trockenlauf durch AWS KMS Berechtigungsprüfungen sowohl für den KMS-Schlüssel als auch für den geheimen Replikatschlüssel.

  • Legt die Replikationsmetadaten sowohl für das Primär- als auch für das Replikatgeheimnis fest.

  • Löst den Replikationsprozess aus, um mit der Replikation von Daten vom primären Schlüssel zum Replikatgeheimnis zu beginnen.

AcceptCrossAccountReplication

AcceptCrossAccountReplication ist eine rein interne Operation, die Secrets Manager innerhalb von Secrets Manager aufruft AssociateCrossAccountReplica. Dieser Vorgang wirkt sich auf das Replikatgeheimnis aus und verwendet dabei die Identität des AssociateCrossAccountReplica Anrufer.

Der AcceptCrossAccountReplication Der Anruf führt den Probelauf durch kms:Encrypt überprüft den KMS-Schlüssel des Replikatgeheimnisses und aktualisiert die Replikationsmetadaten des Replikationsgeheimnisses. Erst danach AcceptCrossAccountReplication ist erfolgreich AssociateCrossAccountReplica aktualisiert die Replikationsmetadaten für das primäre Geheimnis.

Berechtigungen zum Zuordnen eines Replikats

Die Identität, die das Replikat verknüpft, benötigt die folgenden Berechtigungen:

  • secretsmanager:AssociateCrossAccountReplica für das primäre Geheimnis.

  • secretsmanager:GetSecretValue auf dem primären Geheimnis.

  • secretsmanager:AcceptCrossAccountReplication auf dem Replikatgeheimnis.

  • kms:Decrypt auf dem KMS-Schlüssel des primären Geheimnisses.

  • kms:Encrypt auf dem KMS-Schlüssel des Replikatgeheimnisses (kontoübergreifend).

Wenn Sie eine Replikationsrolle mit übergeben ReplicationRoleARN, benötigt der Anrufer außerdem iam:PassRole für diese Rolle.

Berechtigungen für die Replikation

Um den Anforderungen des Cros-Accounts gerecht zu werden kms:Encrypt Wir empfehlen eine Replikationsrolle, ohne jedem Anrufer kontoübergreifenden Zugriff auf den Replikatschlüssel zu gewähren. Secrets Manager übernimmt die Rolle und verwendet sie als einzige Identität für die Verschlüsselungsschlüsseloperationen. Informationen zu den beiden Ansätzen, die Secrets Manager verwenden kann, finden Sie unter Wie Secrets Manager die kontoübergreifende Replikation autorisiert.

Beschränkung auf Replikate

Die Replikatbeschränkung ist ein Parameter des AssociateCrossAccountReplica Betrieb. Dieser Parameter steuert, ob Secrets Manager die Replikation auf ein Replikatgeheimnis außerhalb Ihres blockiert AWS Organisation.

In der Standardeinstellung lautet die Replikatbeschränkung SameOrg, was voraussetzt, dass sich beide Konten im selben Konto befinden AWS Organisation. Um eine Replikation außerhalb Ihrer zu ermöglichen AWS Organisation, setzen Sie die Einschränkung auf NoRestriction.

Secrets Manager erzwingt die Replikatbeschränkung nur während der ersten Zuordnung. Anrufen AssociateCrossAccountReplica Ein erneuter Einschränkungswert ändert nichts an einer bestehenden Zuordnung.

Wenn das Replikatkonto die Einschränkung nicht erfüllt, gibt Secrets Manager eine AccessDeniedException auf der internen AcceptCrossAccountReplication anrufen.

AWS CLI

Führen Sie vom Hauptkonto aus AssociateCrossAccountReplica.

Beispiel Ordnen Sie das Replikat dem primären Schlüssel zu
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" }
Beispiel Die Replikatbeschränkung verwehrt ein Replikat außerhalb von AWS Organisation
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

Um es auf ein Konto außerhalb Ihres zu replizieren AWS Organisation, füge hinzu --replica-restriction NoRestriction.

Die Replikation erfolgt asynchron. Rufen Sie an DescribeSecret regelmäßig und überprüfe das ReplicationStatus Feld bis es angezeigt wird InSync.

BeispielÜberprüfen Sie den Replikationsstatus
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" } ] }

Weitere Informationen zu den Feldern für den Replikationsstatus finden Sie unter Überwachen Sie die kontoübergreifende Replikation.

AWS SDK

Um das Replikat mit dem primären Schlüssel zu verknüpfen, verwenden Sie den AssociateCrossAccountReplica Befehl. Weitere Informationen finden Sie unter AWS SDKs.