View a markdown version of this page

Subvenciones en AWS KMS - AWS Key Management Service

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.

Subvenciones en AWS KMS

UN beca es un instrumento de política que permite AWS directores o AWS directores de servicio para usar claves de KMS en operaciones criptográficas. También puede permitirles ver una clave KMS (DescribeKey) y crear y administrar concesiones. Al autorizar el acceso a una clave KMS, se consideran concesiones junto con políticas de claves y políticas de IAM. Las concesiones se utilizan a menudo para permisos temporales, ya que puede crear uno, utilizar sus permisos y eliminarlo sin cambiar las políticas de claves o las políticas de IAM.

Las subvenciones suelen ser utilizadas por AWS servicios que se integran con AWS KMS para cifrar sus datos en reposo. El servicio crea una concesión en nombre de un usuario de la cuenta, utiliza sus permisos y retira la concesión tan pronto como finalice su tarea. Para obtener más información sobre cómo AWS servicios, utilice subvenciones, consulte el Cifrado en reposo tema de la guía del usuario o la guía del desarrollador del servicio.

Las concesiones son un mecanismo de control de acceso muy flexible y útil. Al crear una concesión para una clave de KMS, la concesión permite a las entidades principales beneficiarias llamar a las operaciones de concesión especificadas en la clave de KMS siempre que se cumplan todas las condiciones especificadas en la concesión.

  • Cada concesión permite el acceso a exactamente una clave KMS. Puede crear una concesión para una clave KMS en una Cuenta de AWS diferente.

  • Una concesión puede permitir el acceso a una clave KMS, pero no denegar el acceso.

  • Cada subvención tiene un beneficiario, que puede ser un director del concesionario (un AWS (identidad de IAM) o un principal del servicio cedido (un AWS director de servicio). Debe especificar GranteePrincipal o GranteeServicePrincipal, pero no ambos.

  • Una concesión solo puede permitir operaciones de concesión. Las operaciones de concesión deben estar respaldadas por la clave KMS de la concesión. Si especifica una operación no admitida, el CreateGrant la solicitud falla con un ValidationError excepción.

  • La entidad principal beneficiaria puede utilizar los permisos que la concesión le otorga sin especificar la concesión, tal como lo haría si los permisos procedieran de una política de clave o de una política de IAM. Sin embargo, debido a que el AWS KMS La API sigue un coherencia eventual modelo, al crear, retirar o revocar una subvención, puede haber un breve retraso antes de que el cambio esté disponible en todo momento AWS KMS. Para utilizar los permisos de una concesión inmediatamente, use un token de concesión.

  • Un beneficiario principal autorizado puede eliminar la concesión (retirarla o revocarla). Al eliminar una concesión se eliminan todos los permisos permitidos por la concesión. No es necesario averiguar qué políticas se deben agregar o quitar para deshacer la concesión.

  • AWS KMS limita la cantidad de concesiones en cada clave de KMS. Para obtener más información, consulte Concesiones por clave KMS: 50 000.

Tenga cuidado al crear concesiones y al dar permiso a otros para crear concesiones. El permiso para crear subvenciones tiene implicaciones de seguridad, al igual que permitir que km:PutKeyPolicy permiso para establecer políticas.

  • Usuarios con permiso para crear concesiones para una clave de KMS (kms:CreateGrant) pueden usar una concesión para permitir la entrada de usuarios y roles, incluidos AWS servicios, para usar la clave KMS. Los principales pueden ser identidades propias Cuenta de AWS o identidades en una cuenta u organización diferente.

  • Las subvenciones solo pueden permitir un subconjunto de AWS KMS operaciones. Puede utilizar concesiones para permitir a los principales beneficiarios ver la clave KMS, utilizarla en operaciones criptográficas y crear y retirar concesiones. Para obtener más información, consulte Operaciones de concesión. También puede utilizar restricciones de la concesión para limitar los permisos de una concesión.

  • Las entidades principales pueden obtener permiso para crear concesiones a partir de una política de claves o de una política de IAM. Las entidades principales que reciben el permiso kms:CreateGrant de una política puede crear concesiones para cualquier operación de concesión en la clave KMS. Estas entidades principales no necesitan tener el permiso que conceden en la clave. Cuando se permite permiso kms:CreateGrant en una política, puede usar condiciones de política para limitar este permiso.

  • Los principales beneficiarios también pueden obtener permiso para crear concesiones a partir de una concesión. Estas entidades principales solo pueden delegar los permisos que se les concedieron, incluso si tienen otros permisos de una política. Para obtener más información, consulte Concesión CreateGrant permiso.

Conceptos de concesión

Para utilizar las concesiones de manera efectiva, deberá comprender los términos y conceptos que AWS KMS utiliza.

Restricción de concesiones

Condición que limita los permisos de una concesión. AWS KMS admite dos tipos de restricciones de concesión:

  • restricción de contexto de cifrado — Restringe los permisos en función de contexto de cifrado incluido en la solicitud de una operación criptográfica. Esta restricción solo funciona con claves KMS de cifrado simétrico.

  • SourceArn restricción — Restringe la concesión de permisos a las solicitudes realizadas en nombre de una persona específica AWS recurso. Esto es poner de manera efectiva un aws:SourceArn La condición global es clave en la subvención. Esta restricción funciona con todos los tipos de claves KMS.

Para obtener más información, consulte Uso de restricciones de concesiones.

ID de concesión

El identificador único de una concesión de una clave KMS. Puedes usar un identificador de concesión, junto con un identificador clave, para identificar una subvención en un RetireGrant o RevokeGrant solicitud.

Operaciones de concesión

El AWS KMS operaciones que puede permitir en una subvención. Si especifica otras operaciones, el CreateGrant la solicitud falla con un ValidationError excepción. Estas son también las operaciones que aceptan un token de concesión. Para obtener información detallada sobre estos permisos, consulte la AWS KMS permisos.

Estas operaciones de concesión representan realmente permiso para usar la operación. Por lo tanto, para la operación ReEncrypt, puede especificar ReEncryptFrom, ReEncryptTo o ambos ReEncrypt*.

Las operaciones de concesión son:

Las operaciones de concesión que usted permita deben ser compatibles con la clave KMS de la concesión. Si especifica una operación no admitida, el CreateGrant la solicitud falla con un ValidationError excepción. Por ejemplo, las concesiones para claves KMS de cifrado simétricas no pueden permitir las operaciones Firmar, Verificar GenerateMac o VerifyMac. Las concesiones para claves CMK asimétricas no pueden permitir operaciones que generen claves de datos o pares de claves de datos.

Token de concesión

El AWS KMS La API sigue un coherencia eventual modelo. Al crear una concesión, es posible que haya un breve retraso antes de que el cambio esté disponible a través de AWS KMS. Por lo general, el cambio tarda menos de unos segundos en propagarse por todo el sistema, pero en algunos casos puede tardar varios minutos. Si intenta utilizar una concesión antes de que se propague por completo por el sistema, es posible que obtenga un error de acceso denegado. Un token de concesión le permite hacer referencia a la concesión y utilizar los permisos de concesión inmediatamente.

Un token de concesión es una cadena única, no secreta, de longitud variable, codificada en base64 que representa una concesión. Puede usar el token de concesión para identificar la concesión en cualquier operación de concesión. Sin embargo, debido a que el valor del token es un resumen hash, no revela ningún detalle sobre la concesión.

Un token de concesión está diseñado para utilizarse solo hasta que la concesión se haya propagado por completo a través de AWS KMS. Después de eso, el principal beneficiario puede utilizar el permiso de la concesión sin proporcionar un token de concesión ni cualquier otra prueba de la concesión. Puedes usar un token de subvención en cualquier momento, pero una vez que la subvención sea consistente, AWS KMS usa la concesión para determinar los permisos, no el token de concesión.

Por ejemplo, el siguiente comando llama al GenerateDataKey operación. Utiliza un token de concesión para representar la concesión que da a la persona que llama (el principal beneficiario) permiso para llamar a GenerateDataKey en la clave KMS especificada.

$ aws kms generate-data-key \ --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \ --key-spec AES_256 \ --grant-token $token

También puede utilizar un token de concesión para identificar una concesión en operaciones que administran concesiones. Por ejemplo, el director jubilado puede usar un token de concesión en una llamada al RetireGrant operación.

$ aws kms retire-grant \ --grant-token $token

CreateGrant es la única operación que devuelve un token de concesión. No puedes obtener un token de subvención de ningún otro AWS KMS operación o desde CloudTrail registrar un evento para el CreateGrant operación. El ListGrants y ListRetirableGrants las operaciones devuelven el ID de concesión, pero no un token de concesión.

Para obtener más información, consulte Uso de un token de concesión.

Principal beneficiario

¿Un AWS principal (identidad de IAM) que obtiene los permisos especificados en la concesión.

El director del concesionario puede ser cualquiera AWS principal, incluido un Cuenta de AWS (raíz), un usuario de IAM, un Función de IAM, un rol o usuario federado, o un usuario con rol asumido. El principal del beneficiario puede estar en la misma cuenta que la clave KMS o en una cuenta diferente. Sin embargo, el principal beneficiario no puede ser una entidad principal del servicio, un grupo de IAM o una organización de AWS.

Para especificar el director del concesionario, utilice el GranteePrincipal parámetro en el CreateGrant solicitud.

nota

Las prácticas recomendadas de IAM desalientan el uso de usuarios de IAM con credenciales a largo plazo. Siempre que sea posible, utilice los roles de IAM, que proporcionan credenciales temporales. Para obtener más información, consulte la sección Prácticas recomendadas de seguridad de IAM en la Guía del usuario de IAM;.

Director del servicio del concesionario

¿Un AWS director de servicio que obtiene los permisos especificados en la concesión. Para especificar el director del servicio cesionario, utilice el GranteeServicePrincipal parámetro en el CreateGrant solicitud.

Cuando creas una subvención con un GranteeServicePrincipal, también debes incluir un SourceArn grant constraint. El SourceArn la restricción garantiza que el principal del servicio pueda usar la clave de KMS solo cuando la solicitud se realiza en nombre de la persona especificada AWS recurso.

Cuando especificas un GranteeServicePrincipal, también debe especificar un RetiringPrincipal o un RetiringServicePrincipal.

nota

Debe especificar GranteePrincipal o GranteeServicePrincipal, pero no ambos.

Retiro (de una concesión)

Termina una concesión. Retire una concesión cuando termine de usar los permisos.

La revocación y el retiro de una concesión eliminan la concesión. Sin embargo, el retiro se realiza por medio de una entidad principal especificada en la concesión. La revocación suele realizarla un administrador de claves. Para obtener más información, consulte Retiro y revocación de concesiones.

Entidad principal que se va a dar de baja

Una entidad principal que puede retirar una concesión. Puede especificar una entidad principal que se va a dar de baja en una concesión, pero no es necesario. El director que se jubila puede ser cualquiera AWS principal, que incluye Cuentas de AWS, usuarios de IAM, funciones de IAM, usuarios federados y usuarios con funciones asumidas. La entidad principal que se va a dar de baja puede estar en la misma cuenta de que la clave KMS o en una cuenta diferente.

Para especificar el director que se retira, utilice el RetiringPrincipal parámetro en el CreateGrant solicitud.

nota

Las prácticas recomendadas de IAM desalientan el uso de usuarios de IAM con credenciales a largo plazo. Siempre que sea posible, utilice los roles de IAM, que proporcionan credenciales temporales. Para obtener más información, consulte la sección Prácticas recomendadas de seguridad de IAM en la Guía del usuario de IAM;.

Director del servicio que se jubila

¿Un AWS director de servicio que tiene permiso para retirar una beca. Para especificar el director del servicio que se jubila, utilice el RetiringServicePrincipal parámetro en el CreateGrant solicitud.

nota

Puede especificar RetiringPrincipal o RetiringServicePrincipal, pero no ambos.

Para obtener más información sobre quién puede retirar una subvención, consulte Retiro y revocación de concesiones.

Revocación (de una concesión)

Termina una concesión. Puede revocar una concesión para denegar activamente los permisos que permite la concesión.

La revocación y el retiro de una concesión eliminan la concesión. Sin embargo, el retiro se realiza por medio de una entidad principal especificada en la concesión. La revocación suele realizarla un administrador de claves. Para obtener más información, consulte Retiro y revocación de concesiones.

Consistencia final (para las concesiones)

El AWS KMS La API sigue un coherencia eventual modelo. Al crear, retirar o revocar una concesión, es posible que haya un breve retraso antes de que el cambio esté disponible a través de AWS KMS. Por lo general, el cambio tarda menos de unos segundos en propagarse por todo el sistema, pero en algunos casos puede tardar varios minutos.

Puede darse cuenta de este breve retraso si recibe errores inesperados. Por ejemplo, si intentas gestionar una nueva concesión o utilizar los permisos de una nueva concesión antes de que la concesión se conozca en su totalidad AWS KMS, es posible que recibas un error de acceso denegado. Si retira o revoca una concesión, es posible que el principal beneficiario pueda seguir utilizando sus permisos durante un breve período hasta que la concesión se elimine por completo. La estrategia típica es volver a intentar la solicitud, y algunas AWS Los SDK incluyen una lógica automática de retroceso y reintento.

AWS KMS tiene funciones para mitigar este breve retraso.

nota

Los tokens de concesión reemplazan la validez de la concesión hasta que todos los puntos de conexión del servicio se hayan actualizado con el nuevo estado de concesión. En la mayoría de los casos, la consistencia final se logrará en cinco minutos.

Para obtener más información, consulte Coherencia final de AWS KMS.