

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Créer un secret de réplique

Pour activer la réplication entre comptes, le propriétaire du compte de réplication crée un nouveau secret de réplication dans le compte de réplication. Secrets Manager crée la réplique sans valeur secrète et initialise ses autorisations afin que le propriétaire du compte principal puisse l'associer à un secret principal. La valeur de la réplique reste vide jusqu'à ce que le propriétaire principal du compte commence la réplication.

Vous devez chiffrer le secret de réplication à l'aide d'une clé KMS gérée par le client. Le Clé gérée par AWS `aws/secretsmanager` ne prend pas en charge l'accès entre comptes.

Une fois que vous avez créé le secret de réplication, le propriétaire du compte principal l'associe au secret principal pour démarrer la réplication. Pour plus d’informations, consultez [Associez la réplique à un secret principal](cross-account-replicate-associate.md).

## Étapes pour créer un secret de réplique
<a name="cross-account-replicate-create_CLI"></a>

1. **Créez la clé gérée par le client.** Dans le compte de réplique et AWS Région, créez une clé KMS de chiffrement symétrique. Créez une politique clé qui autorise le compte de réplication à créer un nouveau secret. Pour plus d'informations, voir [Autorisations pour la clé KMS](https://docs.aws.amazon.com/secretsmanager/latest/userguide/security-encryption.html#security-encryption-authz). Vous ajoutez les autorisations de chiffrement entre comptes à cette clé KMS après avoir obtenu l'ARN du secret de réplication. Pour plus d'informations sur la création de clés, consultez [Création de clés](https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html) dans le *Guide du développeur AWS Key Management Service *.

1. **Créez le secret de la réplique.** Dans le compte de réplication, exécutez [`CreateSecret`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_CreateSecret.html). Set `CrossAccountPrimaryARN` à l'ARN du secret principal et `KmsKeyId` à l'ARN de la réplique de la clé KMS gérée par le client.  
**Example Créer un secret de réplique**  

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

   Jusqu'à ce que le secret principal réplique sa première valeur, en appelant [`GetSecretValue`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_GetSecretValue.html) sur les retours de répliques `ResourceNotFoundException`. Secrets Manager ne prend pas en charge les opérations d'écriture sur un secret de réplication, telles que [`PutSecretValue`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_PutSecretValue.html). Pour obtenir la liste complète, consultez [Opérations non prises en charge sur un secret de réplique](#cross-account-replicate-create_blocked).
**Note**  
Lorsque vous créez le secret de réplication, Secrets Manager associe une politique de ressources gérée par le système nommée `cross-account-replication` à elle. Cette politique gérée est en lecture seule et coexiste avec toutes les politiques de ressources que vous définissez sur le réplica.

   Étant donné que la création de la réplique est associée à une politique de ressources gérées, l'appelant doit `secretsmanager:PutResourcePolicy` sur le nouveau secret. L'appelant a également besoin du AWS KMS autorisations d'utilisation de la clé KMS du secret de réplication.

1. **Mettez à jour la politique relative aux clés de réplication.** Maintenant que l'ARN secret de la réplique existe, mettez à jour le *politique clé* de la clé KMS répliquée pour autoriser le compte principal à appeler `kms:Encrypt`. Ajustez le principal et les conditions en fonction de vos exigences de sécurité.

   Pour restreindre davantage l'utilisation de la clé, vous pouvez éventuellement définir la portée de l'instruction avec [Contexte de chiffrement SecretArn](security-encryption.md#security-encryption-encryption-context) défini sur l'ARN secret de la réplique. Dans cette condition, le compte principal ne peut utiliser la clé que lorsqu'il effectue une réplication vers ce secret de réplication.  
**Example Déclaration de politique clé en matière de réplication pour la réplication entre comptes**  <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"
       }
     }
   }
   ```

   Pour plus d'informations sur la manière dont Secrets Manager utilise les clés KMS et sur le contexte de chiffrement pour la réplication entre comptes, consultez [AWS KMS clés pour la réplication entre comptes](security-encryption.md#security-encryption-cross-account).

## System-managed politique en matière de ressources pour le secret de réplication
<a name="cross-account-replicate-create_resource-policy"></a>

Lorsque vous créez le secret de réplication, Secrets Manager crée une politique de ressources gérée par le système qui permet au propriétaire du secret principal de configurer la réplication vers ce secret de réplication. Vous ne pouvez pas modifier cette politique directement. Secrets Manager le supprime lorsque vous appelez `StopReplicationToReplica`. Vous pouvez annuler la politique et refuser explicitement `secretsmanager:AcceptCrossAccountReplication`, mais cela empêche le compte principal de se répliquer sur cette réplique.

**Example Exemple de politique de ressources gérée par le système sur le secret de réplication**  

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

## Opérations non prises en charge sur un secret de réplique
<a name="cross-account-replicate-create_blocked"></a>

Bien qu'un secret soit une réplique entre comptes, Secrets Manager ne prend pas en charge les opérations suivantes. Si vous appelez l'une des opérations suivantes sur un secret de réplication, la demande renvoie `InvalidRequestException`:
+ `PutSecretValue`
+ `UpdateSecret`
+ `DeleteSecret` — Pour supprimer une réplique, appelez d'abord `StopReplicationToReplica` pour le transformer en secret autonome, puis appelez `DeleteSecret`.
+ `RotateSecret`
+ `CancelRotateSecret`
+ `UpdateSecretVersionStage`
+ `ReplicateSecretToRegions`
+ `RemoveRegionsFromReplication`

Les opérations qui restent disponibles sur une réplique secrète incluent `GetSecretValue`, `DescribeSecret`, les opérations relatives à la politique des ressources (`GetResourcePolicy`, `PutResourcePolicy`, et `DeleteResourcePolicy`), les opérations de balisage et `StopReplicationToReplica`.

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

Pour créer un secret de réplique, utilisez [`CreateSecret`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_CreateSecret.html) commande avec `CrossAccountPrimaryARN` et `KmsKeyId` paramètres. Pour plus d'informations, consultez [AWS Kits SDK](asm_access.md#asm-sdks).