

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Associa la replica a un segreto primario
<a name="cross-account-replicate-associate"></a>

Dopo che il proprietario dell'account di replica ha creato il segreto di replica, il proprietario dell'account principale associa la replica al segreto primario per avviare la replica. Per informazioni su come creare il segreto della replica, vedi [Crea una replica segreta](cross-account-replicate-create.md).

## Funzionamento dell’associazione
<a name="cross-account-replicate-associate_how"></a>

Il proprietario principale dell'account gestisce [`AssociateCrossAccountReplica`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_AssociateCrossAccountReplica.html) con `SecretId` per il segreto primario e `CrossAccountReplicaARN` per il segreto della replica.

Durante l'associazione, Secrets Manager esegue le seguenti operazioni:
+ Esegue la corsa a secco AWS KMS controlli delle autorizzazioni sulla chiave KMS primaria e sulla chiave segreta di replica.
+ Imposta i metadati di replica per i segreti primari e di replica.
+ Attiva il processo di replica per avviare la replica dei dati dal segreto primario al segreto di replica.

### AcceptCrossAccountReplication
<a name="cross-account-replicate-associate_accept"></a>

`AcceptCrossAccountReplication` è un'operazione solo interna che Secrets Manager chiama all'interno `AssociateCrossAccountReplica`. Questa operazione agisce sul segreto della replica utilizzando l'identità del `AssociateCrossAccountReplica` chiamante.

Il `AcceptCrossAccountReplication` la chiamata esegue la corsa a secco `kms:Encrypt` controlla la chiave KMS del segreto di replica e aggiorna i metadati di replica del segreto di replica. Solo dopo `AcceptCrossAccountReplication` ha successo `AssociateCrossAccountReplica` aggiorna i metadati di replica sul segreto primario.

## Autorizzazioni per associare una replica
<a name="cross-account-replicate-associate_permissions"></a>

L'identità che associa la replica richiede le seguenti autorizzazioni:
+ `secretsmanager:AssociateCrossAccountReplica` sul segreto primario.
+ `secretsmanager:GetSecretValue` sul segreto primario.
+ `secretsmanager:AcceptCrossAccountReplication` sul segreto della replica.
+ `kms:Decrypt` sulla chiave KMS del segreto primario.
+ `kms:Encrypt` sulla chiave KMS del segreto di replica (cross-account).

Se si passa un ruolo di replica con `ReplicationRoleARN`, il chiamante ha anche bisogno `iam:PassRole` per quel ruolo.

## Autorizzazioni per la replica
<a name="cross-account-replicate-associate_permissions-for-replication"></a>

Per soddisfare le esigenze di più account `kms:Encrypt` l'autorizzazione senza concedere a tutti i chiamanti l'accesso alla chiave di replica con più account, consigliamo un ruolo di replica. Secrets Manager assume il ruolo e lo utilizza come identità singola per le operazioni con la chiave di crittografia. Per i due approcci che Secrets Manager può utilizzare, vedi [In che modo Secrets Manager autorizza la replica tra account](cross-account-replicate-permissions.md).

## Restrizione della replica
<a name="cross-account-replicate-associate_restriction"></a>

La restrizione della replica è un parametro di `AssociateCrossAccountReplica` operazione. Questo parametro controlla se Secrets Manager blocca la replica su un segreto di replica esterno al tuo AWS organizzazione.

Per impostazione predefinita, la restrizione relativa alla replica è `SameOrg`, che richiede che entrambi gli account siano nello stesso AWS organizzazione. Per consentire la replica all'esterno AWS organizzazione, imposta la restrizione su `NoRestriction`.

Secrets Manager applica la restrizione della replica solo durante l'associazione iniziale. Chiamata [`AssociateCrossAccountReplica`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_AssociateCrossAccountReplica.html) nuovamente con un valore di restrizione diverso non modifica un'associazione esistente.

Se l'account di replica non soddisfa la restrizione, Secrets Manager restituisce un `AccessDeniedException` sul lato interno `AcceptCrossAccountReplication` chiamata.

## AWS CLI
<a name="cross-account-replicate-associate_CLI"></a>

Dall'account principale, esegui [`AssociateCrossAccountReplica`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_AssociateCrossAccountReplica.html).

**Example Associa la replica al segreto principale**  

```
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 La restrizione delle repliche nega una replica al di fuori del AWS organizzazione**  

```
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
```

Per eseguire la replica su un account esterno al tuo AWS organizzazione, aggiungi `--replica-restriction NoRestriction`.

La replica è asincrona. Chiama [`DescribeSecret`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_DescribeSecret.html) periodicamente e controlla `ReplicationStatus` campo finché non viene visualizzato `InSync`.

**Example Verificare lo stato della replica**  

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

Per ulteriori informazioni sui campi relativi allo stato della replica, vedere [Monitora la replica su più account](cross-account-replicate-status.md).

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

Per associare la replica al segreto principale, usa [`AssociateCrossAccountReplica`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_AssociateCrossAccountReplica.html) comando. Per ulteriori informazioni, consulta [AWS SDK](asm_access.md#asm-sdks).