View a markdown version of this page

Wie Secrets Manager die kontoübergreifende Replikation autorisiert - 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.

Wie Secrets Manager die kontoübergreifende Replikation autorisiert

Jedes Mal, wenn Secrets Manager einen geheimen Wert repliziert, entschlüsselt es den Wert mit dem KMS-Schlüssel des primären Geheimnisses und verschlüsselt ihn erneut mit dem KMS-Schlüssel des Replikatgeheimnisses. Secrets Manager benötigt eine für beide Operationen autorisierte Identität. Sie wählen die Identität: eine Replikationsrolle, die Secrets Manager übernimmt, oder die eigene Identität des Anrufers in einer Forward Access Session (FAS). In diesem Thema werden beide Ansätze erläutert.

Wie wird die Replikation ausgelöst

Secrets Manager hält das Replikat synchron, indem jede Änderung am primären geheimen Wert repliziert wird. Zum Beispiel, wenn Sie anrufen PutSecretValue Auf dem primären Schlüssel erstellt Secrets Manager die neue Version und verschiebt die AWSCURRENT Staging-Label darauf und repliziert dann die Version auf das Replikat. Die Replikation erfolgt asynchron und letztlich konsistent, sodass das Replikat möglicherweise nicht sofort den neuesten Wert wiedergibt. Informationen zum Verfolgen des Fortschritts finden Sie unter Überwachen Sie die kontoübergreifende Replikation.

Bei der Replikation werden zwei ausgeführt AWS KMS Operationen

Um einen geheimen Wert vom Primärwert zum Replikat zu verschieben, führt Secrets Manager die folgenden beiden Schritte aus AWS KMS Operationen in der richtigen Reihenfolge:

  1. Entschlüsseln — Secrets Manager ruft an kms:Decrypt mit dem KMS-Schlüssel des primären Geheimnisses, um den Datenschlüssel zu entschlüsseln, der den geheimen Wert schützt.

  2. Verschlüsseln — Secrets Manager ruft an kms:Encrypt mit dem KMS-Schlüssel des Replikatgeheimnisses, um den Datenschlüssel für die Speicherung im Replikat erneut zu verschlüsseln.

Da sich die beiden KMS-Schlüssel in unterschiedlichen Konten befinden, muss die Schlüsselrichtlinie des Replikatschlüssels das Konto des primären Geheimnisses zum Aufrufen berechtigen kms:Encrypt. Sie können den Geltungsbereich dieser Richtlinie mithilfe des SecretArn-Verschlüsselungskontexts festlegen, um die Verwendung auf den geheimen Replikatschlüssel zu beschränken. Die wichtigsten Grundsatzerklärungen finden Sie unter Erstellen Sie ein Replikatgeheimnis. Weitere Informationen darüber, wie Secrets Manager KMS-Schlüssel und den Verschlüsselungskontext bei der Replikation verwendet, finden Sie unter AWS KMS Schlüssel für die kontoübergreifende Replikation.

Wichtig

Eine Resource Control Policy (RCP) auf Organisationsebene oder eine Service Control Policy (SCP) kann diese blockieren AWS KMS Operationen, auch wenn die Identitäts- und Schlüsselrichtlinien dies zulassen.

Wählen Sie aus, wie Secrets Manager die Berechtigungen erhält

Der Unterschied zwischen den beiden Ansätzen ist die Identität, die Secrets Manager verwendet, um die beiden zu erstellen AWS KMS Anrufe.

Rolle „Replikation“ (empfohlen)

Wenn Sie eine Replikationsrolle angeben, geht Secrets Manager von dieser IAM-Rolle aus und verwendet sie als Identität für beide AWS KMS Anrufe. Secrets Manager verwendet die Rolle zum Aufrufen kms:Decrypt auf dem KMS-Schlüssel des primären Geheimnisses und kms:Encrypt auf dem KMS-Schlüssel des Replikatgeheimnisses. Da die Rolle über die kontoübergreifenden Berechtigungen verfügt, können einzelne Anrufer von PutSecretValue benötigen nicht alle Accountübergreifend AWS KMS Berechtigungen. Bei diesem Ansatz muss das primäre Geheimnis einen vom Kunden verwalteten KMS-Schlüssel verwenden.

Informationen zum Einrichten der Rolle, ihrer Vertrauensrichtlinie und ihrer Berechtigungsrichtlinie finden Sie unter Richten Sie die Replikationsdienstrolle ein.

Forward Access Sessions

EIN Sitzung mit weiterleitendem Zugriff (FAS) ermöglicht es Secrets Manager, Downstream-API-Aufrufe mithilfe der Berechtigungen der Identität durchzuführen, die den Vorgang ausgelöst hat. Wenn Sie keine Replikationsrolle angeben, verwendet Secrets Manager eine Forward-Access-Sitzung: Es erstellt die beiden AWS KMS Aufrufe unter der Identität, die den auslösenden Vorgang aufgerufen hat, zum Beispiel PutSecretValue.

Anmerkung

Bei einer Forward-Access-Sitzung wird die erste Replikation unter Verwendung der Identität durchgeführt, die aufgerufen hat AssociateCrossAccountReplica.

Bei diesem Ansatz muss die auslösende Identität über die beiden folgenden Berechtigungen verfügen:

  • kms:Decrypt auf dem KMS-Schlüssel des primären Geheimnisses. Dieser Schlüssel befindet sich im selben Konto wie der Anrufer, sodass der Anrufer diese Berechtigung normalerweise bereits besitzt.

  • kms:Encrypt auf dem KMS-Schlüssel des Replikatgeheimnisses. Dieser Schlüssel befindet sich im Replikatkonto, sodass der Anrufer eine kontoübergreifende Zugriffsberechtigung benötigt. FAS macht es schwieriger, diese Anforderung zu erfüllen.

