View a markdown version of this page

Erstellen Sie ein Replikatgeheimnis - 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.

Erstellen Sie ein Replikatgeheimnis

Um die kontoübergreifende Replikation zu ermöglichen, erstellt der Besitzer des Replikatkontos einen neuen geheimen Replikatschlüssel im Replikatkonto. Secrets Manager erstellt das Replikat ohne geheimen Wert und initialisiert seine Berechtigungen, sodass der Besitzer des primären Kontos es einem primären Schlüssel zuordnen kann. Der Wert des Replikats bleibt leer, bis der Besitzer des Primärkontos mit der Replikation beginnt.

Sie müssen den geheimen Replikatschlüssel mit einem vom Kunden verwalteten KMS-Schlüssel verschlüsseln. Der Von AWS verwalteter Schlüssel aws/secretsmanager unterstützt keinen kontoübergreifenden Zugriff.

Nachdem Sie das Replikatgeheimnis erstellt haben, ordnet der Besitzer des primären Kontos es dem primären Geheimnis zu, um die Replikation zu starten. Weitere Informationen finden Sie unter Ordnen Sie das Replikat einem primären Schlüssel zu.

Schritte zum Erstellen eines Replikatgeheimnisses

  1. Erstellen Sie den vom Kunden verwalteten Schlüssel. Im Replikatkonto und AWS Region, erstellen Sie einen KMS-Schlüssel für die symmetrische Verschlüsselung. Erstellen Sie eine Schlüsselrichtlinie, die dem Replikatkonto Berechtigungen zum Erstellen eines neuen Geheimnisses erteilt. Weitere Informationen finden Sie unter Berechtigungen für den KMS-Schlüssel. Sie fügen diesem KMS-Schlüssel die kontoübergreifenden Verschlüsselungsberechtigungen hinzu, nachdem Sie den ARN des Replikatgeheimnisses erhalten haben. Weitere Informationen zum Erstellen von -Schlüsseln finden Sie unter Erstellen von Schlüsseln im AWS Key Management Service -Entwicklerhandbuch.

  2. Erstellen Sie das Replikatgeheimnis. Führen Sie im Replikatkonto Folgendes aus CreateSecret. Einstellen CrossAccountPrimaryARN auf den ARN des primären Geheimnisses und KmsKeyId zum ARN des vom Kunden verwalteten Replikat-KMS-Schlüssels.

    Beispiel Erstellen Sie einen geheimen Replikatschlüssel
    aws secretsmanager create-secret \ --name MyReplicaSecret \ --cross-account-primary-arn arn:aws:secretsmanager:us-east-2:111122223333:secret:MyPrimarySecret-a1b2c3 \ --kms-key-id arn:aws:kms:us-east-2:444455556666:key/replica-key-id

    Bis das primäre Geheimnis seinen ersten Wert repliziert, rufen Sie GetSecretValue wenn das Replikat zurückkehrt ResourceNotFoundException. Secrets Manager unterstützt keine Schreibvorgänge für ein Replikatgeheimnis, wie z. B. PutSecretValue. Eine vollständige Liste finden Sie unter Operationen werden für ein Replikatgeheimnis nicht unterstützt.

    Anmerkung

    Wenn Sie das Replikatgeheimnis erstellen, hängt Secrets Manager eine systemverwaltete Ressourcenrichtlinie mit dem Namen an cross-account-replication dazu. Diese verwaltete Richtlinie ist schreibgeschützt und koexistiert mit allen Ressourcenrichtlinien, die Sie für das Replikat festgelegt haben.

    Da beim Erstellen des Replikats eine Richtlinie für verwaltete Ressourcen angehängt wird, benötigt der Aufrufer secretsmanager:PutResourcePolicy über das neue Geheimnis. Der Anrufer benötigt auch die AWS KMS Berechtigungen zur Verwendung des KMS-Schlüssels des Replikatgeheimnisses.

  3. Aktualisieren Sie die Replikatschlüsselrichtlinie. Jetzt, da der Replikat-Secret-ARN existiert, aktualisieren Sie den wichtige Richtlinie des Replikat-KMS-Schlüssels, um das primäre Konto zum Aufrufen zu autorisieren kms:Encrypt. Passen Sie das Prinzip und die Bedingungen an Ihre Sicherheitsanforderungen an.

    Um die Verwendung des Schlüssels weiter einzuschränken, können Sie den Umfang der Anweisung optional mit dem SecretArn-Verschlüsselungskontext auf den geheimen Replikat-ARN gesetzt. Unter dieser Bedingung kann das primäre Konto den Schlüssel nur verwenden, wenn es auf diesen geheimen Replikatschlüssel repliziert wird.

    Beispiel Richtlinienerklärung für Replikatschlüssel für die kontoübergreifende Replikation
    { "Sid": "AllowCrossAccountReplication", "Effect": "Allow", "Principal": "*", "Action": "kms:Encrypt", "Resource": "*", "Condition": { "StringEquals": { "kms:CallerAccount": "111122223333", "kms:EncryptionContext:SecretARN": "arn:aws:secretsmanager:us-east-2:444455556666:secret:MyReplicaSecret-a1b2c3" } } }

    Weitere Informationen zur Verwendung von KMS-Schlüsseln durch Secrets Manager und zum Verschlüsselungskontext für die kontoübergreifende Replikation finden Sie unter AWS KMS Schlüssel für die kontoübergreifende Replikation.

