

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.

# Cómo autoriza Secrets Manager la replicación entre cuentas

Cada vez que Secrets Manager replica un valor secreto, lo descifra con la clave de KMS del secreto principal y lo vuelve a cifrar con la clave de KMS del secreto de réplica. Secrets Manager necesita una identidad autorizada para ambas operaciones. Usted elige la identidad: una función de replicación que asuma Secrets Manager o la propia identidad de la persona que llama a través de una sesión de acceso directo (FAS). En este tema se explican ambos enfoques.

## Cómo se desencadena la replicación
<a name="cross-account-replicate-permissions_trigger"></a>

Secrets Manager mantiene la réplica sincronizada al replicar cada cambio en el valor secreto principal. Por ejemplo, cuando llamas [`PutSecretValue`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_PutSecretValue.html) en el secreto principal, Secrets Manager crea la nueva versión y mueve el `AWSCURRENT` le asigna una etiqueta provisional y, a continuación, replica la versión en la réplica. La replicación es asincrónica y, en última instancia, coherente, por lo que es posible que la réplica no refleje el valor más reciente de forma inmediata. Para seguir el progreso, consulte [Supervise la replicación entre cuentas](cross-account-replicate-status.md).

## La replicación realiza dos AWS KMS operaciones
<a name="cross-account-replicate-permissions_kms"></a>

Para mover un valor secreto del principal a la réplica, Secrets Manager realiza las dos siguientes acciones AWS KMS operaciones en orden:

1. **Descifrar** — Secrets Manager llama `kms:Decrypt` con la clave KMS del secreto principal para descifrar la clave de datos que protege el valor secreto.

1. **Cifrar** — Secrets Manager llama `kms:Encrypt` con la clave KMS del secreto de la réplica para volver a cifrar la clave de datos y almacenarla en la réplica.