Wenn die auslösende Identität entweder fehlt AWS KMS Genehmigung, die Replikation kann nicht abgeschlossen werden und der Replikationsstatus lautet Failed. Informationen zum Lesen des Status und zur Wiederherstellung finden Sie unter Überwachen Sie die kontoübergreifende Replikation.

Die folgende Identitätsrichtlinie ermöglicht eine PutSecretValue Anrufer, um das Cross-Konto zu verwenden kms:Encrypt Genehmigung, die es für den KMS-Schlüssel des Replikatgeheimnisses benötigt. Die Anweisung ist auf den SecretarN-Verschlüsselungskontext beschränkt, sodass die Identität den KMS-Schlüssel des Replikatgeheimnisses nur für das Replikatgeheimnis verwenden kann. Hängen Sie eine Richtlinie wie diese an die Identität an, die aufruft PutSecretValue auf dem primären Geheimnis.

Beispiel Identitätsrichtlinie, nach der ein Anrufer unter dem KMS-Schlüssel des Replikatgeheimnisses verschlüsselt
{ "Version": "2012-10-17", "Statement": [ { "Sid": "EncryptReplicaSecretKey", "Effect": "Allow", "Action": "kms:Encrypt", "Resource": "arn:aws:kms:us-east-2:444455556666:key/replica-key-id", "Condition": { "StringEquals": { "kms:EncryptionContext:SecretARN": "arn:aws:secretsmanager:us-east-2:444455556666:secret:MyReplicaSecret-a1b2c3" } } } ] }

Empfehlung

Für die meisten Anwendungsfälle ist die Replikationsrolle der empfohlene Ansatz. Secrets Manager übernimmt die Rolle und verwendet sie als einzige Identität für beide AWS KMS ruft auf, sodass Sie nicht jedem Writer Identity eine kontoübergreifende Zugriffsberechtigung für den KMS-Schlüssel des Replikatgeheimnisses erteilen müssen. Forward-Access-Sitzungen eignen sich für Fälle, in denen die Identitäten, die das primäre Geheimnis ändern, bereits den kontoübergreifenden Schlüssel enthalten kms:Encrypt Zugriff auf den KMS-Schlüssel des Replikatgeheimnisses, und Sie ziehen es vor, keine Replikationsrolle zu verwalten.

Richten Sie die Replikationsdienstrolle ein

Die Servicerolle muss vertrauen secretsmanager.amazonaws.comund kann an folgende Bedingungen geknüpft werden aws:SourceAccount und aws:SourceArn um das verwirrte Abgeordnetenproblem zu verhindern. Ihre Genehmigungspolitik muss Folgendes ermöglichen kms:Decrypt auf dem KMS-Schlüssel des primären Geheimnisses (optional mit dem SecreTARN-Verschlüsselungskontext, der auf den primären geheimen ARN gesetzt ist) und kms:Encrypt auf dem KMS-Schlüssel des Replikatgeheimnisses (optional mit dem SecreTARN-Verschlüsselungskontext, der auf den geheimen Replikat-ARN gesetzt ist).

Beispiel Vertrauensrichtlinie für die Replikationsdienstrolle (repräsentatives Beispiel)
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "secretsmanager.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "aws:SourceAccount": "111122223333" }, "ArnEquals": { "aws:SourceArn": "arn:aws:secretsmanager:us-east-2:111122223333:secret:MyPrimarySecret-a1b2c3" } } } ] }
Beispiel Berechtigungsrichtlinie für die Replikationsdienstrolle (repräsentatives Beispiel)
{ "Version": "2012-10-17", "Statement": [ { "Sid": "DecryptPrimarySecretKey", "Effect": "Allow", "Action": "kms:Decrypt", "Resource": "arn:aws:kms:us-east-2:111122223333:key/primary-key-id", "Condition": { "StringEquals": { "kms:EncryptionContext:SecretARN": "arn:aws:secretsmanager:us-east-2:111122223333:secret:MyPrimarySecret-a1b2c3" } } }, { "Sid": "EncryptReplicaSecretKey", "Effect": "Allow", "Action": "kms:Encrypt", "Resource": "arn:aws:kms:us-east-2:444455556666:key/replica-key-id", "Condition": { "StringEquals": { "kms:EncryptionContext:SecretARN": "arn:aws:secretsmanager:us-east-2:444455556666:secret:MyReplicaSecret-a1b2c3" } } } ] }

Die Von AWS verwalteter Schlüssel (aws/secretsmanager) unterstützt nicht kms:Decrypt Aufrufe von einer Servicerolle. Wenn Sie eine Replikationsrolle verwenden, müssen Sie einen vom Kunden verwalteten Schlüssel für das primäre Geheimnis verwenden. Fügen Sie der Schlüsselrichtlinie Ihres Primärschlüssels eine Anweisung wie die folgende hinzu, damit die Replikationsrolle den Datenschlüssel des primären Geheimnisses entschlüsseln kann.

Beispiel Grundsatzerklärung zum Primärschlüssel, die der Replikationsrolle die Entschlüsselung ermöglicht (repräsentatives Beispiel)
{ "Sid": "AllowReplicationRoleDecrypt", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:role/SecretsManagerCrossAccountReplicationRole" }, "Action": "kms:Decrypt", "Resource": "*", "Condition": { "StringEquals": { "kms:EncryptionContext:SecretARN": "arn:aws:secretsmanager:us-east-2:111122223333:secret:MyPrimarySecret-a1b2c3" } } }