

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

## Funktionsweise der Zuordnung
<a name="cross-account-replicate-associate_how"></a>

Der Hauptkontoinhaber läuft [`AssociateCrossAccountReplica`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_AssociateCrossAccountReplica.html) 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
<a name="cross-account-replicate-associate_accept"></a>

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

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

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

## Beschränkung auf Replikate
<a name="cross-account-replicate-associate_restriction"></a>

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`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_AssociateCrossAccountReplica.html) 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
<a name="cross-account-replicate-associate_CLI"></a>

Führen Sie vom Hauptkonto aus [`AssociateCrossAccountReplica`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_AssociateCrossAccountReplica.html).

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

**Example 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`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_DescribeSecret.html) regelmäßig und überprüfe das `ReplicationStatus` Feld bis es angezeigt wird `InSync`.

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

## AWS SDK
<a name="cross-account-replicate-associate_SDK"></a>

Um das Replikat mit dem primären Schlüssel zu verknüpfen, verwenden Sie den [`AssociateCrossAccountReplica`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_AssociateCrossAccountReplica.html) Befehl. Weitere Informationen finden Sie unter [AWS SDKs](asm_access.md#asm-sdks).