Como las dos claves de KMS están en cuentas diferentes, la política de claves de la clave de la réplica debe permitir la llamada a la cuenta del secreto principal `kms:Encrypt`. Puede aplicar esta política utilizando el contexto de cifrado de SecretarN para restringir el uso al secreto de la réplica. Para ver la declaración de política clave, consulte [Crea un secreto de réplica](cross-account-replicate-create.md). Para obtener más información sobre cómo Secrets Manager usa las claves de KMS y el contexto de cifrado durante la replicación, consulte [AWS KMS claves para la replicación entre cuentas](security-encryption.md#security-encryption-cross-account).

**importante**  
Una política de control de recursos (RCP) o una política de control de servicios (SCP) a nivel de la organización pueden bloquearlos AWS KMS operaciones, incluso si las políticas de identidad y clave lo permiten.

## Elija cómo Secrets Manager obtiene los permisos
<a name="cross-account-replicate-permissions_choose"></a>

La diferencia entre los dos enfoques es la identidad que Secrets Manager utiliza para crear los dos AWS KMS llamadas.

### Función de replicación (recomendada)
<a name="cross-account-replicate-permissions_choose_role"></a>

Al proporcionar una función de replicación, Secrets Manager asume esa función de IAM y la usa como identidad para ambas AWS KMS llamadas. Secrets Manager usa el rol para llamar `kms:Decrypt` en la clave KMS del secreto principal y `kms:Encrypt` en la clave KMS del secreto de la réplica. Como el rol incluye los permisos multicuenta, las personas que llaman individualmente de [`PutSecretValue`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_PutSecretValue.html) cada uno de ellos no necesita tener varias cuentas AWS KMS permisos. Con este enfoque, el secreto principal debe usar una clave de KMS administrada por el cliente.

Para saber cómo configurar el rol, su política de confianza y su política de permisos, consulte [Configure la función de servicio de replicación](#cross-account-replicate-permissions_role-policy).

### Sesiones de acceso directo
<a name="cross-account-replicate-permissions_choose_fas"></a>

UN [sesión de acceso directo](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_forward_access_sessions.html) (FAS) permite a Secrets Manager realizar llamadas posteriores a la API utilizando los permisos de la identidad que activó la operación. Cuando no se proporciona una función de replicación, Secrets Manager utiliza una sesión de acceso directo: realiza las dos AWS KMS las llamadas con la identidad que inició la operación desencadenante, por ejemplo [`PutSecretValue`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_PutSecretValue.html).

**nota**  
Con una sesión de acceso directo, la replicación inicial se realiza mediante la identidad que llamó [`AssociateCrossAccountReplica`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_AssociateCrossAccountReplica.html).

Con este enfoque, la identidad desencadenante debe tener los dos permisos siguientes:
+ `kms:Decrypt` en la clave KMS del secreto principal. Esta clave está en la misma cuenta que la persona que llama, por lo general, la persona que llama ya tiene este permiso.
+ `kms:Encrypt` en la clave KMS del secreto de la réplica. Esta clave está en la cuenta de réplica, por lo que la persona que llama necesita permiso para acceder a ella entre cuentas. Este es el requisito que FAS hace más difícil de cumplir.

Si la identidad desencadenante carece de alguno de los dos AWS KMS permiso, la replicación no puede completarse y el estado de la replicación pasa a ser `Failed`. Para saber cómo leer el estado y recuperarse, consulte [Supervise la replicación entre cuentas](cross-account-replicate-status.md).

La siguiente política de identidad permite un [`PutSecretValue`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_PutSecretValue.html) la persona que llama puede usar la cuenta cruzada `kms:Encrypt` el permiso que necesita en la clave KMS del secreto de la réplica. El alcance de la declaración se basa en el contexto de cifrado de SecretarN, de modo que la identidad pueda usar la clave KMS del secreto de la réplica solo para el secreto de la réplica. Adjunte una política como esta a la identidad que llama [`PutSecretValue`](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_PutSecretValue.html) sobre el secreto principal.

**Example Política de identidad para que la persona que llama la encripte con la clave KMS del secreto de la réplica**  

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

## Recomendación
<a name="cross-account-replicate-permissions_recommendation"></a>

En la mayoría de los casos de uso, la función de replicación es el enfoque recomendado. Secrets Manager asume la función y la usa como identidad única para ambos AWS KMS llamadas, por lo que no es necesario conceder permisos multicuenta a cada identidad de escritor para acceder a la clave KMS del secreto de réplica. Las sesiones de acceso directo son adecuadas para los casos en los que las identidades que cambian el secreto principal ya tienen la cuenta cruzada `kms:Encrypt` tienes permiso sobre la clave KMS del secreto de la réplica y prefieres no administrar una función de replicación.

## Configure la función de servicio de replicación
<a name="cross-account-replicate-permissions_role-policy"></a>

El rol de servicio debe confiar `secretsmanager.amazonaws.com`, y puede estar condicionado a `aws:SourceAccount` y `aws:SourceArn` para ayudar a prevenir el confuso problema de los diputados. Su política de permisos debe permitir `kms:Decrypt` en la clave KMS del secreto principal (opcionalmente, con el contexto de cifrado SecretarN establecido en el ARN secreto principal) y `kms:Encrypt` en la clave KMS del secreto de la réplica (opcionalmente, con el contexto de cifrado SecretarN establecido en el ARN secreto de la réplica).

**Example Política de confianza para la función de servicio de replicación (ejemplo representativo)**  

```
{
  "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 Política de permisos para la función de servicio de replicación (ejemplo representativo)**  

```
{
  "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 Clave administrada de AWS (`aws/secretsmanager`) no es compatible `kms:Decrypt` llamadas desde un rol de servicio. Debe usar una clave administrada por el cliente como secreto principal cuando utilice una función de replicación. Agregue una sentencia como la siguiente a la política de claves de su clave principal para permitir que la función de replicación descifre la clave de datos del secreto principal.

**Example Declaración de política de clave principal que permite descifrar la función de replicación (ejemplo representativo)**  

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