

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

# In che modo Secrets Manager autorizza la replica tra account

Ogni volta che Secrets Manager replica un valore segreto, decrittografa il valore con la chiave KMS del segreto primario e lo crittografa nuovamente con la chiave KMS del segreto di replica. Secrets Manager necessita di un'identità autorizzata per entrambe le operazioni. Sei tu a scegliere l'identità: un ruolo di replica che Secrets Manager assume o l'identità del chiamante tramite una sessione di accesso diretto (FAS). Questo argomento spiega entrambi gli approcci.

## Come viene attivata la replica
<a name="cross-account-replicate-permissions_trigger"></a>

Secrets Manager mantiene la replica sincronizzata replicando ogni modifica sul valore segreto primario. Ad esempio, quando chiami [`PutSecretValue`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_PutSecretValue.html) sul segreto primario, Secrets Manager crea la nuova versione, sposta il `AWSCURRENT` assegnando un'etichetta temporanea ad essa e quindi replica la versione nella replica. La replica è asincrona e alla fine coerente, pertanto la replica potrebbe non riflettere immediatamente il valore più recente. Per seguire i progressi, vedere [Monitora la replica su più account](cross-account-replicate-status.md).

## La replica ne esegue due AWS KMS operazioni
<a name="cross-account-replicate-permissions_kms"></a>

Per spostare un valore segreto dal primario alla replica, Secrets Manager esegue le due operazioni seguenti AWS KMS operazioni nell'ordine:

1. **Decifrare** — Secrets Manager chiama `kms:Decrypt` con la chiave KMS del segreto primario per decrittografare la chiave dati che protegge il valore segreto.

1. **Crittografa** — Chiamate da Secrets Manager `kms:Encrypt` con la chiave KMS segreta della replica per crittografare nuovamente la chiave dati per l'archiviazione nella replica.

