View a markdown version of this page

Cómo autoriza Secrets Manager la replicación entre cuentas - AWS Secrets Manager

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

Secrets Manager mantiene la réplica sincronizada al replicar cada cambio en el valor secreto principal. Por ejemplo, cuando llamas PutSecretValue 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.

La replicación realiza dos AWS KMS operaciones

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.

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

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

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)

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

Sesiones de acceso directo

UN sesión de acceso directo (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.

nota

Con una sesión de acceso directo, la replicación inicial se realiza mediante la identidad que llamó AssociateCrossAccountReplica.

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.

La siguiente política de identidad permite un PutSecretValue 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 sobre el secreto principal.

ejemplo 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

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

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

ejemplo 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" } } } ] }
ejemplo 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.

ejemplo 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" } } }