Configurar notificações do Amazon SNS para o CloudTrail

Você poderá ser notificado quando o CloudTrail publicar novos arquivos de log em seu bucket do Amazon S3. Gerencie notificações usando o Amazon Simple Notification Service (Amazon SNS).

As notificações são opcionais. Se você desejar receber notificações, configure o CloudTrail para enviar informações de atualização a um tópico do Amazon SNS sempre que um novo arquivo de log for enviado. Para receber essas notificações, é possível usar o Amazon SNS para se inscrever no tópico. Como assinante, você pode receber atualizações enviadas a uma fila do Amazon Simple Queue Service (Amazon SQS), que permite processar essas notificações de modo programático.

Configurar o CloudTrail para enviar notificações

É possível configurar uma trilha para usar um tópico do Amazon SNS. É possível usar o console do CloudTrail ou o comando CLI aws cloudtrail create-trail para criar o tópico. O CloudTrail cria o tópico do Amazon SNS para você e anexa uma política apropriada para que o CloudTrail tenha permissão para publicar nesse tópico.

Quando você cria o nome de um tópico do SNS, ele deve atender aos seguintes requisitos:

• Ter entre 1 e 256 caracteres

• Conter letras maiúsculas e minúsculas ASCIIs, números, sublinhados ou hífens

Quando você configura as notificações de uma trilha que se aplica a todas as regiões, as notificações de todas as regiões serão enviadas ao tópico do Amazon SNS que você especificar. Se você tem uma ou mais trilhas específicas da região, deve criar um tópico separado para cada região e se inscrever em cada um deles individualmente.

Para receber notificações, inscreva-se no tópico do Amazon SNS ou nos tópicos que o CloudTrail usa. Isso é feito com o console ou com os comandos CLI do Amazon SNS. Para obter mais informações, consulte Inscrever-se em um tópico no Guia do desenvolvedor do Amazon Simple Notification Service.

nota

O CloudTrail envia uma notificação quando os arquivos de log são gravados no bucket do Amazon S3. Uma conta ativa pode gerar um grande número de notificações. Se você se inscrever para receber e-mails ou mensagens SMS, poderá receber um grande volume de mensagens. Recomendamos que você se inscreva usando o Amazon Simple Queue Service (Amazon SQS), que permite controlar as notificações de maneira programática. Para obter mais informações, consulte Inscrever-se em um tópico do Amazon SNS no Guia do desenvolvedor do Amazon Simple Queue Service.

A notificação do Amazon SNS consiste em um objeto JSON que inclui um campo Message. O campo Message lista o caminho completo para o arquivo de log, como mostrado no exemplo a seguir:

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

Se vários arquivos de log forem fornecidos ao bucket do Amazon S3, uma notificação poderá conter vários logs, conforme mostrado no seguinte exemplo:

{
    "s3Bucket": "your-bucket-name",
    "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"
    ]
}

Se você optar por receber notificações por e-mail, o corpo do e-mail consistirá no conteúdo do campo Message. Para obter uma descrição completa da estrutura JSON, consulte Como enviar mensagens do Amazon SNS para filas do Amazon SQS no Guia do desenvolvedor do Amazon Simple Notification Service. Somente o campo Message mostra as informações do CloudTrail. Os outros campos contêm informações do serviço do Amazon SNS.

Se você criar uma trilha com a API do CloudTrail, poderá especificar um tópico existente do Amazon SNS ao qual deseja que o CloudTrail envie notificações com as operações CreateTrail ou UpdateTrail. Você deve verificar se o tópico existe e tem permissões que autorizam o CloudTrail a enviar notificações para ele. Consulte Política de tópicos do Amazon SNS para CloudTrail.

Recursos adicionais

Para obter mais informações sobre tópicos do Amazon SNS e como assiná-los, consulte o Guia do desenvolvedor do Amazon Simple Notification Service.