Configuración de notificaciones de Amazon SNS para CloudTrail - AWS CloudTrail

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.

Configuración de notificaciones de Amazon SNS para CloudTrail

Puede recibir una notificación cada vez que CloudTrail publique nuevos archivos de registros en su bucket de Amazon S3. Puede administrar las notificaciones mediante Amazon Simple Notification Service (Amazon SNS)

Las notificaciones son opcionales. Si desea recibir notificaciones, configure CloudTrail para que envíe información actualizada sobre un tema de Amazon SNS cada vez que se envíe un archivo de registros nuevo. Para recibir estas notificaciones, puede utilizar Amazon SNS para suscribirse al tema Como suscriptor puede obtener las actualizaciones enviadas a una cola de Amazon Simple Queue Service (Amazon SQS), lo que le permite gestionar estas notificaciones mediante programación.

Configuración de CloudTrail para el envío de notificaciones

Puede configurar un registro de seguimiento para utilizar un tema de Amazon SNS. Puede utilizar la consola de CloudTrail o el comando de la CLI aws cloudtrail create-trail para crear el tema. CloudTrail crea el tema de Amazon SNS automáticamente y adjunta una política adecuada, de forma que CloudTrail tenga permiso para publicar en ese tema.

Los nombres de tema de SNS creados deben cumplir los siguientes requisitos:

  • Deben tener entre 1 y 256 caracteres.

  • Deben contener letras ASCII en mayúsculas y minúsculas, números, guiones bajos o guiones.

Cuando configure notificaciones para un registro de seguimiento aplicable a todas las regiones, las notificaciones de todas las regiones se envían al tema de Amazon SNS que haya especificado. Si tiene uno o varios registros de seguimiento específicos de una región, será preciso que cree un tema para cada región y que se suscriba a cada uno por individual.

Para recibir notificaciones, suscríbase al tema o los temas de Amazon SNS que utiliza CloudTrail. Esto se hace con la consola de Amazon SNS o los comandos de la CLI de Amazon SNS. Para obtener más información, consulte Suscripción a un tema de Amazon SNS en la Guía para desarrolladores de Amazon Simple Notification Service.

nota

CloudTrail envía una notificación cuando los archivos de registros se escriben en el bucket de Amazon S3. Las cuentas activas pueden generar un gran número de notificaciones. Si se suscribe mediante correo electrónico o SMS, puede recibir un gran volumen de mensajes. Se recomienda que se suscriba con Amazon Simple Queue Service (Amazon SQS), puesto que le permite gestionar las notificaciones mediante programación. Para obtener más información, consulte Suscripción de una cola de Amazon SQS a un tema de Amazon SNS (consola) en la Guía para desarrolladores de Amazon Simple Queue Service.

La notificación de Amazon SNS consta de un objeto JSON que incluye un campo Message. El campo Message muestra la ruta completa al archivo de registro, tal y como aparece En el ejemplo siguiente:

{ "s3Bucket": "amzn-s3-demo-bucket","s3ObjectKey": ["AWSLogs/123456789012/CloudTrail/us-east-2/2013/12/13/123456789012_CloudTrail_us-west-2_20131213T1920Z_LnPgDQnpkSKEsppV.json.gz"] }

Si se envían múltiples archivos de registros al bucket de Amazon S3 es posible que las notificaciones contengan varios registros, tal como se muestra en el siguiente ejemplo:

{ "s3Bucket": "amzn-s3-demo-bucket", "s3ObjectKey": [ "AWSLogs/123456789012/CloudTrail/us-east-2/2016/08/11/123456789012_CloudTrail_us-east-2_20160811T2215Z_kpaMYavMQA9Ahp7L.json.gz", "AWSLogs/123456789012/CloudTrail/us-east-2/2016/08/11/123456789012_CloudTrail_us-east-2_20160811T2210Z_zqDkyQv3TK8ZdLr0.json.gz", "AWSLogs/123456789012/CloudTrail/us-east-2/2016/08/11/123456789012_CloudTrail_us-east-2_20160811T2205Z_jaMVRa6JfdLCJYHP.json.gz" ] }

Si decide recibir notificaciones por correo electrónico, el cuerpo del mensaje incluirá el contenido del campo Message. Para obtener información sobre la estructura JSON, consulte Fanout to Amazon SQS queues en la Guía para desarrolladores de Amazon Simple Notification Service. Solo el campo Message muestra información de CloudTrail. Los demás campos contienen información del servicio de Amazon SNS.

Si crea un registro de seguimiento con la API de CloudTrail, podrá especificar un tema de Amazon SNS existente al que quiera que CloudTrail envíe notificaciones con las operaciones CreateTrail o UpdateTrail. Debe asegurarse de que el tema exista y que tenga los permisos necesarios para que CloudTrail pueda enviarle notificaciones. Consulte Política de temas de Amazon SNS para CloudTrail.

Recursos adicionales de

Para obtener más información sobre los temas de Amazon SNS y de la suscripción a ellos, consulte la Guía para desarrolladores de Amazon Simple Notification Service.