

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](cross-account-replicate-associate.md).

## Schritte zum Erstellen eines Replikatgeheimnisses
<a name="cross-account-replicate-create_CLI"></a>

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](https://docs.aws.amazon.com/secretsmanager/latest/userguide/security-encryption.html#security-encryption-authz). 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](https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html) im *AWS Key Management Service -Entwicklerhandbuch*.

1. **Erstellen Sie das Replikatgeheimnis.** Führen Sie im Replikatkonto Folgendes aus [`CreateSecret`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_CreateSecret.html). Einstellen `CrossAccountPrimaryARN` auf den ARN des primären Geheimnisses und `KmsKeyId` zum ARN des vom Kunden verwalteten Replikat-KMS-Schlüssels.  
**Example 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`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_GetSecretValue.html) wenn das Replikat zurückkehrt `ResourceNotFoundException`. Secrets Manager unterstützt keine Schreibvorgänge für ein Replikatgeheimnis, wie z. B. [`PutSecretValue`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_PutSecretValue.html). Eine vollständige Liste finden Sie unter [Operationen werden für ein Replikatgeheimnis nicht unterstützt](#cross-account-replicate-create_blocked).
**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.

1. **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](security-encryption.md#security-encryption-encryption-context) 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.  
**Example Richtlinienerklärung für Replikatschlüssel für die kontoübergreifende Replikation**  <a name="cross-account-replicate-create_keypolicy-example"></a>

   ```
   {
     "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](security-encryption.md#security-encryption-cross-account).

## System-managed Ressourcenrichtlinie für das geheime Replikat
<a name="cross-account-replicate-create_resource-policy"></a>

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.

**Example 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
<a name="cross-account-replicate-create_blocked"></a>

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
<a name="cross-account-replicate-create_SDK"></a>

Um einen geheimen Replikatschlüssel zu erstellen, verwenden Sie den [`CreateSecret`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_CreateSecret.html) Befehl mit dem `CrossAccountPrimaryARN` und `KmsKeyId` Parameter. Weitere Informationen finden Sie unter [AWS SDKs](asm_access.md#asm-sdks).