Poiché le due chiavi KMS si trovano in account diversi, la politica delle chiavi della chiave di replica deve consentire la chiamata all'account del segreto primario `kms:Encrypt`. È possibile definire questo criterio utilizzando il contesto di crittografia SecretARN per limitare l'uso al segreto della replica. Per la dichiarazione politica chiave, vedere [Crea una replica segreta](cross-account-replicate-create.md). Per ulteriori informazioni su come Secrets Manager utilizza le chiavi KMS e il contesto di crittografia durante la replica, vedere [AWS KMS chiavi per la replica tra account](security-encryption.md#security-encryption-cross-account).

**Importante**  
Una politica di controllo delle risorse (RCP) o una politica di controllo dei servizi (SCP) a livello di organizzazione possono bloccarli AWS KMS operazioni, anche se l'identità e le politiche chiave le consentono.

## Scegli in che modo Secrets Manager ottiene le autorizzazioni
<a name="cross-account-replicate-permissions_choose"></a>

La differenza tra i due approcci è l'identità che Secrets Manager utilizza per creare i due AWS KMS chiamate.

### Ruolo di replica (consigliato)
<a name="cross-account-replicate-permissions_choose_role"></a>

Quando si fornisce un ruolo di replica, Secrets Manager assume tale ruolo IAM e lo utilizza come identità per entrambi AWS KMS chiamate. Secrets Manager utilizza il ruolo per chiamare `kms:Decrypt` sulla chiave KMS del segreto primario e `kms:Encrypt` sulla chiave KMS del segreto della replica. Poiché il ruolo prevede le autorizzazioni per più account, i singoli chiamanti di [`PutSecretValue`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_PutSecretValue.html) non è necessario che tutti abbiano bisogno di più account AWS KMS autorizzazioni. Con questo approccio, il segreto principale deve utilizzare una chiave KMS gestita dal cliente.

Per informazioni su come impostare il ruolo, la relativa politica di fiducia e la politica di autorizzazione, consulta [Imposta il ruolo del servizio di replica](#cross-account-replicate-permissions_role-policy).

### Inoltro delle sessioni di accesso
<a name="cross-account-replicate-permissions_choose_fas"></a>

UN [sessione di accesso diretto](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_forward_access_sessions.html) (FAS) consente a Secrets Manager di effettuare chiamate API downstream utilizzando le autorizzazioni dell'identità che ha attivato l'operazione. Quando non si fornisce un ruolo di replica, Secrets Manager utilizza una sessione di accesso diretto: le due AWS KMS chiamate con l'identità che ha richiamato l'operazione di attivazione, ad esempio [`PutSecretValue`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_PutSecretValue.html).

**Nota**  
Con una sessione di accesso diretto, la replica iniziale viene eseguita utilizzando l'identità chiamata [`AssociateCrossAccountReplica`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_AssociateCrossAccountReplica.html).

Con questo approccio, l'identità che attiva deve possedere entrambe le seguenti autorizzazioni:
+ `kms:Decrypt` sulla chiave KMS del segreto primario. Questa chiave si trova nello stesso account del chiamante, quindi il chiamante di solito è già in possesso di questa autorizzazione.
+ `kms:Encrypt` sulla chiave KMS del segreto della replica. Questa chiave si trova nell'account di replica, quindi il chiamante deve avere l'autorizzazione per utilizzarla su più account. Questo è il requisito che FAS rende più difficile da soddisfare.

Se l'identità di attivazione è priva di una delle due AWS KMS autorizzazione, la replica non può essere completata e lo stato della replica diventa `Failed`. Per informazioni sulla lettura dello stato e sul ripristino, consulta [Monitora la replica su più account](cross-account-replicate-status.md).

La seguente politica di identità consente a [`PutSecretValue`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_PutSecretValue.html) chiamante per utilizzare il cross-account `kms:Encrypt` l'autorizzazione necessaria sulla chiave KMS del segreto della replica. L'istruzione è basata sul contesto di crittografia SecretARN in modo che l'identità possa utilizzare la chiave KMS del segreto di replica solo per il segreto di replica. Allega una policy come questa all'identità che chiama [`PutSecretValue`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_PutSecretValue.html) sul segreto primario.

**Example Politica di identità per un chiamante da crittografare con la chiave KMS del segreto di replica**  

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

## Raccomandazione
<a name="cross-account-replicate-permissions_recommendation"></a>

Per la maggior parte dei casi d'uso, il ruolo di replica è l'approccio consigliato. Secrets Manager assume il ruolo e lo utilizza come identità singola per entrambi AWS KMS chiamate, quindi non è necessario concedere a tutti gli account di Writer Identity l'autorizzazione per la chiave KMS della replica segreta. Le sessioni di accesso diretto possono essere utili nei casi in cui le identità che modificano il segreto primario detengono già il cross-account `kms:Encrypt` autorizzazione sulla chiave KMS del segreto di replica e preferisci non gestire un ruolo di replica.

## Imposta il ruolo del servizio di replica
<a name="cross-account-replicate-permissions_role-policy"></a>

Il ruolo del servizio deve fidarsi `secretsmanager.amazonaws.com`e può essere condizionato `aws:SourceAccount` e `aws:SourceArn` per aiutare a prevenire il confuso problema dei vice. La sua politica di autorizzazione deve consentire `kms:Decrypt` sulla chiave KMS del segreto primario (opzionalmente con il contesto di crittografia SecretARN impostato sull'ARN segreto primario) e `kms:Encrypt` sulla chiave KMS del segreto di replica (opzionalmente con il contesto di crittografia SecretARN impostato sull'ARN segreto di replica).

**Example Politica di fiducia per il ruolo del servizio di replica (esempio rappresentativo)**  

```
{
  "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 Politica di autorizzazione per il ruolo del servizio di replica (esempio rappresentativo)**  

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

La Chiave gestita da AWS (`aws/secretsmanager`) non supporta `kms:Decrypt` chiamate da un ruolo di servizio. È necessario utilizzare una chiave gestita dal cliente per il segreto primario quando si utilizza un ruolo di replica. Aggiungi una dichiarazione come la seguente alla policy della chiave primaria per consentire al ruolo di replica di decrittografare la chiave dati del segreto primario.

**Example Dichiarazione politica della chiave primaria che consente la decrittografia del ruolo di replica (esempio rappresentativo)**  

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