

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à.

# Crea una replica segreta
<a name="cross-account-replicate-create"></a>

Per abilitare la replica tra account, il proprietario dell'account di replica crea un nuovo segreto di replica nell'account di replica. Secrets Manager crea la replica senza alcun valore segreto e inizializza le relative autorizzazioni in modo che il proprietario dell'account principale possa associarla a un segreto primario. Il valore della replica rimane vuoto finché il proprietario dell'account principale non avvia la replica.

È necessario crittografare il segreto della replica con una chiave KMS gestita dal cliente. Il Chiave gestita da AWS `aws/secretsmanager` non supporta l'accesso tra più account.

Dopo aver creato il segreto di replica, il proprietario dell'account principale lo associa al segreto primario per avviare la replica. Per ulteriori informazioni, consulta [Associa la replica a un segreto primario](cross-account-replicate-associate.md).

## Procedura per creare un segreto di replica
<a name="cross-account-replicate-create_CLI"></a>

1. **Crea la chiave gestita dal cliente.** Nell'account di replica e AWS Regione, crea una chiave KMS di crittografia simmetrica. Crea una policy chiave che dia all'account di replica le autorizzazioni per creare un nuovo segreto. Per ulteriori informazioni, vedere [Autorizzazioni per la chiave KMS](https://docs.aws.amazon.com/secretsmanager/latest/userguide/security-encryption.html#security-encryption-authz). Aggiungi le autorizzazioni di crittografia tra account a questa chiave KMS dopo aver ottenuto l'ARN del segreto di replica. Per ulteriori informazioni sulla creazione di chiavi, consulta [Creazione di chiavi](https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html) nella *Guida per gli sviluppatori di AWS Key Management Service *.

1. **Crea il segreto della replica.** Nell'account di replica, esegui [`CreateSecret`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_CreateSecret.html). Impostare `CrossAccountPrimaryARN` all'ARN del segreto primario e `KmsKeyId` all'ARN della chiave KMS gestita dal cliente di replica.  
**Example Crea una replica segreta**  

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

   Finché il segreto primario non replica il suo primo valore, chiamando [`GetSecretValue`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_GetSecretValue.html) sulla replica ritorna `ResourceNotFoundException`. Secrets Manager non supporta le operazioni di scrittura su un segreto di replica, ad esempio [`PutSecretValue`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_PutSecretValue.html). Per l’elenco completo, consulta [Operazioni non supportate su un segreto di replica](#cross-account-replicate-create_blocked).
**Nota**  
Quando si crea il segreto della replica, Secrets Manager allega una policy sulle risorse gestite dal sistema denominata `cross-account-replication` ad esso. Questa policy gestita è di sola lettura e coesiste con qualsiasi policy relativa alle risorse impostata sulla replica.

   Poiché la creazione della replica allega una politica relativa alle risorse gestite, il chiamante deve `secretsmanager:PutResourcePolicy` sul nuovo segreto. Il chiamante ha bisogno anche del AWS KMS autorizzazioni per utilizzare la chiave KMS del segreto della replica.

1. **Aggiorna la politica delle chiavi di replica.** Ora che l'ARN segreto della replica esiste, aggiorna il *politica chiave* della chiave KMS di replica per autorizzare l'account principale a chiamare `kms:Encrypt`. Adatta il principio e le condizioni in base ai tuoi requisiti di sicurezza.

   Per limitare ulteriormente l'uso della chiave, puoi facoltativamente definire l'ambito della dichiarazione con il [Contesto di crittografia SecretARN](security-encryption.md#security-encryption-encryption-context) impostato sull'ARN segreto della replica. Con questa condizione, l'account primario può utilizzare la chiave solo quando si replica su questo segreto di replica.  
**Example Dichiarazione sulla politica della chiave di replica per la replica su più account**  <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"
       }
     }
   }
   ```

   Per ulteriori informazioni su come Secrets Manager utilizza le chiavi KMS e sul contesto di crittografia per la replica tra account, vedere [AWS KMS chiavi per la replica tra account](security-encryption.md#security-encryption-cross-account).

## System-managed politica delle risorse per il segreto della replica
<a name="cross-account-replicate-create_resource-policy"></a>

Quando si crea il segreto di replica, Secrets Manager crea una politica delle risorse gestita dal sistema che consente al proprietario del segreto primario di impostare la replica su questo segreto di replica. Non puoi modificare direttamente questa policy. Secrets Manager la rimuove quando chiami `StopReplicationToReplica`. Puoi sovrascrivere la politica e negare esplicitamente `secretsmanager:AcceptCrossAccountReplication`, ma così facendo si impedisce all'account principale di replicarsi su questa replica.

**Example Esempio di politica delle risorse gestita dal sistema sul segreto della replica**  

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

## Operazioni non supportate su un segreto di replica
<a name="cross-account-replicate-create_blocked"></a>

Sebbene un segreto sia una replica su più account, Secrets Manager non supporta le seguenti operazioni su di esso. Se si chiama una delle seguenti operazioni su una replica segreta, la richiesta viene restituita `InvalidRequestException`:
+ `PutSecretValue`
+ `UpdateSecret`
+ `DeleteSecret` — Per eliminare una replica, prima chiama `StopReplicationToReplica` per promuoverla come segreta autonoma, quindi chiama `DeleteSecret`.
+ `RotateSecret`
+ `CancelRotateSecret`
+ `UpdateSecretVersionStage`
+ `ReplicateSecretToRegions`
+ `RemoveRegionsFromReplication`

Le operazioni che rimangono disponibili su una replica segreta includono `GetSecretValue`, `DescribeSecret`, le operazioni relative alla politica delle risorse (`GetResourcePolicy`, `PutResourcePolicy`, e `DeleteResourcePolicy`), operazioni con i tag e `StopReplicationToReplica`.

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

Per creare una replica segreta, usa [`CreateSecret`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_CreateSecret.html) comando con `CrossAccountPrimaryARN` e `KmsKeyId` parametri. Per ulteriori informazioni, consulta [AWS SDK](asm_access.md#asm-sdks).