

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

Secrets Manager hält das Replikat synchron, indem jede Änderung am primären geheimen Wert repliziert wird. Zum Beispiel, wenn Sie anrufen [`PutSecretValue`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_PutSecretValue.html) 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](cross-account-replicate-status.md).

## Bei der Replikation werden zwei ausgeführt AWS KMS Operationen
<a name="cross-account-replicate-permissions_kms"></a>

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.

1. **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](cross-account-replicate-create.md). 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](security-encryption.md#security-encryption-cross-account).

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

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

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`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_PutSecretValue.html) 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](#cross-account-replicate-permissions_role-policy).

### Forward Access Sessions
<a name="cross-account-replicate-permissions_choose_fas"></a>

EIN [Sitzung mit weiterleitendem Zugriff](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_forward_access_sessions.html) (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`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_PutSecretValue.html).

**Anmerkung**  
Bei einer Forward-Access-Sitzung wird die erste Replikation unter Verwendung der Identität durchgeführt, die aufgerufen hat [`AssociateCrossAccountReplica`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_AssociateCrossAccountReplica.html).

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

Die folgende Identitätsrichtlinie ermöglicht eine [`PutSecretValue`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_PutSecretValue.html) 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`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_PutSecretValue.html) auf dem primären Geheimnis.

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

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

Die Servicerolle muss vertrauen `secretsmanager.amazonaws.com`und 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).

**Example 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"
        }
      }
    }
  ]
}
```

**Example 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.

**Example 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"
    }
  }
}
```