System-managed Ressourcenrichtlinie für das geheime Replikat

Wenn Sie das Replikatgeheimnis erstellen, erstellt Secrets Manager eine systemverwaltete Ressourcenrichtlinie, die es dem Besitzer des primären Geheimnisses ermöglicht, die Replikation auf dieses Replikatgeheimnis einzurichten. Sie können diese Richtlinie nicht direkt bearbeiten. Secrets Manager entfernt es, wenn Sie anrufen StopReplicationToReplica. Sie können die Richtlinie außer Kraft setzen und sie explizit ablehnen secretsmanager:AcceptCrossAccountReplication, aber dadurch wird verhindert, dass das primäre Konto auf dieses Replikat repliziert wird.

Beispiel Beispiel für eine systemverwaltete Ressourcenrichtlinie für das geheime Replikat
{ "Version": "2012-10-17", "Statement": [ { "Sid": "CrossAccountReplication", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:root" }, "Action": "secretsmanager:AcceptCrossAccountReplication", "Resource": "*", "Condition": { "ForAnyValue:StringEquals": { "aws:InvokedBy": "secretsmanager.amazonaws.com" }, "ArnEquals": { "secretsmanager:CrossAccountPrimaryARN": "arn:aws:secretsmanager:us-east-2:111122223333:secret:MyPrimarySecret-a1b2c3" } } } ] }

Operationen werden für ein Replikatgeheimnis nicht unterstützt

Obwohl es sich bei einem Secret um ein kontoübergreifendes Replikat handelt, unterstützt Secrets Manager die folgenden Operationen nicht. Wenn Sie eine der folgenden Operationen für ein Replikatgeheimnis aufrufen, wird die Anforderung zurückgegeben InvalidRequestException:

  • PutSecretValue

  • UpdateSecret

  • DeleteSecret — Um ein Replikat zu löschen, rufen Sie zuerst auf StopReplicationToReplica um es zu einem eigenständigen Secret zu machen, und rufen Sie dann DeleteSecret.

  • RotateSecret

  • CancelRotateSecret

  • UpdateSecretVersionStage

  • ReplicateSecretToRegions

  • RemoveRegionsFromReplication

Zu den Vorgängen, die für ein Replikatgeheimnis weiterhin verfügbar sind, gehören GetSecretValue, DescribeSecret, die ressourcenpolitischen Operationen (GetResourcePolicy, PutResourcePolicy, und DeleteResourcePolicy), Tag-Operationen und StopReplicationToReplica.

AWS SDK

Um einen geheimen Replikatschlüssel zu erstellen, verwenden Sie den CreateSecret Befehl mit dem CrossAccountPrimaryARN und KmsKeyId Parameter. Weitere Informationen finden Sie unter AWS SDKs.