View a markdown version of this page

Registro AWS KMS Llamadas a la API con AWS CloudTrail - 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.

Registro AWS KMS Llamadas a la API con AWS CloudTrail

AWS KMS está integrado con AWS CloudTrail, un servicio que graba todas las llamadas a AWS KMS por usuarios, roles y otros AWS servicios. CloudTrail captura todas las llamadas de API a AWS KMS como eventos, incluidas las llamadas desde AWS KMS consola, AWS KMS API, CloudFormation plantillas, las AWS Command Line Interface (AWS CLI), y Herramientas de AWS para PowerShell.

CloudTrail registra todo AWS KMS operaciones, incluidas las operaciones de solo lectura, como ListAliases y GetKeyRotationStatus, operaciones que administran las claves de KMS, como CreateKey y PutKeyPolicy, y operaciones criptográficas, como GenerateDataKey y Descifrar. También registra las operaciones internas que AWS KMS te llama, como DeleteExpiredKeyMaterial, DeleteKey, SynchronizeMultiRegionKey, y RotateKey.

CloudTrail registra todas las operaciones realizadas correctamente y, en algunos casos, los intentos de llamadas que han fallado, como cuando se niega el acceso a un recurso a la persona que llama. Cross-account operaciones en claves de KMS están registrados tanto en la cuenta de la persona que llama como en la cuenta del propietario de la clave de KMS. Sin embargo, multicuenta AWS KMS las solicitudes que se rechazan porque se deniega el acceso solo se registran en la cuenta de la persona que llama.

Por motivos de seguridad, se omiten algunos campos AWS KMS entradas de registro, como Plaintext parámetro de un Cifrar la solicitud y la respuesta a GetKeyPolicy o cualquier operación criptográfica. Para facilitar la búsqueda CloudTrail entradas de registro para determinadas claves de KMS, AWS KMS agrega el clave ARN de la clave KMS afectada para el responseElements campo en las entradas de registro para algunas AWS KMS operaciones de administración de claves, incluso cuando la operación de la API no devuelva el ARN de la clave.

Aunque de forma predeterminada, todos AWS KMS las acciones se registran como CloudTrail eventos, puedes excluir AWS KMS acciones de un CloudTrail sendero. Para obtener más información, consulte Excluyendo AWS KMS eventos de un sendero.

Más información:

Resultado AWS KMS registrar entradas en CloudTrail

Para buscar CloudTrail registre las entradas, utilice el CloudTrail consola o el CloudTrail LookupEvents operación. CloudTrail admite numerosos valores de atributos para filtrar la búsqueda, incluidos el nombre del evento, el nombre de usuario y la fuente del evento.

Para ayudarte a buscar AWS KMS iniciar sesión en CloudTrail, AWS KMS rellena lo siguiente CloudTrail campos de entrada de registro.

nota

A partir de diciembre de 2022, AWS KMS llena el Tipo de recurso y Nombre del recurso atributos en todas las operaciones de administración que cambian una clave de KMS determinada. Estos valores de atributos pueden ser nulos en versiones anteriores CloudTrail entradas para las siguientes operaciones: CreateAlias, CreateGrant, DeleteAlias, DeleteImportedKeyMaterial, ImportKeyMaterial, ReplicateKey, RetireGrant, RevokeGrant, UpdateAlias, y UpdatePrimaryRegion.

Atributo Valor Entradas de registro
Fuente del evento (EventSource) kms.amazonaws.com Todas las operaciones.
Tipo de recurso (ResourceType) AWS::KMS::Key Operaciones de administración que cambian una clave de KMS en particular, como CreateKey y EnableKey, pero no ListKeys.
Nombre del recurso (ResourceName) ARN de clave (o ID de clave y ARN de clave) Operaciones de administración que cambian una clave de KMS en particular, como CreateKey y EnableKey, pero no ListKeys.

Para ayudarlo a encontrar las entradas de registro para las operaciones de administración en determinadas claves de KMS, AWS KMS registra la clave ARN de la clave de KMS afectada en el responseElements.keyId elemento de la entrada de registro, incluso cuando el AWS KMS La operación de la API no devuelve el ARN de la clave.

Por ejemplo, una llamada correcta al DisableKey la operación no devuelve ningún valor en la respuesta, pero en lugar de un valor nulo, el responseElements.keyId valor en el DisableKey entrada de registro incluye la clave ARN de la clave KMS deshabilitada.

Esta función se añadió en diciembre de 2022 y afecta a lo siguiente CloudTrail entradas de registro: CreateAlias, CreateGrant, DeleteAlias, DeleteKey, DisableKey, EnableKey, EnableKeyRotation, ImportKeyMaterial, RotateKey, SynchronizeMultiRegionKey, TagResource, UntagResource, UpdateAlias, y UpdatePrimaryRegion.

Excluyendo AWS KMS eventos de un sendero

Para proporcionar un registro del uso y la gestión de sus AWS KMS recursos, la mayoría AWS KMS los usuarios confían en los eventos de un CloudTrail sendero. La ruta puede ser una fuente valiosa de datos para auditar eventos críticos, como la creación, la desactivación y la eliminación AWS KMS keys, el cambio de la política de claves y el uso de sus claves de KMS mediante AWS servicios en su nombre. En algunos casos, los metadatos de un CloudTrail entrada de registro, como la contexto de cifrado en una operación de cifrado, puede ayudarle a evitar o resolver errores.

Sin embargo, porque AWS KMS puede generar una gran cantidad de eventos, AWS CloudTrail le permite excluir AWS KMS eventos de un sendero. Esta configuración por sendero excluye todos AWS KMS eventos; no puedes excluir en particular AWS KMS eventos.

aviso

Excluyendo AWS KMS eventos de un CloudTrail El registro puede ocultar las acciones que utilizan sus claves de KMS. Actúe con precaución al conceder a las entidades principales el permiso cloudtrail:PutEventSelectors necesario para realizar esta operación.

Para excluir AWS KMS eventos de una ruta:

Puede desactivar esta exclusión en cualquier momento cambiando la configuración de la consola o los selectores de eventos de un registro de seguimiento. La ruta comenzará entonces a grabarse AWS KMS eventos. Sin embargo, no puede recuperarse AWS KMS eventos que ocurrieron mientras la exclusión estaba en vigor.

Cuando excluyes AWS KMS eventos mediante la consola o la API, el resultado CloudTrail PutEventSelectors La operación de la API también se registra en su CloudTrail Registros. Si AWS KMS los eventos no aparecen en tu CloudTrail Registros, busca un PutEventSelectors evento con el ExcludeManagementEventSources atributo establecido en kms.amazonaws.com.