

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Crea un secreto de réplica

Para habilitar la replicación entre cuentas, el propietario de la cuenta de réplica crea un nuevo secreto de réplica en la cuenta de réplica. Secrets Manager crea la réplica sin ningún valor secreto e inicializa sus permisos para que el propietario de la cuenta principal pueda asociarla a un secreto principal. El valor de la réplica permanece vacío hasta que el propietario de la cuenta principal inicie la replicación.

Debe cifrar el secreto de la réplica con una clave de KMS administrada por el cliente. El Clave administrada de AWS `aws/secretsmanager` no admite el acceso multicuenta.

Tras crear el secreto de la réplica, el propietario de la cuenta principal lo asocia al secreto principal para iniciar la replicación. Para obtener más información, consulte [Asociar la réplica a un secreto principal](cross-account-replicate-associate.md).

## Pasos para crear un secreto de réplica
<a name="cross-account-replicate-create_CLI"></a>

1. **Cree la clave gestionada por el cliente.** En la cuenta de réplica y AWS Región, cree una clave KMS de cifrado simétrico. Cree una política de claves que otorgue a la cuenta de réplica permisos para crear un nuevo secreto. Para obtener más información, consulte [Permisos para la clave KMS](https://docs.aws.amazon.com/secretsmanager/latest/userguide/security-encryption.html#security-encryption-authz). Añada los permisos de cifrado multicuenta a esta clave de KMS una vez que tenga el ARN del secreto de la réplica. Para más información sobre la creación de claves, consulte [Creación de claves](https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html) en la *Guía para desarrolladores de AWS Key Management Service *.

1. **Crea el secreto de la réplica.** En la cuenta de réplica, ejecuta [`CreateSecret`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_CreateSecret.html). Set `CrossAccountPrimaryARN` al ARN del secreto principal y `KmsKeyId` al ARN de la clave KMS replicada administrada por el cliente.  
**Example Cree un secreto de réplica**  

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

   Hasta que el secreto principal replique su primer valor, llama [`GetSecretValue`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_GetSecretValue.html) en la réplica devuelve `ResourceNotFoundException`. Secrets Manager no admite operaciones de escritura en un secreto de réplica, como [`PutSecretValue`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_PutSecretValue.html). Puede consultar la lista completa e [No se admiten operaciones con un secreto de réplica](#cross-account-replicate-create_blocked).
**nota**  
Al crear el secreto de la réplica, Secrets Manager adjunta una política de recursos administrada por el sistema denominada `cross-account-replication` a ella. Esta política administrada es de solo lectura y coexiste con cualquier política de recursos que establezca en la réplica.

   Dado que la creación de la réplica implica una política de recursos administrados, la persona que llama necesita `secretsmanager:PutResourcePolicy` sobre el nuevo secreto. La persona que llama también necesita el AWS KMS permisos para usar la clave KMS del secreto de la réplica.

1. **Actualice la política de claves de réplica.** Ahora que existe el ARN secreto de la réplica, actualice *política clave* de la clave KMS de réplica para autorizar la llamada de la cuenta principal `kms:Encrypt`. Ajuste el principio y las condiciones para que coincidan con sus requisitos de seguridad.

   Para restringir aún más el uso de la clave, si lo desea, puede definir el alcance de la declaración con el [Contexto de cifrado SecretarN](security-encryption.md#security-encryption-encryption-context) establecido en el ARN secreto de la réplica. Con esta condición, la cuenta principal solo puede usar la clave cuando se replica en este secreto de réplica.  
**Example Declaración de política de claves de réplica para la replicación entre cuentas**  <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"
       }
     }
   }
   ```

   Para obtener más información sobre cómo Secrets Manager usa las claves de KMS y el contexto de cifrado para la replicación entre cuentas, consulte [AWS KMS claves para la replicación entre cuentas](security-encryption.md#security-encryption-cross-account).

## System-managed política de recursos para el secreto de la réplica
<a name="cross-account-replicate-create_resource-policy"></a>

Al crear el secreto de la réplica, Secrets Manager crea una política de recursos administrada por el sistema que permite al propietario del secreto principal configurar la replicación a este secreto de réplica. No puede editar esta política directamente. Secrets Manager la elimina cuando llamas `StopReplicationToReplica`. Puede anular la política y negarla explícitamente `secretsmanager:AcceptCrossAccountReplication`, pero al hacerlo se evita que la cuenta principal se replique en esta réplica.

**Example Ejemplo de política de recursos administrada por el sistema sobre el secreto de la réplica**  

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

## No se admiten operaciones con un secreto de réplica
<a name="cross-account-replicate-create_blocked"></a>

Si bien un secreto es una réplica multicuenta, Secrets Manager no admite las siguientes operaciones en él. Si ejecutas una de las siguientes operaciones en una réplica secreta, la solicitud se devuelve `InvalidRequestException`:
+ `PutSecretValue`
+ `UpdateSecret`
+ `DeleteSecret` — Para eliminar una réplica, primero llame `StopReplicationToReplica` para convertirlo en un secreto independiente y, a continuación, llamar `DeleteSecret`.
+ `RotateSecret`
+ `CancelRotateSecret`
+ `UpdateSecretVersionStage`
+ `ReplicateSecretToRegions`
+ `RemoveRegionsFromReplication`

Las operaciones que permanecen disponibles en una réplica secreta incluyen `GetSecretValue`, `DescribeSecret`, las operaciones de política de recursos (`GetResourcePolicy`, `PutResourcePolicy`, y `DeleteResourcePolicy`), operaciones de etiquetado y `StopReplicationToReplica`.

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

Para crear una réplica secreta, usa el [`CreateSecret`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_CreateSecret.html) comando con `CrossAccountPrimaryARN` y `KmsKeyId` parámetros. Para obtener más información, consulte [AWS SDK](asm_access.md#asm-sdks).