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.
Cifrado y descifrado secretos en AWS Secrets Manager
Secrets Manager utiliza el cifrado de sobre con las claves y claves de datos de AWS KMS para proteger cada valor del secreto. Siempre que cambia el valor secreto en un secreto, Secrets Manager solicita una nueva clave de datos de AWS KMS para protegerlo. La clave de datos se cifra como una clave de KMS y se almacena en los metadatos del secreto. Para descifrar el secreto, Secrets Manager primero descifra la clave de datos cifrada mediante la clave KMS en AWS KMS.
Secrets Manager no utiliza la clave KMS para cifrar directamente el valor del secreto. En cambio, utiliza la clave KMS para generar y cifrar una clave de datos simétrica AES (Advanced Encryption Standard) de 256 bits y utiliza la clave de datos para cifrar el valor del secreto. Secrets Manager utiliza la clave de datos en texto plano para cifrar el valor secreto fuera de AWS KMS y, a continuación, lo elimina de la memoria. Almacena la copia cifrada de la clave de datos en los metadatos del secreto.
Elegir un AWS KMS clave
Al crear un secreto, puede elegir cualquier clave de cifrado simétrico gestionada por el cliente en el Cuenta de AWS y Región, o puede usar la Clave administrada de AWS para Secrets Manager (aws/secretsmanager). Si eliges el Clave administrada de AWS
aws/secretsmanager y aún no existe, Secrets Manager lo crea y lo asocia con el secreto. Puede utilizar la misma clave KMS o diferentes claves KMS para cada secreto de su cuenta. Es posible que desee utilizar diferentes claves de KMS para establecer permisos personalizados en las claves de un grupo de secretos, o si desea auditar operaciones específicas para esas claves. Secrets Manager solamente admite claves KMS de cifrado simétricas. Si utiliza una clave de KMS en un almacén de claves externo, las operaciones criptográficas en la clave de KMS pueden tardar más y ser menos fiables y duraderas, ya que la solicitud tiene que viajar fuera de AWS.
Para obtener información sobre cómo cambiar la clave de cifrado de un secreto, consulte Cambie la clave de cifrado de un AWS Secrets Manager secreta.
Al cambiar la clave de cifrado, Secrets Manager vuelve a cifrar las versiones AWSCURRENT, AWSPENDING y AWSPREVIOUS con la nueva clave. Para evitar que descubra el secreto, Secrets Manager mantiene todas las versiones existentes cifradas con la clave anterior. Esto significa que puede descifrar las versiones AWSCURRENT, AWSPENDING y AWSPREVIOUS con la clave anterior o con la nueva clave. Si no tiene permiso kms:Decrypt para usar la clave anterior, al cambiar la clave de cifrado, Secrets Manager no podrá descifrar las versiones secretas para volver a cifrarlas. En este caso, las versiones existentes no se vuelven a cifrar.
Para que solo AWSCURRENT se pueda descifrar con la nueva clave de cifrado, cree una nueva versión del secreto con la nueva clave. Luego, para poder descifrar la versión secreta de AWSCURRENT, debe tener permiso para usar la nueva clave.
Puede denegar el permiso a Clave administrada de AWS aws/secretsmanager y exigir que los secretos estén cifrados con una clave gestionada por el cliente. Para obtener más información, consulte Ejemplo: denegar una AWS KMS clave específica para cifrar los secretos.
Para encontrar la clave de KMS asociada a un secreto, visualice el secreto en la consola o llame al ListSecrets o DescribeSecret. Cuando el secreto está asociado al Clave administrada de AWS para Secrets Manager (aws/secretsmanager), estas operaciones no devuelven un identificador de clave de KMS.
¿Qué se cifra?
Secrets Manager cifra el valor secreto, pero no cifra lo siguiente:
-
Nombre y descripción del secreto
-
Ajustes de rotación
-
ARN de la clave KMS asociada al secreto
-
¿Alguna adjunta? AWS etiquetas
Procesos de cifrado y descifrado
Para cifrar el valor de secreto en un secreto, Secrets Manager utiliza el siguiente proceso.
-
Secrets Manager llama al AWS KMS GenerateDataKey operación con el ID de la clave KMS del secreto y una solicitud de una clave simétrica AES de 256 bits. AWS KMS devuelve una clave de datos en texto plano y una copia de esa clave de datos cifrada con la clave KMS.
-
Secrets Manager utiliza la clave de datos en texto plano y el algoritmo del Estándar de cifrado avanzado (AES) para cifrar el valor secreto fuera de AWS KMS. Elimina la clave de texto no cifrado de la memoria lo antes posible tras utilizarla.
-
Secrets Manager almacena la clave de datos cifrada en los metadatos del secreto por lo que está disponible para descifrar el valor del secreto. Sin embargo, ninguna de las API de Secrets Manager devuelve el secreto cifrado o la clave de datos cifrada.
Para descifrar un valor de secreto cifrado:
-
Secrets Manager llama al AWS KMS Descifrar operación y pasa la clave de datos cifrada.
-
AWS KMS usa la clave KMS como secreto para descifrar la clave de datos. Devuelve la clave de datos de texto no cifrado.
-
Secrets Manager usa la clave de datos en texto no cifrado para descifrar el valor del secreto. A continuación, elimina la clave de datos de la memoria lo antes posible.
Permisos para la clave KMS
Cuando Secrets Manager utiliza una clave KMS en las operaciones criptográficas, actúa en nombre del usuario que está creando o modificando el valor del secreto. Puede conceder estos permisos en una política de IAM o en una política de claves. Las siguientes operaciones de Secrets Manager requieren AWS KMS permisos.
Para permitir que la clave de KMS se utilice únicamente en las solicitudes que se originan en Secrets Manager, en la política de permisos, puede utilizar el kms:ViaService clave de condición con el secretsmanager. valor.<Region>.amazonaws.com
También puede utilizar las claves o los valores en el contexto de cifrado como condición para utilizar la clave KMS para operaciones criptográficas. Por ejemplo, puedes usar un operador de condición de cadena en un documento de política clave o de IAM, o utilice un restricción de subvención en una subvención. AWS KMS la propagación de una subvención clave puede tardar hasta cinco minutos. Para obtener más información, consulte CreateGrant.
Cómo Secrets Manager utiliza su clave KMS
Secrets Manager llama a las siguientes AWS KMS operaciones con su clave de KMS.
- GenerateDataKey
-
Secrets Manager llama al AWS KMS GenerateDataKey operación en respuesta a las siguientes operaciones de Secrets Manager.
-
CreateSecret — Si el nuevo secreto incluye un valor secreto, Secrets Manager solicita una nueva clave de datos para cifrarlo.
-
PutSecretValue — Secrets Manager solicita una nueva clave de datos para cifrar el valor secreto especificado.
-
ReplicateSecretToRegions — Para cifrar el secreto replicado, Secrets Manager solicita una clave de datos para el AWS KMS clave en la región de la réplica.
-
UpdateSecret — Si cambias el valor secreto o la clave de KMS, Secrets Manager solicita una nueva clave de datos para cifrar el nuevo valor secreto.
El RotateSecret la operación no llama
GenerateDataKey, porque no cambia el valor secreto. No obstante, si la función de Lambda queRotateSecretinvoca cambia el valor del secreto, su llamada a la operaciónPutSecretValueactiva unaGenerateDataKeysolicitud. -
- Decrypt
-
Secrets Manager llama a la operación Decrypt en respuesta a las siguientes operaciones de Secrets Manager.
-
GetSecretValue y BatchGetSecretValue — Secrets Manager descifra el valor secreto antes de devolverlo a la persona que llama. Para descifrar un valor secreto cifrado, Secrets Manager llama al AWS KMS Descifrar operación para descifrar la clave de datos cifrada en el secreto. A continuación, usa la clave de datos en texto no cifrado para descifrar el valor del secreto cifrado. Para los comandos por lotes, Secrets Manager puede reutilizar la clave descifrada, por lo que no todas las llamadas dan lugar a una
Decryptsolicitud. -
PutSecretValue y UpdateSecret — La mayoría
PutSecretValueyUpdateSecretlas solicitudes no activan unDecryptoperación. Sin embargo, cuando una solicitudPutSecretValueoUpdateSecretintenta cambiar el valor del secreto en una versión existente de un secreto, Secrets Manager descifra el valor del secreto existente y lo compara con el valor del secreto en la solicitud para confirmar que son iguales. Esta acción garantiza que las operaciones de Secrets Manager son idempotentes. Para descifrar un valor secreto cifrado, Secrets Manager llama al AWS KMS Descifrar operación para descifrar la clave de datos cifrada en el secreto. A continuación, usa la clave de datos en texto no cifrado para descifrar el valor del secreto cifrado. -
ReplicateSecretToRegions — El administrador de secretos primero descifra el valor secreto en la región principal antes de volver a cifrar el valor secreto con AWS KMS clave en la región de la réplica.
-
AssociateCrossAccountReplica — Secrets Manager realiza una llamada de descifrado sin procesar con la clave KMS del secreto principal. Esta llamada confirma que la persona que llama tiene permisos para usar la clave. Durante la replicación, Secrets Manager descifrará la clave de datos de la versión secreta principal antes de volver a cifrar la clave de datos en texto sin formato con la clave KMS del secreto de réplica.
-
- Encrypt
-
Secrets Manager llama a la operación Encrypt en respuesta a las siguientes operaciones de Secrets Manager:
-
UpdateSecret — Si cambia la clave de KMS, Secrets Manager vuelve a cifrar la clave de datos que protege la
AWSCURRENT,AWSPREVIOUS, yAWSPENDINGversiones secretas con la nueva clave. -
AssociateCrossAccountReplica — Secrets Manager realiza una llamada de cifrado ejecutada en seco con la clave KMS del secreto de la réplica. Esta llamada confirma que la persona que llama a la cuenta principal tiene permiso para usar la clave de KMS del secreto de la réplica para la replicación entre cuentas. Durante la replicación, Secrets Manager descifrará la clave de datos de la versión secreta principal antes de volver a cifrar la clave de datos en texto sin formato con la clave KMS del secreto de réplica.
-
- DescribeKey
-
Secrets Manager llama al DescribeKey operación para determinar si se deben incluir los AWS KMS clave al crear o editar un secreto en la consola de Secrets Manager.
- Validación del acceso a la clave KMS
-
Al establecer o cambiar la clave KMS asociada con el secreto, Secrets Manager llama a las operaciones
GenerateDataKeyyDecryptcon la clave KMS especificada. Estas llamadas confirman que el intermediario tiene permiso para utilizar la clave KMS para estas operaciones. Secrets Manager descarta los resultados de estas operaciones; no las utiliza en ninguna operación criptográfica.Puede identificar estas llamadas de validación, ya que el valor del
SecretVersionIdcontexto de cifrado de la clave en estas solicitudes esRequestToValidateKeyAccess.notaEn el pasado, las llamadas de validación de Secrets Manager no incluían un contexto de cifrado. Es posible que encuentres llamadas sin contexto de cifrado en versiones anteriores AWS CloudTrail registros.
Política clave del Clave administrada de AWS (aws/secretsmanager)
La política clave para la Clave administrada de AWS para Secrets Manager (aws/secretsmanager) otorga a los usuarios permiso para usar la clave de KMS para operaciones específicas solo cuando Secrets Manager realiza la solicitud en nombre del usuario. La política de claves no permite a ningún usuario utilizar la clave KMS directamente.
Esta política de claves, como las políticas de todas las Claves administradas de AWS, la establece el servicio. No puede cambiar la política de claves, pero puede verla en cualquier momento. Para obtener más detalles, consulte Ver una política de clave.
Las declaraciones de política de la política de claves tienen el siguiente efecto:
-
Permitir a los usuarios de la cuenta utilizar la clave KMS para operaciones criptográficas solo cuando la solicitud proviene de Secrets Manager en su nombre. La clave de condición
kms:ViaServiceaplica esta restricción. -
Permite la AWS cuenta para crear políticas de IAM que permitan a los usuarios ver las propiedades clave de KMS y revocar las concesiones.
-
Aunque Secrets Manager no utiliza concesiones para obtener acceso a la clave de KMS, la política también permite a Secrets Manager crear concesiones para la clave KMS en nombre del usuario y permite a la cuenta revocar cualquier concesión que permite a Secrets Manager usar la clave KMS. Estos son los elementos estándar del documento de política para un Clave administrada de AWS.
La siguiente es una política clave a modo de ejemplo Clave administrada de AWS para Secrets Manager.
Contexto de cifrado en Secrets Manager
Un contexto de cifrado es un conjunto de pares de clave-valor que contienen datos no secretos arbitrarios. Al incluir un contexto de cifrado en una solicitud para cifrar datos, AWS KMS vincula criptográficamente el contexto de cifrado a los datos cifrados. Para descifrar los datos, es necesario pasar el mismo contexto de cifrado.
En su GenerateDataKey y Descifrar solicita a AWS KMS, Secrets Manager usa un contexto de cifrado con dos pares de nombre y valor que identifican el secreto y su versión, como se muestra en el siguiente ejemplo. Los nombres no varían, pero los valores de contexto de cifrado combinado serán diferentes para cada valor de secreto.
"encryptionContext": { "SecretARN": "arn:aws:secretsmanager:us-east-2:111122223333:secret:test-secret-a1b2c3", "SecretVersionId": "EXAMPLE1-90ab-cdef-fedc-ba987SECRET1" }
Puede usar el contexto de cifrado para identificar estas operaciones criptográficas en los registros y registros de auditoría, como AWS CloudTrail y Amazon CloudWatch Registros y como condición para la autorización en políticas y subvenciones.
El contexto de cifrado de Secrets Manager se compone de dos pares de nombre-valor.
-
SecretARN: el primer par de nombre-valor identifica el secreto. La clave es
SecretARN. El valor es el Nombre de recurso de Amazon (ARN) del secreto."SecretARN": "ARN of an Secrets Manager secret"Por ejemplo, si el ARN del secreto fuera
arn:aws:secretsmanager:us-east-2:111122223333:secret:test-secret-a1b2c3, el contexto de cifrado incluiría el siguiente par."SecretARN": "arn:aws:secretsmanager:us-east-2:111122223333:secret:test-secret-a1b2c3" -
SecretVersionId — El segundo par nombre-valor identifica la versión del secreto. La clave es
SecretVersionId. El valor es el ID de la versión."SecretVersionId": "<version-id>"Por ejemplo, si el ID de versión del secreto fuera
EXAMPLE1-90ab-cdef-fedc-ba987SECRET1, el contexto de cifrado incluiría el siguiente par."SecretVersionId": "EXAMPLE1-90ab-cdef-fedc-ba987SECRET1"
Al establecer o cambiar la clave de KMS de un secreto, Secrets Manager envía GenerateDataKey y Descifrar solicita a AWS KMS para validar que la persona que llama tiene permiso para usar la clave KMS para estas operaciones. Descarta las respuestas; no las utiliza en el valor del secreto.
En estos solicitudes de validación, el valor de SecretARN es el ARN real del secreto, pero el valor SecretVersionId es RequestToValidateKeyAccess, tal y como se muestra en el siguiente ejemplo de contexto de cifrado. Este valor especial le ayudará a identificar las solicitudes de validación en los registros y las pistas de auditoría.
"encryptionContext": { "SecretARN": "arn:aws:secretsmanager:us-east-2:111122223333:secret:test-secret-a1b2c3", "SecretVersionId": "RequestToValidateKeyAccess" }
En el pasado, las solicitudes de validación de Secrets Manager no incluían un contexto de cifrado. Es posible que encuentres llamadas sin contexto de cifrado en versiones anteriores AWS CloudTrail registros.
Supervise la interacción de Secrets Manager con AWS KMS
Puede usar AWS CloudTrail y Amazon CloudWatch Registros para rastrear las solicitudes a las que Secrets Manager envía AWS KMS en su nombre. Para obtener más información acerca del monitoreo del uso de los secretos, consulte Supervise AWS Secrets Manager los secretos.
- GenerateDataKey
-
Cuando creas o cambias el valor secreto de un secreto, Secrets Manager envía un GenerateDataKey solicitud a AWS KMS que especifica la clave KMS del secreto.
El evento que registra la operación
GenerateDataKeyes similar al siguiente evento de ejemplo. La solicitud la invocasecretsmanager.amazonaws.com. Los parámetros incluyen el nombre de recurso de Amazon (ARN) de la clave KMS para el secreto, un especificador de clave que requiere una clave de 256 bits y el contexto de cifrado que identifica el secreto y la versión.{ "eventVersion": "1.05", "userIdentity": { "type": "IAMUser", "principalId": "AROAIGDTESTANDEXAMPLE:user01", "arn": "arn:aws:sts::111122223333:assumed-role/Admin/user01", "accountId": "111122223333", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "sessionContext": { "attributes": { "mfaAuthenticated": "false", "creationDate": "2018-05-31T23:23:41Z" } }, "invokedBy": "secretsmanager.amazonaws.com" }, "eventTime": "2018-05-31T23:23:41Z", "eventSource": "kms.amazonaws.com", "eventName": "GenerateDataKey", "awsRegion": "us-east-2", "sourceIPAddress": "secretsmanager.amazonaws.com", "userAgent": "secretsmanager.amazonaws.com", "requestParameters": { "keyId": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", "keySpec": "AES_256", "encryptionContext": { "SecretARN": "arn:aws:secretsmanager:us-east-2:111122223333:secret:test-secret-a1b2c3", "SecretVersionId": "EXAMPLE1-90ab-cdef-fedc-ba987SECRET1" } }, "responseElements": null, "requestID": "a7d4dd6f-6529-11e8-9881-67744a270888", "eventID": "af7476b6-62d7-42c2-bc02-5ce86c21ed36", "readOnly": true, "resources": [ { "ARN": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", "accountId": "111122223333", "type": "AWS::KMS::Key" } ], "eventType": "AwsApiCall", "recipientAccountId": "111122223333" } - Decrypt
-
Cuando obtiene o cambia el valor secreto de un secreto, Secrets Manager envía un Descifrar solicitar a AWS KMS para descifrar la clave de datos cifrada. Para los comandos por lotes, Secrets Manager puede reutilizar la clave descifrada, por lo que no todas las llamadas dan lugar a una
Decryptsolicitud.El evento que registra la operación
Decryptes similar al siguiente evento de ejemplo. El usuario es el principal de su AWS cuenta que está accediendo a la tabla. Los parámetros incluyen la clave de la tabla cifrada (como un blob de texto cifrado) y el contexto de cifrado que identifica la tabla y el AWS cuenta. AWS KMS deriva el ID de la clave KMS del texto cifrado.{ "eventVersion": "1.05", "userIdentity": { "type": "IAMUser", "principalId": "AROAIGDTESTANDEXAMPLE:user01", "arn": "arn:aws:sts::111122223333:assumed-role/Admin/user01", "accountId": "111122223333", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "sessionContext": { "attributes": { "mfaAuthenticated": "false", "creationDate": "2018-05-31T23:36:09Z" } }, "invokedBy": "secretsmanager.amazonaws.com" }, "eventTime": "2018-05-31T23:36:09Z", "eventSource": "kms.amazonaws.com", "eventName": "Decrypt", "awsRegion": "us-east-2", "sourceIPAddress": "secretsmanager.amazonaws.com", "userAgent": "secretsmanager.amazonaws.com", "requestParameters": { "encryptionContext": { "SecretARN": "arn:aws:secretsmanager:us-east-2:111122223333:secret:test-secret-a1b2c3", "SecretVersionId": "EXAMPLE1-90ab-cdef-fedc-ba987SECRET1" } }, "responseElements": null, "requestID": "658c6a08-652b-11e8-a6d4-ffee2046048a", "eventID": "f333ec5c-7fc1-46b1-b985-cbda13719611", "readOnly": true, "resources": [ { "ARN": "arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab", "accountId": "111122223333", "type": "AWS::KMS::Key" } ], "eventType": "AwsApiCall", "recipientAccountId": "111122223333" } - Encrypt
-
Cuando cambias el AWS KMS clave asociada a un secreto, Secrets Manager envía un Cifrar solicitar a AWS KMS para volver a cifrar el
AWSCURRENT,AWSPREVIOUS, yAWSPENDINGversiones secretas con la nueva clave. Cuando replica un secreto en otra región, Secrets Manager también envía una solicitud Encrypt a AWS KMS.El evento que registra la operación
Encryptes similar al siguiente evento de ejemplo. El usuario es el principal de su AWS cuenta que está accediendo a la tabla.{ "eventVersion": "1.08", "userIdentity": { "type": "IAMUser", "principalId": "AROAIGDTESTANDEXAMPLE:user01", "arn": "arn:aws:sts::111122223333:assumed-role/Admin/user01", "accountId": "111122223333", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "sessionContext": { "attributes": { "creationDate": "2023-06-09T18:11:34Z", "mfaAuthenticated": "false" } }, "invokedBy": "secretsmanager.amazonaws.com" }, "eventTime": "2023-06-09T18:11:34Z", "eventSource": "kms.amazonaws.com", "eventName": "Encrypt", "awsRegion": "us-east-2", "sourceIPAddress": "secretsmanager.amazonaws.com", "userAgent": "secretsmanager.amazonaws.com", "requestParameters": { "keyId": "arn:aws:kms:us-east-2:111122223333:key/EXAMPLE1-f1c8-4dce-8777-aa071ddefdcc", "encryptionAlgorithm": "SYMMETRIC_DEFAULT", "encryptionContext": { "SecretARN": "arn:aws:secretsmanager:us-east-2:111122223333:secret:ChangeKeyTest-5yKnKS", "SecretVersionId": "EXAMPLE1-5c55-4d7c-9277-1b79a5e8bc50" } }, "responseElements": null, "requestID": "129bd54c-1975-4c00-9b03-f79f90e61d60", "eventID": "f7d9ff39-15ab-47d8-b94c-56586de4ab68", "readOnly": true, "resources": [ { "accountId": "AWS Internal", "type": "AWS::KMS::Key", "ARN": "arn:aws:kms:us-west-2:111122223333:key/EXAMPLE1-f1c8-4dce-8777-aa071ddefdcc" } ], "eventType": "AwsApiCall", "managementEvent": true, "recipientAccountId": "111122223333", "eventCategory": "Management" }
AWS KMS claves para la replicación entre cuentas
Cuando replicas un secreto a otro AWS debes cifrar el secreto de la réplica con una clave de KMS administrada por el cliente en la cuenta de réplica. El secreto de la réplica no puede usar la Clave administrada de AWS aws/secretsmanager, porque Claves administradas de AWS no admiten el acceso multicuenta. Para obtener más información sobre la replicación entre cuentas, consulte Cross-account replicación.
Para permitir que Secrets Manager vuelva a cifrar el valor secreto de la clave de réplica, actualice el política de claves de la clave KMS de réplica para que autorice a la cuenta principal a llamar kms:Encrypt. Secrets Manager descifra el valor secreto con la clave del secreto principal y lo vuelve a cifrar con la clave de réplica.
Si lo desea, defina la política de claves de réplica con la Contexto de cifrado SecretarN para que la cuenta principal pueda usar la clave de réplica solo para el secreto de la réplica. El valor del contexto de cifrado es el ARN del secreto de la réplica. Para ver un ejemplo de declaración de política clave, consulte Crea un secreto de réplica.