As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Demonstrações de recebimento de e-mails do Amazon SES no console Esta seção descreve os assistentes de console de recebimento de e-mails usados para configurar *regras de recebimento* e *filtros de endereços IP* para gerenciar o recebimento de e-mails. Antes de usar os assistentes de console, é importante que você tenha lido [Conceitos de recebimento de e-mail e casos do Amazon SES](receiving-email-concepts.md) para entender os conceitos de como funciona o recebimento de e-mails e [Configurar o recebimento de e-mails](receiving-email-setting-up.md) garantir que você tenha concluído os pré-requisitos de configuração. **Topics** + [Demonstração da criação de regras de recebimento no console](receiving-email-receipt-rules-console-walkthrough.md) + [Demonstração da criação de filtros de endereços IP no console](receiving-email-ip-filtering-console-walkthrough.md) # Demonstração da criação de regras de recebimento no console Esta seção demonstra como criar e definir regras de recebimento usando o console do Amazon SES. Os principais pontos para entender como funcionam as regras de recebimento são: + Os *conjuntos de regras* contêm um conjunto ordenado de regras de recebimento; as *regras de recebimento* contêm um conjunto ordenado de ações. + As regras de recebimento informam ao Amazon SES como lidar com e-mails recebidos executando uma lista ordenada de ações que você especifica. + Esta lista ordenada de ações pode ser condicionada à correspondência prévia com uma condição de destinatário. Se não for especificado, as ações serão aplicadas a todas as identidades que pertencem aos seus domínios verificados. + As regras de recebimento são criadas e definidas em um contêiner chamado conjunto de regras; embora você possa criar vários conjuntos de regras, apenas um pode estar ativo de cada vez. + As regras de recebimento dentro do conjunto de regras ativo são executadas na ordem especificada. + Antes de criar suas regras de recebimento, você deve primeiro criar um *conjunto de regras* para contê-las. Opcionalmente, você pode usar a API `CreateReceiptRuleSet` para criar um conjunto de regras de recebimento vazio, como descrito na [Referência da API do Amazon Simple Email Service](https://docs.aws.amazon.com/ses/latest/APIReference/API_CreateReceiptRuleSet.html). Em seguida, você pode usar o console ou a API `CreateReceiptRule` do Amazon SES para adicionar regras a ele. Antes de prosseguir com a demonstração, certifique-se de ter atendido a todos os pré-requisitos necessários para usar o recebimento de e-mails com base em destinatário. ## Pré-requisitos Os seguintes pré-requisitos devem ser atendidos para que você possa prosseguir com a configuração do controle de e-mail baseado no destinatário usando regras de recebimento: 1. Certifique-se de que seu endpoint esteja em um Região da AWS local onde o Amazon SES ofereça suporte ao recebimento de e-mails. A tabela de [endpoints de recebimento de e-mail](https://docs.aws.amazon.com/general/latest/gr/ses.html#ses_inbound_endpoints) na Referência geral da AWS lista os endpoints de recebimento de e-mail para todos os Regiões da AWS lugares em que o SES oferece suporte ao recebimento de e-mail. 1. Primeiro, você precisa [criar e verificar uma identidade de domínio](verify-addresses-and-domains.md) no Amazon SES. 1. Em seguida, você precisa especificar quais servidores de e-mail podem aceitar e-mails para seu domínio [publicando um registro MX](receiving-email-mx-record.md) para as configurações de DNS do seu domínio. (O registro MX deve se referir ao endpoint do Amazon SES que recebe e-mails para a AWS região em que você usa o Amazon SES.) 1. Por fim, você precisa [dar permissão ao Amazon SES](receiving-email-permissions.md) para acessar outros AWS recursos a fim de executar ações de regras de recebimento. ## Criação de conjuntos de regras e regras de recebimento Esta demonstração começa criando primeiro um conjunto de regras para conter suas regras e prossegue para o assistente **Create rule (Criar regra)** para criar, definir e ordenar suas regras de recebimento. O assistente contém quatro telas para definir configurações de regras, adicionar condições de destinatário, adicionar ações e revisar todas as configurações. **Para criar uma regra de recebimento usando o console** 1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon SES em [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/). 1. No painel de navegação, em **Email Receiving (Recebimento de e-mail)**, selecione **Rule Sets (Conjuntos de regras)**. **nota** O *recebimento de e-mails* não estará visível no painel de navegação esquerdo do console do SES se a conta estiver em uma  Região da AWS  em que o SES não permita o recebimento de e-mails. Veja o primeiro item listado em [Pré-requisitos](#receipt-rules-prerequisites). 1. Na guia **Receipt rule sets** (Conjuntos de regras de recebimento) no painel **Email receiving** (Recebimento de e-mail), selecione **Create rule set** (Criar conjunto de regras). 1. Insira um nome exclusivo para o conjunto de regras e escolha **Create rule set (Criar conjunto de regras)**. 1. Escolha **Create rule (Criar regra)**, e isso abrirá o assistente **Create rule (Criar regra)**. 1. Na página **Define rule settings (Definir configurações de regra)**, em **Receipt rule details (Detalhes da regra de recebimento)**, insira um **Rule name (Nome da regra)**. 1. Para **Status**, só desmarque a caixa de **Enabled (Habilitado)** se você não quiser que o Amazon SES execute esta regra após a criação; caso contrário, deixe essa opção selecionada. 1. (Opcional) Em **Security and protection options (Opções de segurança e proteção)**, para **Transport Layer Security (TLS)**, selecione **Required (Obrigatório)** se quiser que o Amazon SES rejeite mensagens recebidas que não forem enviadas por uma conexão segura. 1. (Opcional) Para **Spam and virus scanning (Varredura de spam e vírus)**, selecione **Enabled (habilitado)** se você desejar que o Amazon SES examine os e-mails recebidos para detectar spam e vírus. 1. Para prosseguir para a próxima etapa, escolha **Next (Avançar)**. 1. (Opcional) Na guia **Add recipient conditions (Adicionar condições de destinatário)**, use o procedimento a seguir para especificar uma ou mais condições do destinatário. Você pode ter no máximo 100 condições de destinatários por regra de recebimento. 1. Em **Recipient conditions (Condições do destinatário)**, escolha **Add new recipient condition (Adicionar nova condição de destinatário)** para especificar o endereço de e-mail ou o domínio ao qual você deseja aplicar a regra de recebimento. A tabela a seguir usa o endereço *usuário@exemplo.com* para mostrar como especificar condições de destinatários. **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/ses/latest/dg/receiving-email-receipt-rules-console-walkthrough.html) **Importante** Se várias contas do Amazon SES receberem e-mails em um domínio comum (por exemplo, se várias equipes da mesma empresa tiverem contas separadas do Amazon SES), o Amazon SES processará todas as regras de recebimento correspondentes simultaneamente para cada uma dessas contas. Esse comportamento pode resultar em uma situação em que uma conta gera uma devolução e, ao mesmo tempo, outra conta aceita o e-mail. Recomendamos coordenar com outras equipes na sua organização que usam o Amazon SES para garantir que cada conta use regras de recebimento exclusivas, e que essas regras não se sobreponham. Nessas situações, é melhor configurar suas regras de recebimento para usar apenas endereços de e-mail ou subdomínios que sejam exclusivos para o seu grupo ou equipe. 1. Repita essa etapa para cada condição de destinatário que deseja adicionar. Quando você terminar de adicionar destinatários, escolha **Next (Avançar)**. 1. Na página **Add actions (Adicionar ações)**, use o procedimento a seguir para adicionar uma ou mais ações à regra de recebimento. 1. Abra o menu **Add new action (Adicionar nova ação)** e escolha um dos seguintes tipos de ações: + **[Adicionar cabeçalho](receiving-email-action-add-header.md)**: esta ação adiciona um cabeçalho personalizado ao e-mail recebido. + **[Retornar resposta de devolução](receiving-email-action-bounce.md)**: esta ação rejeita o e-mail recebido, com uma reposta de devolução para o remetente. + **[Invocar uma função do Lambda](receiving-email-action-lambda.md)**- Essa ação chama seu código por meio de uma função AWS Lambda. + **[Entregar ao bucket do S3](receiving-email-action-s3.md)**: esta ação armazena o e-mail recebido em um bucket do Amazon Simple Storage Service (S3). + **[Publicar em um tópico do Amazon SNS](receiving-email-action-sns.md)**: esta ação publica o e-mail completo em um tópico do Amazon Simple Notification Service (SNS). + **[Interromper conjunto de regras](receiving-email-action-stop.md)**: esta ação termina a avaliação do conjunto de regras de recebimento. + **[Integrar com o Amazon WorkMail](receiving-email-action-workmail.md)**- Esta ação se integra com a Amazon WorkMail. Para obter mais informações sobre todas essas ações, consulte [Opções de ação](receiving-email-action.md). 1. Repita essa etapa para cada ação que desejar definir. Se você tiver várias ações definidas, pode reordená-las usando as setas para cima/baixo dentro dos contêineres de ação. Escolha **Next (Avançar)** para abrir a página **Review (Revisão)**. 1. Na página **Review (Revisão)**, revise as configurações e as ações da regra. Se você precisar fazer alterações, use a opção **Edit (Editar)** ou a seção de navegação no lado esquerdo da página para ir diretamente para a etapa com o conteúdo que você deseja editar. Opcionalmente, você pode fazer alterações na ordem das ações listadas na tabela **Ações** da página **Revisão** usando up/down as setas na coluna **Reordenar**. 1. Quando você estiver pronto para continuar, selecione **Create rule (Criar regra)**. 1. Na página de confirmação do conjunto de regras, escolha **Set as active** (Definir como ativo) se quiser aplicar o conjunto de regras imediatamente. ### Modificações de regra após a criação Depois de criar um conjunto de regras, você pode editar o conjunto de regras e as regras de recebimento nele contidas. Eles não apenas podem ser editados, mas também há a opção de duplicar o conjunto de regras ou suas regras para criar novas rapidamente. A lista a seguir mostra as modificações disponíveis para o conjunto de regras e as regras de recebimento: + O **conjunto de regras** é listado com nome, status e data de criação. As opções de modificação para o conjunto de regras são: + O botão **Set as active/inactive (Definir como ativo/inativo)** alternar entre configurar o status como ativo ou inativo. + O botão **Duplicate (Duplicar)** copia o conjunto de regras. Será solicitado um nome exclusivo. + O botão **Delete (Excluir)** exclui o conjunto de regras. Será solicitado que você confirme a confirmar essa ação irreversível. + As **regras de recebimento** estão listadas com nome, status, segurança e ordem. As opções de modificação para as regras de recebimento são: + **Setas para cima/para baixo** para reordenar a execução de regras dentro do conjunto de regras. + O botão **Duplicate (Duplicar)** cria uma cópia da regra selecionada. Será solicitado um nome exclusivo. + **Edit (Editar)** abre a regra selecionada para que qualquer um de seus parâmetros, como configurações de regra, condições de destinatário e ações, possam ser editados. + O botão **Delete (Excluir)** exclui a regra selecionada. Será solicitado que você confirme a confirmar essa ação irreversível. + **Create rule (Criar regra)** permite que você crie e adicione uma nova regra ao conjunto de regras atual. # Opções de ação Cada regra para o recebimento de e-mails do Amazon SES contém uma lista ordenada de ações. Esta seção descreve as opções específicas para cada tipo de ação. Os tipos de ação são os seguintes: + [Ação Add header (Adicionar cabeçalho)](receiving-email-action-add-header.md) + [Ação Retornar reposta de devolução](receiving-email-action-bounce.md) + [Ação Invoke Lambda function (Invocar uma função do Lambda)](receiving-email-action-lambda.md) + [Ação Deliver to S3 bucket (Entregar ao bucket do S3)](receiving-email-action-s3.md) + [Ação Publish to Amazon SNS topic (Publicar em um tópico do Amazon SNS)](receiving-email-action-sns.md) + [Ação Stop rule set (Interromper conjunto de regras)](receiving-email-action-stop.md) + [Ação Integrate with Amazon WorkMail (Integrar com o Amazon WorkMail)](receiving-email-action-workmail.md) # Ação Add header (Adicionar cabeçalho) A ação **Add Header** adiciona um cabeçalho personalizado ao e-mail recebido. Normalmente, você usa essa ação apenas em combinação com outra ação. Essa ação tem as seguintes opções. + **Header name (Nome do cabeçalho)**: o nome do cabeçalho a ser adicionado. Ele deve ter entre 1 e 50 caracteres e consistir apenas em caracteres alfanuméricos (a-z, A-Z, 0-9) e traços. + **Header value (Valor do cabeçalho)**: o valor do cabeçalho a ser adicionado. Ele deve ter pelo menos 2.048 caracteres e não deve conter caracteres de nova linha ("\$1r" ou"\$1n"). # Ação Retornar reposta de devolução A ação **Bounce** (Devolução) rejeita o e-mail retornando uma reposta de devolução para o remetente e, opcionalmente, o notificará por meio do Amazon SNS. Essa ação tem as seguintes opções. + **Código de nova tentativa SMTP – **o código de nova tentativa SMTP, conforme definido por [RFC 5321](https://tools.ietf.org/html/rfc5321). + **Código de status SMTP – **o código de status aprimorado SMTP, conforme definido por [RFC 3463](https://tools.ietf.org/html/rfc3463). + **Mensagem – **texto legível a ser incluído no e-mail de devolução. + **Reply Sender (Remetente da resposta)**: o endereço de e-mail do remetente do e-mail devolvido. Esse é o endereço de e-mail a partir do qual o e-mail de devolução será enviado. Ele deve ser verificado com o Amazon SES. **nota** As mensagens de falha de entrega não são enviadas por meio do seu domínio MAIL FROM personalizado, mas são geradas internamente pelo SES e assinadas somente com a assinatura DKIM de `amazonses.com`. Como solução alternativa, use a opção **Responder remetente** para definir um endereço de e-mail para suas mensagens com falha de entrega. Consulte este [artigo do AWS re:Post](https://repost.aws/questions/QURvN-26L_SJOcY9JoSFgCdg/ses-receiving-return-bounce-response-action-not-sending-bounce) para obter mais informações. + **SNS Topic (Tópico do SNS)**: o nome ou ARN do tópico do Amazon SNS a ser notificado, opcionalmente, quando um e-mail de devolução é enviado. Um exemplo de ARN de um tópico do Amazon SNS é *arn:aws:sns:us-east-1:123456789012:MyTopic*. Você também pode criar um tópico do Amazon SNS ao configurar a sua ação escolhendo **Create SNS Topic (Criar tópico do SNS)**. Para obter mais informações sobre tópicos do Amazon SNS, consulte o [Guia do desenvolvedor do Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html). **nota** O tópico do Amazon SNS escolhido deve estar na mesma região da AWS que o endpoint do Amazon SES usado para receber e-mails. Você pode digitar seus próprios valores para esses campos ou escolher um modelo que preencha os campos Código de resposta SMTP, Código de status SMTP e Mensagem com valores baseados no motivo da devolução. Os seguintes modelos estão disponíveis: + **A caixa de correio não existe – ** Código de resposta SMTP = 550, Código de status SMTP = 5.1.1 + **Mensagem muito grande – ** Código de resposta SMTP = 552, Código de status SMTP = 5.3.4 + **Mailbox Full (Caixa de correio cheia)**: código de resposta SMTP = 552, Código de status SMTP = 5.2.2 + **Conteúdo da mensagem rejeitado – ** Código de resposta SMTP = 500, Código de status SMTP = 5.6.1 + **Falha desconhecida – ** Código de resposta SMTP = 554, Código de status SMTP = 5.0.0 + **Falha temporária – ** Código de resposta SMTP = 450, Código de status SMTP = 4.0.0 Para códigos de devolução adicionais que você pode usar ao digitar valores personalizados em campos, consulte [RFC 3463](https://tools.ietf.org/html/rfc3463). # Ação Invoke Lambda function (Invocar uma função do Lambda) A ação do Lambda chama seu código por meio de uma função do Lambda e, opcionalmente, o notifica por meio do Amazon SNS. Essa ação tem as seguintes opções e requisitos. **Opções** + **Lambda function (Função do Lambda)**: o ARN da função do Lambda. *Um exemplo de ARN da função Lambda é arn:aws:lambda:us-east-1:account-id:function:. MyFunction* + **Invocation type (Tipo de invocação)**: o tipo de invocação da função do Lambda. Um tipo de invocação **RequestResponse**significa que a execução da função resulta em uma resposta imediata. Um tipo de invocação de **Event** (Evento) significa que a função é invocada de forma assíncrona. Recomendamos que você use o tipo de invocação **Event** (Evento), a menos que a execução síncrona seja necessária para seu caso de uso. Existe um tempo limite de 30 segundos nas invocações de **RequestResponse**. Para obter mais informações, consulte [Invocar funções do Lambda](https://docs.aws.amazon.com/lambda/latest/dg/lambda-invocation.html) no *Guia do desenvolvedor do AWS Lambda *. + **SNS Topic** (Tópico SNS): o nome ou o ARN do tópico do Amazon SNS a ser notificado quando a função do Lambda especificada for acionada. *Um exemplo de ARN de tópico do Amazon SNS é arn:aws:sns:us-east- 1:123456789012:. MyTopic* Para obter mais informações, consulte [Criação de um tópico do Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html) no *Guia do desenvolvedor do Amazon Simple Notification Service*. **Requisitos** + A função Lambda que você escolher deve estar na mesma AWS região do endpoint do Amazon SES que você usa para receber e-mails. + O tópico do Amazon SNS que você escolher deve estar na mesma AWS região do endpoint do Amazon SES que você usa para receber e-mails. ## Redação de sua função do Lambda Para processar seus e-mails, sua função do Lambda pode ser invocada de forma assíncrona (ou seja, usando o tipo de invocação `Event`). O objeto de evento passado para a função do Lambda conterá metadados relativos ao evento de e-mail de entrada. Você também pode usar os metadados para acessar o conteúdo da mensagem a partir de seu bucket do Amazon S3. Se você deseja realmente controlar o fluxo de e-mails, sua função do Lambda deve ser invocada de forma síncrona (ou seja, usando o tipo de invocação `RequestResponse`) e sua função do Lambda deve chamar o método `callback` com dois argumentos: o primeiro argumento é `null` e o segundo argumento é uma propriedade `disposition` que é definida como `STOP_RULE`, `STOP_RULE_SET` ou `CONTINUE`. Se o segundo argumento for `null` ou não tiver uma propriedade `disposition` válida, o fluxo de e-mails continuará e outras ações e regras serão processados, que é o mesmo com `CONTINUE`. Por exemplo, você pode interromper o conjunto de regras de recebimento aescrevendo a seguinte linha no final do código da função do Lambda: ``` callback( null, { "disposition" : "STOP_RULE_SET" }); ``` Para exemplos AWS Lambda de código, consulte[Exemplos de função do Lambda](receiving-email-action-lambda-example-functions.md). Para obter exemplos de casos de uso de alto nível, consulte [Exemplos de casos de uso](receiving-email-action-lambda-example-use-cases.md). ### Formato de entrada O Amazon SES passa informações para a função do Lambda no formato JSON. O objeto de nível superior contém uma matriz `Records`, que é preenchida com as propriedades `eventSource`, `eventVersion` e `ses`. O objeto `ses` contém os objetos `receipt` e `mail`, que estão exatamente no mesmo formato que nas notificações do Amazon SNS notificações descritas em [Conteúdo das notificações ](receiving-email-notifications-contents.md). Os dados que o Amazon SES passa para o Lambda incluem metadados sobre a mensagem, bem como vários cabeçalhos de e-mail. No entanto, não contêm o corpo da mensagem. Veja a seguir uma visão de alto nível da estrutura da entrada que o Amazon SES fornece para a função do Lambda. ``` { "Records": [ { "eventSource": "aws:ses", "eventVersion": "1.0", "ses": { "receipt": { }, "mail": { } } } ] } ``` ### Valores de retorno Sua função do Lambda pode controlar o fluxo de e-mails retornando um dos seguintes valores: + `STOP_RULE` – nenhuma ação adicional na regra de recebimento atual será processada, mas é possível processar mais regras de recebimento. + `STOP_RULE_SET` – nenhuma ação ou regras de recebimento adicionais serão processadas. + `CONTINUE` ou qualquer outro valor inválido – isso significa que ações e regras de recebimento adicionais podem ser processadas. **Topics** + [Redação de sua função do Lambda](#receiving-email-action-lambda-function) + [Exemplo de evento de recebimento de e-mail](receiving-email-action-lambda-event.md) + [Exemplos de casos de uso](receiving-email-action-lambda-example-use-cases.md) + [Exemplos de função do Lambda](receiving-email-action-lambda-example-functions.md) # Exemplo de evento de recebimento de e-mail Há duas maneiras de enviar eventos de recebimento de e-mail para uma função do Lambda. O primeiro método é usar uma ação do Lambda em sua regra de recebimento para enviar o registro de evento diretamente à função. O segundo método é usar uma ação do Amazon SNS na sua regra de recebimento para enviar os registros de eventos ao Amazon SNS e adicionar a função do Lambda como um endpoint de assinatura do tópico do Amazon SNS. Esta seção contém exemplos dos registros de eventos que o Amazon SES pode enviar ao Lambda. É possível usar esses exemplos para criar e testar funções do Lambda. **nota** Os exemplos desta seção incluem quebras de linha para facilitar a leitura. Se você copiar os exemplos desta seção, remova as quebras de linha adicionais para produzir objetos JSON válidos. ## Registros de eventos fornecidos pela ação do Lambda Quando você adiciona uma ação do Lambda a uma regra de recebimento, o Amazon SES envia um registro de evento para o Lambda sempre que recebe uma mensagem. Esse evento contém informações sobre vários cabeçalhos de e-mail para a mensagem recebida, bem como os resultados de vários testes que o Amazon SES executa em mensagens recebidas. No entanto, ele omite o corpo do e-mail recebido. O exemplo a seguir mostra os valores que esses registros de eventos normalmente contêm. ``` { "Records": [{ "eventSource": "aws:ses", "eventVersion": "1.0", "ses": { "mail": { "timestamp": "2019-08-05T21:30:02.028Z", "source": "prvs=144d0cba7=sender@example.com", "messageId": "EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000", "destination": ["recipient@example.com"], "headersTruncated": false, "headers": [{ "name": "Return-Path", "value": "" }, { "name": "Received", "value": "from smtp.example.com [203.0.113.0]) by inbound-smtp.us-east-1.amazonaws.com with SMTP id bsvpsoklfhu7u50iur7h0kk9a2ou0r7iexample for recipient@example.com; Mon, 05 Aug 2019 21:30:02 +0000 (UTC)" }, { "name": "X-SES-Spam-Verdict", "value": "PASS" }, { "name": "X-SES-Virus-Verdict", "value": "PASS" }, { "name": "Received-SPF", "value": "pass (spfCheck: domain of example.com designates 203.0.113.0 as permitted sender) client-ip=203.0.113.0; envelope-from=prvs=144d0cba42=sender@example.com; helo= smtp.example.com;" }, { "name": "Authentication-Results", "value": "amazonses.com; spf=pass (spfCheck: domain of example.com designates 203.0.113.0 as permitted sender) client-ip=203.0.113.0; envelope-from=prvs=144d0cba42= sender@example.com; helo=smtp.example.com; dkim=pass header.i=@example.com; dmarc=none header.from=example.com;" }, { "name": "X-SES-RECEIPT", "value": "AEFBQUFBQUFBQUFHbFo0VU81VzVuYmRDNm51nhTVWpabDh6J4V2l5cG5PSHFtNzlBeUk90example" }, { "name": "X-SES-DKIM-SIGNATURE", "value": "a=rsa-sha256; q=dns/txt; b=Cm1emU30VcD6example=; c=relaxed/simple; s=6gbrjpgwjs 5zn6fwqknexample; d=amazonses.com; t=1567719002; v=1; bh=DSofsjAoUvyZj6YsBDP5en pRO1otGb7Nes0Qexample=; h=From:To:Cc:Bcc:Subject:Date:Message-ID:MIME-Version: Content-Type:X-SES-RECEIPT;" }, { "name": "DKIM-Signature", "value": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=example.com; i=@example.com; q=dns/txt; s=example12345; t=1567719001; x=1599255001; h=from:to:subject:date:message-id: references:in-reply-to:mime-version; bh=sjAoUvyZj6YsBDP5enpRO1otGb7s0Qexample=; b=EQw2D4RLOW2IHE9OgfEA4WXp+AENJtaD2+63wmd5J+d+t/xoaiKUGClOS7WhpyOmlipryOz+iOhxU v350xJIHjLTi9Jsnlw76mRK8o4770TaUz620joCVN21n4cxsrRZpv+1kS0EcAxaF30pmwlni+XT4ems Vxn7zO0I8example=;" }, { "name": "Received", "value": "from mail.example.com (mail.example.com [203.0.113.0]) by email-inbound-relay- 1d-9ec21598.us-east-1.example.com (Postfix) with ESMTPS id 57F83A2042 for ; Mon, 5 Aug 2019 21:29:58 +0000 (UTC)" }, { "name": "From", "value": "\"Doe, John\" " }, { "name": "To", "value": "\"recipient@example.com\" " }, { "name": "Subject", "value": "This is a test" }, { "name": "Thread-Topic", "value": "This is a test" }, { "name": "Thread-Index", "value": "AQHVZDAaQ58yKI8q7kaAjkhC5stGexample" }, { "name": "Date", "value": "Mon, 5 Aug 2019 21:29:57 +0000" }, { "name": "Message-ID", "value": "" }, { "name": "References", "value": "<1FCED16B-F6B0-4506-A6F0-594DFexample@example.com>" }, { "name": "In-Reply-To", "value": "<1FCED16B-F6B0-4506-A6F0-594DFexample@example.com>" }, { "name": "Accept-Language", "value": "en-US" }, { "name": "Content-Language", "value": "en-US" }, { "name": "X-MS-Has-Attach", "value": "" }, { "name": "X-MS-TNEF-Correlator", "value": "" }, { "name": "x-ms-exchange-messagesentrepresentingtype", "value": "1" }, { "name": "x-ms-exchange-transport-fromentityheader", "value": "Hosted" }, { "name": "x-originating-ip", "value": "[203.0.113.0]" }, { "name": "Content-Type", "value": "multipart/alternative; boundary=\"_000_F8098FDD49A344F6112B195BDAexamplecom_\"" }, { "name": "MIME-Version", "value": "1.0" }, { "name": "Precedence", "value": "Bulk" }], "commonHeaders": { "returnPath": "prvs=144d0cba7=sender@example.com", "from": ["\"Doe, John\" "], "date": "Mon, 5 Aug 2019 21:29:57 +0000", "to": ["\"recipient@example.com\" "], "messageId": "", "subject": "This is a test" } }, "receipt": { "timestamp": "2019-08-05T21:30:02.028Z", "processingTimeMillis": 1205, "recipients": ["recipient@example.com"], "spamVerdict": { "status": "PASS" }, "virusVerdict": { "status": "PASS" }, "spfVerdict": { "status": "PASS" }, "dkimVerdict": { "status": "PASS" }, "dmarcVerdict": { "status": "GRAY" }, "action": { "type": "Lambda", "functionArn": "arn:aws:lambda:us-east-1:123456789012:function:IncomingEmail", "invocationType": "Event" } } } }] } ``` ## Registros de eventos fornecidos pela ação do Amazon SNS Quando você adiciona uma ação do Amazon SNS à sua regra de recebimento, a notificação contém todo o conteúdo do e-mail. Se você quiser que uma função do Lambda processe o corpo do e-mail, adicione uma ação do Amazon SNS à regra de recebimento e, no Amazon SNS, inscreva a função do Lambda na função do Amazon SNS. Essa configuração faz com que a função do Lambda seja ativada quando recebe uma notificação do tópico do Amazon SNS. ``` { 'Records': [ { 'EventSource': 'aws:sns', 'EventVersion': '1.0', 'EventSubscriptionArn': 'arn:aws:sns:us-east-1:123456789012:IncomingEmail:12345678', 'Sns': { 'Type': 'Notification', 'MessageId': 'EXAMPLE7c191be45-e9aedb9a-02f9-4d12-a87d-dd0099a07f8a-000000', 'TopicArn': 'arn:aws:sns:us-east-1:123456789012:IncomingEmail', 'Subject': 'Amazon SES Email Receipt Notification', 'Message': , 'Timestamp': '2019-09-06T18:52:16.076Z', 'SignatureVersion': '1', 'Signature': '012345678901example==', 'SigningCertUrl': 'https://sns.us-east-1.amazonaws.com/SimpleNotificationService -01234567890123456789012345678901.pem', 'UnsubscribeUrl': 'https://sns.us-east-1.amazonaws.com/?Action=Unsubscribe& SubscriptionArn=arn:aws:sns:us-east-1:0123456789012:IncomingEmail: 0b863538-3f32-462e-9c89-8d8e0example', 'MessageAttributes': {} } } ] } ``` O atributo `Message` contém uma string codificada em JSON. Essa string contém os cabeçalhos e o conteúdo da mensagem. O corpo da mensagem em si é codificado em base64. Se você quiser usar o corpo da mensagem na função do Lambda, primeiro é necessário decodificar o atributo `Message` e, depois, decodificar o objeto `Content`. O exemplo a seguir mostra os valores contidos no atributo `Message`. ``` { "notificationType": "Received", "mail": { "timestamp": "2019-09-06T18:52:14.965Z", "source": "0100016d07eb7477-8e1938ce-475e-4e4b-89cb-example-000000@amazonses.com", "messageId": "12345678901example", "destination": ["recipient@example.com"], "headersTruncated": false, "headers": [{ "name": "Return-Path", "value": "<0100016d07eb7477-8e1938ce-475e-4e4b-89cb-example-000000@amazonses.com>" }, { "name": "Received", "value": "from a1-23.smtp-out.amazonses.com (a1-23.smtp-out.amazonses.com [203.0.113.0]) by inbound-smtp.us-east-1.amazonaws.com with SMTP id 12345678901example for recipient@example.com; Fri, 06 Sep 2019 18:52:14 +0000 (UTC)" }, { "name": "X-SES-Spam-Verdict", "value": "PASS" }, { "name": "X-SES-Virus-Verdict", "value": "PASS" }, { "name": "Received-SPF", "value": "pass (spfCheck: domain of amazonses.com designates 203.0.113.0 as permitted sender) client-ip=203.0.113.0; envelope-from=0100016d07eb7477-8e1938ce-475e-4e4b-89cb-example -000000@amazonses.com; helo=a1-23.smtp-out.amazonses.com;" }, { "name": "Authentication-Results", "value": "amazonses.com; spf=pass (spfCheck: domain of amazonses.com designates 203.0.113.0 as permitted sender) client-ip=203.0.113.0; envelope-from=0100016d07eb7477-8e1938ce -475e-4e4b-89cb-example-000000@amazonses.com; helo=a1-23.smtp-out.amazonses.com; dkim=pass header.i=@amazonses.com; dmarc=none header.from=example.com;" }, { "name": "X-SES-RECEIPT", "value": "AEFBQUFBQUFBQUFFQkx0QUJZZENEXAMPLE=" }, { "name": "X-SES-DKIM-SIGNATURE", "value": "a=rsa-sha256; q=dns/txt; b=d5azwgA2iBqAjA4NBm1ARzjJ95raRmy4G84iVdd3x2JzSHeUnQuTuLmJ AqRrYY3WpMIVRFy01hITaguCVjUPWBR0xF6fCEXH85cf3RNeFQyLfWZqoXKfBdjFRV+13troDterH2MxBUL 8rjzcvdHetl0ImwlaK2PGmePTexample=; c=relaxed/simple; s=EXAMPLE7c191be45-e9aedb9a-02 f9-4d12-a87d-dd0099a07f8a-000000; d=amazonses.com; t=1567795935; v=1; bh=CZ1SghsYaA 6SSCbitzsLISeFoNlpdtH1Pyiexample=; h=From:To:Cc:Bcc:Subject:Date:Message-ID:MIME- Version:Content-Type:X-SES-RECEIPT;" }, { "name": "DKIM-Signature", "value": "v=1; a=rsa-sha256; q=dns/txt; c=relaxed/simple; s=EXAMPLE7c191be45-e9aedb9a-02f9- 4d12-a87d-dd0099a07f8a-000000; d=amazonses.com; t=1567795934; h=From:To:Subject: MIME-Version:Content-Type:Message-ID:Date:Feedback-ID; bh=CZ1SghsYaA6SSCbitzsLISeFo NlpdtH1Pyiexample=; b=L6VXqR1PSN/FYqJI/VAfPRKFgtakcHCYJvuJqVYbuJT8I3FOhqOvkbcgHxOgs woxPfvGrL6S53H8Er5Do/CPvOM4Tx3ilE+a0GTYVLjKmwltNeN09YWlJAoqG5KMQPZUxRYaNvYPInLzUdGi rdjkbSIgZEnrvq5MzaMWexample=" }, { "name": "From", "value": "sender@example.com" }, { "name": "To", "value": "recipient@example.com" }, { "name": "Subject", "value": "Amazon SES Test" }, { "name": "MIME-Version", "value": "1.0" }, { "name": "Content-Type", "value": "multipart/alternative; boundary=\"----=_Part_869787_396523212.15677example\"" }, { "name": "Message-ID", "value": "<0100016d07eb7477-8e1938ce-475e-4e4b-89cb-example-000000@email.amazonses.com>" }, { "name": "Date", "value": "Fri, 6 Sep 2019 18:52:14 +0000" }, { "name": "X-SES-Outgoing", "value": "2019.09.06-203.0.113.0" }, { "name": "Feedback-ID", "value": "1.us-east-1.ZitRoTk0xziun8WEJevt+cSJ17QNuCwulg2D2v3nrT0=:AmazonSES" }], "commonHeaders": { "returnPath": "0100016d07eb7477-8e1938ce-475e-4e4b-89cb-example-000000@amazonses.com", "from": ["sender@example.com"], "date": "Fri, 6 Sep 2019 18:52:14 +0000", "to": ["recipient@example.com"], "messageId": "<0100016d07eb7477-8e1938ce-475e-4e4b-89cb-example-000000@email.amazonses.com>", "subject": "Amazon SES Test" } }, "receipt": { "timestamp": "2019-09-06T18:52:14.965Z", "processingTimeMillis": 1098, "recipients": ["recipient@example.com"], "spamVerdict": { "status": "PASS" }, "virusVerdict": { "status": "PASS" }, "spfVerdict": { "status": "PASS" }, "dkimVerdict": { "status": "GRAY" }, "dmarcVerdict": { "status": "GRAY" }, "action": { "type": "SNS", "topicArn": "arn:aws:sns:us-east-1:123456789012:IncomingEmail", "encoding": "BASE64" } }, "content": "UmV0dXJuLVBhdGg6IDwwMTAwMDE2ZDA3ZWI3NDc3LThlMTkzOGNlLTQ3NWUtNGU0Yi04OWNiLWV4YW1wbGUtM DAwMDAwQGFtYXpvbnNlcy5jb20+ClJlY2VpdmVkOiBmcm9tIGExLTIzLnNtdHAtb3V0LmFtYXpvbnNlcy5jb2 0gKGExLTIzLnNtdHAtb3V0LmFtYXpvbnNlcy5jb20gWzIwMy4wLjExMy4wXSkKIGJ5IGluYm91bmQtc210cC5 1cy1lYXN0LTEuYW1hem9uYXdzLmNvbSB3aXRoIFNNVFAgaWQgZW5xMTBpYW1lMXFjdTMxamg1ZGEyZ244OWlt dm90Mms2ZXhhbXBsZQogZm9yIHJlY2lwaWVudEBleGFtcGxlLmNvbTsKIEZyaSwgMDYgU2VwIDIwMTkgMTg6N TI6MTQgKzAwMDAgKFVUQykKWC1TRVMtU3BhbS1WZXJkaWN0OiBQQVNTClgtU0VTLVZpcnVzLVZlcmRpY3Q6IF BBU1MKUmVjZWl2ZWQtU1BGOiBwYXNzIChzcGZDaGVjazogZG9tYWluIG9mIGFtYXpvbnNlcy5jb20gZGVzaWd uYXRlcyAyMDMuMC4xMTMuMCBhcyBwZXJtaXR0ZWQgc2VuZGVyKSBjbGllbnQtaXA9MjAzLjAuMTEzLjA7IGVu dmVsb3BlLWZyb209MDEwMDAxNmQwN2ViNzQ3Ny04ZTE5MzhjZS00NzVlLTRlNGItODljYi1leGFtcGxlLTAwM DAwMEBhbWF6b25zZXMuY29tOyBoZWxvPWExLTIzLnNtdHAtb3V0LmFtYXpvbnNlcy5jb207CkF1dGhlbnRpY2 F0aW9uLVJlc3VsdHM6IGFtYXpvbnNlcy5jb207CiBzcGY9cGFzcyAoc3BmQ2hlY2s6IGRvbWFpbiBvZiBhbWF 6b25zZXMuY29tIGRlc2lnbmF0ZXMgMjAzLjAuMTEzLjAgYXMgcGVybWl0dGVkIHNlbmRlcikgY2xpZW50LWlw PTIwMy4wLjExMy4wOyBlbnZlbG9wZS1mcm9tPTAxMDAwMTZkMDdlYjc0NzctOGUxOTM4Y2UtNDc1ZS00ZTRiL Tg5Y2ItZXhhbXBsZS0wMDAwMDBAYW1hem9uc2VzLmNvbTsgaGVsbz1hMS0yMy5zbXRwLW91dC5hbWF6b25zZX MuY29tOwogZGtpbT1wYXNzIGhlYWRlci5pPUBhbWF6b25zZXMuY29tOwogZG1hcmM9bm9uZSBoZWFkZXIuZnJ vbT1leGFtcGxlLmNvbTsKWC1TRVMtUkVDRUlQVDogQUVGQlFVRkJRVUZCUVVGRlFreDBRVUpaWkVORVhBTVBM RT0KWC1TRVMtREtJTS1TSUdOQVRVUkU6IGE9cnNhLXNoYTI1NjsgcT1kbnMvdHh0OyBiPWQ1YXp3Z0EyaUJxQ WpBNE5CbTFBUnpqSjk1cmFSbXk0Rzg0aVZkZDN4Mkp6U0hlVW5RdVR1TG1KQXFScllZM1dwTUlWUkZ5MDFoSV RhZ3VDVmpVUFdCUjB4RjZmQ0VYSDg1Y2YzUk5lRlF5TGZXWnFvWEtmQmRqRlJWKzEzdHJvRHRlckgyTXhCVUw 4cmp6Y3ZkSGV0bDBJbXdsYUsyUEdtZVBUZXhhbXBsZT07IGM9cmVsYXhlZC9zaW1wbGU7IHM9RVhBTVBMRTdj MTkxYmU0NS1lOWFlZGI5YS0wMmY5LTRkMTItYTg3ZC1kZDAwOTlhMDdmOGEtMDAwMDAwOyBkPWFtYXpvbnNlc y5jb207IHQ9MTU2Nzc5NTkzNTsgdj0xOyBiaD1DWjFTZ2hzWWFBNlNTQ2JpdHpzTElTZUZvTmxwZHRIMVB5aW V4YW1wbGU9OyBoPUZyb206VG86Q2M6QmNjOlN1YmplY3Q6RGF0ZTpNZXNzYWdlLUlEOk1JTUUtVmVyc2lvbjp Db250ZW50LVR5cGU6WC1TRVMtUkVDRUlQVDsKREtJTS1TaWduYXR1cmU6IHY9MTsgYT1yc2Etc2hhMjU2OyBx PWRucy90eHQ7IGM9cmVsYXhlZC9zaW1wbGU7CglzPUVYQU1QTEU3YzE5MWJlNDUtZTlhZWRiOWEtMDJmOS00Z DEyLWE4N2QtZGQwMDk5YTA3ZjhhLTAwMDAwMDsgZD1hbWF6b25zZXMuY29tOyB0PTE1Njc3OTU5MzQ7CgloPU Zyb206VG86U3ViamVjdDpNSU1FLVZlcnNpb246Q29udGVudC1UeXBlOk1lc3NhZ2UtSUQ6RGF0ZTpGZWVkYmF jay1JRDsKCWJoPUNaMVNnaHNZYUE2U1NDYml0enNMSVNlRm9ObHBkdEgxUHlpTWV4YW1wbGU9OwoJYj1leGFt cGxlPQpGcm9tOiBzZW5kZXJAZXhhbXBsZS5jb20KVG86IHJlY2lwaWVudEBleGFtcGxlLmNvbQpTdWJqZWN0O iBBbWF6b24gU0VTIFRlc3QKTUlNRS1WZXJzaW9uOiAxLjAKQ29udGVudC1UeXBlOiBtdWx0aXBhcnQvYWx0ZX JuYXRpdmU7IAoJYm91bmRhcnk9Ii0tLS09X1BhcnRfODY5Nzg3XzM5NjUyMzIxMi4xNTY3N2V4YW1wbGUiCk1 lc3NhZ2UtSUQ6IDwwMTAwMDE2ZDA3ZWI3NDc3LThlMTkzOGNlLTQ3NWUtNGU0Yi04OWNiLWV4YW1wbGUtMDAw MDAwQGVtYWlsLmFtYXpvbnNlcy5jb20+CkRhdGU6IEZyaSwgNiBTZXAgMjAxOSAxODo1MjoxNCArMDAwMApYL VNFUy1PdXRnb2luZzogMjAxOS4wOS4wNi0yMDMuMC4xMTMuMApGZWVkYmFjay1JRDogMS51cy1lYXN0LTEuWm l0Um9UazB4eml1bjhXRUpldnQrZXhhbXBsZT06QW1hem9uU0VTCgotLS0tLS09X1BhcnRfODY5Nzg3XzM5NjU yMzIxMi4xNTY3N2V4YW1wbGUKQ29udGVudC1UeXBlOiB0ZXh0L3BsYWluOyBjaGFyc2V0PVVURi04CkNvbnRl bnQtVHJhbnNmZXItRW5jb2Rpbmc6IDdiaXQKCkFtYXpvbiBTRVMgVGVzdApUaGlzIGVtYWlsIHdhcyBzZW50I HdpdGggQW1hem9uIFNFUy4KLS0tLS0tPV9QYXJ0Xzg2OTc4N18zOTY1MjMyMTIuMTU2NzdleGFtcGxlCkNvbn RlbnQtVHlwZTogdGV4dC9odG1sOyBjaGFyc2V0PVVURi04CkNvbnRlbnQtVHJhbnNmZXItRW5jb2Rpbmc6IDd iaXQKCjxodG1sPgo8aGVhZD48L2hlYWQ+Cjxib2R5PgogIDxoMT5BbWF6b24gU0VTIFRlc3Q8L2gxPgogIDxw PlRoaXMgZW1haWwgd2FzIHNlbnQgd2l0aCBBbWF6b24gU0VTLjwvcD4KPGltZyBhbHQ9IiIgc3JjPSJodHRwO i8vZXhhbXBsZS5yLnVzLWVhc3QtMS5hd3N0cmFjay5tZS9JMC8wMTAwMDE2ZDA3ZWI3NDc3LThlMTkzOGNlLT Q3NWUtNGU0Yi04OWNiLWV4YW1wbGUtMDAwMDAwL3UtWUphaHRkTTJTclhZQ2QiIHN0eWxlPSJkaXNwbGF5OiB ub25lOyB3aWR0aDogMXB4OyBoZWlnaHQ6IDFweDsiPgo8L2JvZHk+CjwvaHRtbD4KICAgICAgICAgICAgCi0t LS0tLT1fUGFydF84Njk3ODdfMzk2NTIzMjEyLjE1Njc3ZXhhbXBsZS0tCg==" } ``` # Exemplos de casos de uso Os exemplos a seguir descrevem algumas regras que você pode configurar para usar os resultados da função do Lambda para controlar o fluxo de e-mails. Para fins de demonstração, muitos destes exemplos usam a ação do S3 como o resultado. ## Caso de uso 1: Descartar spam em todos os domínios Este exemplo demonstra uma regra global que descarta spam em todos os seus domínios. As regras 2 e 3 são incluídas para mostrar que você pode aplicar regras específicas do domínio depois que o spam é descartado em todos os domínios. ### Rule1 *Lista de destinatários: *vazia. Essa regra, portanto, se aplicará a todos os destinatários em todos os seus domínios verificados. *Ações* 1. Ação do Lambda (síncrona) que retornará `STOP_RULE_SET` se o e-mail for spam. Caso contrário, retornará `CONTINUE`. Consulte o exemplo de função do Lambda para descartar spam em [Exemplos de função do Lambda](receiving-email-action-lambda-example-functions.md). ### Rule2 *Lista de destinatários: *example1.com *Ações* 1. Qualquer ação. ### Rule3 *Lista de destinatários: *example2.com *Ações* 1. Qualquer ação. ## Caso de uso 2: Devolver spam em todos os domínios Este exemplo demonstra uma regra global que devolve spam em todos os seus domínios. As regras 2 e 3 são incluídas para mostrar que você pode aplicar regras específicas do domínio depois que o spam é devolvido em todos os domínios. ### Rule1 *Lista de destinatários: *vazia. Essa regra, portanto, se aplicará a todos os destinatários em todos os seus domínios verificados. *Ações* 1. Ação do Lambda (síncrona) que retornará `CONTINUE` se o e-mail for spam. Caso contrário, retornará `STOP_RULE`. 1. Ação de devolução ("500 5.6.1. Conteúdo da mensagem rejeitado"). 1. Ação de interrupção. ### Rule2 *Lista de destinatários: *example1.com *Ações* 1. Qualquer ação ### Rule3 *Lista de destinatários: *example2.com *Ações* 1. Qualquer ação ## Caso de uso 3: Aplicar a regra mais específica Este exemplo demonstra como usar a ação de interrupção para impedir que os e-mails sejam processados por várias regras. Neste exemplo, você tem uma regra para um endereço específico e outra regra para todos os endereços de e-mail sob o domínio. Ao usar a ação de interrupção, as mensagens que correspondem à regra para o endereço de e-mail específico não são processadas pela regra mais genérica que se aplica ao domínio. ### Rule1 *Lista de destinatários: *user@example.com *Ações* 1. Ação do Lambda (assíncrona). 1. Ação de interrupção. ### Rule2 *Lista de destinatários: *example.com *Ações* 1. Qualquer ação. ## Caso de uso 4: registrar eventos de e-mail em CloudWatch Este exemplo demonstra como manter um log de auditoria de todos os e-mail que passam pelo seu sistema antes de salvar o e-mail no Amazon SES. ### Rule1 *Lista de destinatários: *example.com *Ações* 1. Ação Lambda (assíncrona) que grava o objeto do evento em um log. CloudWatch O exemplo de funções do Lambda em [Exemplos de função do Lambda](receiving-email-action-lambda-example-functions.md) log to. CloudWatch 1. Ação do S3. ## Caso de uso 5: Descartar e-mails que falham no DKIM Este exemplo demonstra como salvar todos os e-mails de entrada em um bucket do Amazon S3, mas enviar apenas e-mails que vão para um determinado endereço de e-mail e passam no DKIM em sua aplicação de e-mail automatizada. ### Rule1 *Lista de destinatários: *example.com *Ações* 1. Ação do S3. 1. Ação do Lambda (síncrona) que retornará `STOP_RULE_SET` se a mensagem falhar no DKIM. Caso contrário, retornará `CONTINUE`. ### Rule2 *Lista de destinatários: *support@example.com *Ações* 1. Ação do Lambda (assíncrona) que aciona o aplicativo automatizado. ## Caso de uso 6: Filtrar e-mails com base na linha de assunto Este exemplo demonstra como descartar todos os e-mails de entrada de um domínio que contenham a palavra "desconto" na linha de assunto e, em seguida, processar os e-mails destinados a um sistema automatizado de uma forma e processar os e-mails direcionados para todos os outros destinatários no domínio de outra forma. ### Rule1 *Lista de destinatários: *example.com *Ações* 1. Ação do Lambda (síncrona), que retornará `STOP_RULE_SET` se a linha de assunto contiver a palavra "desconto". Caso contrário, retornará `CONTINUE`. ### Rule2 *Lista de destinatários: *support@example.com *Ações* 1. Ação do S3 com o bucket 1. 1. Ação do Lambda (assíncrona) que aciona o aplicativo automatizado. 1. Ação de interrupção. ### Rule3 *Lista de destinatários: *example.com *Ações* 1. Ação do S3 com o bucket 2. 1. Ação do Lambda (assíncrona) que processa um e-mail para o resto do domínio. # Exemplos de função do Lambda Este tópico contém exemplos de funções do Lambda que controlam o fluxo de e-mails. ## Exemplo 1: Descartar spam Este exemplo interrompe o processamento de mensagens que tenham pelo menos um indicador de spam. ``` export const handler = async (event, context, callback) => { console.log('Spam filter'); const sesNotification = event.Records[0].ses; console.log("SES Notification:\n", JSON.stringify(sesNotification, null, 2)); // Check if any spam check failed if (sesNotification.receipt.spfVerdict.status === 'FAIL' || sesNotification.receipt.dkimVerdict.status === 'FAIL' || sesNotification.receipt.spamVerdict.status === 'FAIL' || sesNotification.receipt.virusVerdict.status === 'FAIL') { console.log('Dropping spam'); // Stop processing rule set, dropping message callback(null, {'disposition':'STOP_RULE_SET'}); } else { callback(null, {'disposition':'CONTINUE'}); } }; ``` ## Exemplo 2: Continuar se um cabeçalho específico for encontrado Este exemplo continua o processamento da regra atual somente se o e-mail contiver um valor de cabeçalho específico. ``` export const handler = async (event, context, callback) => { console.log('Header matcher'); const sesNotification = event.Records[0].ses; console.log("SES Notification:\n", JSON.stringify(sesNotification, null, 2)); // Iterate over the headers for (let index in sesNotification.mail.headers) { const header = sesNotification.mail.headers[index]; // Examine the header values if (header.name === 'X-Header' && header.value === 'X-Value') { console.log('Found header with value.'); callback(null, {'disposition':'CONTINUE'}); return; } } // Stop processing the rule if the header value wasn't found callback(null, {'disposition':'STOP_RULE'}); }; ``` ## Exemplo 3: Recuperar e-mail do Amazon S3 Este exemplo obtém o e-mail bruto do Amazon S3 e o processa. **nota** Você deve primeiro gravar o e-mail no Amazon S3 usando uma ação do S3. Garanta que a função do Lambda tenha permissões do IAM para buscar objetos do bucket do S3. Consulte este [artigo do AWS re:Post](https://repost.aws/knowledge-center/lambda-execution-role-s3-bucket) para obter mais informações. É possível que os tempos limite de execução padrão do Lambda sejam muito curtos para seu fluxo de trabalho, então considere aumentá-los. ``` import { S3Client, GetObjectCommand } from "@aws-sdk/client-s3"; const bucketName = ''; export const handler = async (event, context, callback) => { const client = new S3Client(); console.log('Process email'); var sesNotification = event.Records[0].ses; console.log("SES Notification:\n", JSON.stringify(sesNotification, null, 2)); console.log("MessageId: " + sesNotification.mail.messageId) const getObjectCommand = new GetObjectCommand({ Bucket: bucketName, Key: sesNotification.mail.messageId }); try { const response = await client.send(getObjectCommand); const receivedMail = await response.Body.transformToString(); console.log(receivedMail); callback(null, {'disposition':'CONTINUE'}) } catch (e) { // Perform error handling here console.log("Encountered S3 client error: "+ e, e.stack); callback(null, {'disposition':'STOP_RULE_SET'}) } }; ``` ## Exemplo 4: Devolver as mensagens que falham na autenticação do DMARC Este exemplo enviará uma mensagem de devolução se um e-mail de entrada falhar na autenticação DMARC. **nota** Ao usar este exemplo, defina o valor da variável de ambiente `emailDomain` como seu domínio de recebimento de e-mail. Garanta que a função do Lambda tenha as permissões `ses:SendBounce` para a identidade do SES que está enviando as mensagens de falha de entrega. ``` import { SESClient, SendBounceCommand } from "@aws-sdk/client-ses"; const sesClient = new SESClient(); // Assign the emailDomain environment variable to a constant. const emailDomain = process.env.emailDomain; export const handler = async (event, context, callback) => { console.log('Spam filter starting'); const sesNotification = event.Records[0].ses; const messageId = sesNotification.mail.messageId; const receipt = sesNotification.receipt; console.log('Processing message:', messageId); // If DMARC verdict is FAIL and the sending domain's policy is REJECT // (p=reject), bounce the email. if (receipt.dmarcVerdict.status === 'FAIL' && receipt.dmarcPolicy.status === 'REJECT') { // The values that make up the body of the bounce message. const sendBounceParams = { BounceSender: `mailer-daemon@${emailDomain}`, OriginalMessageId: messageId, MessageDsn: { ReportingMta: `dns; ${emailDomain}`, ArrivalDate: new Date(), ExtensionFields: [], }, // Include custom text explaining why the email was bounced. Explanation: "Unauthenticated email is not accepted due to the sending domain's DMARC policy.", BouncedRecipientInfoList: receipt.recipients.map((recipient) => ({ Recipient: recipient, // Bounce with 550 5.6.1 Message content rejected BounceType: 'ContentRejected', })), }; console.log('Bouncing message with parameters:'); console.log(JSON.stringify(sendBounceParams, null, 2)); const sendBounceCommand = new SendBounceCommand(sendBounceParams); // Try to send the bounce. try { const response = await sesClient.send(sendBounceCommand); console.log(response); console.log(`Bounce for message ${messageId} sent, bounce message ID: ${response.MessageId}`); // Stop processing additional receipt rules in the rule set. callback(null, {disposition: 'STOP_RULE_SET'}); } catch (e) { // If something goes wrong, log the issue. console.log(`An error occurred while sending bounce for message: ${messageId}`, e); // Perform any additional error handling here callback(e) } // If the DMARC verdict is anything else (PASS, QUARANTINE or GRAY), accept // the message and process remaining receipt rules in the rule set. } else { console.log('Accepting message:', messageId); callback(null, {disposition: 'CONTINUE'}); } }; ``` # Ação Deliver to S3 bucket (Entregar ao bucket do S3) A ação **Entregar ao bucket do S3** entrega o e-mail para um bucket do S3 e, opcionalmente, notifica você pelo SNS e mais. Essa ação tem as seguintes opções. + **Bucket do S3**: o nome do bucket do S3 no qual salvar e-mails recebidos. Você também pode criar um novo bucket do S3 ao criar sua ação escolhendo **Criar bucket do S3**. O Amazon SES fornece o e-mail bruto, não modificado, normalmente no formato Multipurpose Internet Mail Extensions (MIME). Para obter mais informações sobre o formato MIME, consulte [RFC 2045](https://tools.ietf.org/html/rfc2045). **Importante** O bucket do Amazon S3 deve existir em uma região onde o SES [Recebimento de e-mail](regions.md#region-receive-email) está disponível; caso contrário, você deve usar a opção de perfil do IAM explicada abaixo. Quando você salva seus e-mails em um bucket do S3, o tamanho máximo padrão do e-mail (incluindo cabeçalhos) é de 40 MB. O SES não é compatível com regras de recebimento que são carregadas para buckets do S3 habilitados com o bloqueio de objeto configurado com um período padrão de retenção. Se estiver aplicando criptografia no bucket do S3 por meio da especificação de sua própria chave do KMS, use o ARN totalmente qualificado da chave do KMS e não o alias da chave do KMS. Se for usado o alias, os dados podem acabar sendo criptografados com uma chave do KMS que pertence ao solicitante e não ao administrador do bucket. Consulte [Using encryption for cross-account operations](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucket-encryption.html#bucket-encryption-update-bucket-policy) (Usar criptografia para operações entre contas). + **Prefixo de chave de objeto**: aquele a ser usado no bucket do S3. Os prefixos de nomes de chave permitem que você organize o bucket do S3 em uma estrutura de pastas. Por exemplo, se você usar o *E-mail* como **Prefixo de chave de objeto**, seus e-mails serão exibidos no bucket do S3 em uma pasta chamada *E-mail*. + **Criptografia de mensagens**: a opção de criptografar mensagens de e-mail recebidas antes de entregá-las ao seu bucket do S3. + **Chave de criptografia do KMS**: (disponível se a *Criptografia de mensagens* estiver selecionada.) A chave do AWS KMS que o SES deve usar para criptografar seus e-mails antes de salvá-los no bucket do S3. Você pode usar a chave padrão do KMS ou uma chave gerenciada pelo cliente que você criou no KMS. **nota** A chave do KMS escolhida deve estar na mesma região da AWS que o endpoint do SES usado para receber e-mail. + Para usar a chave do KMS padrão, escolha **aws/ses** quando configurar a regra de recebimento no console do SES. Se você usar a API do SES, poderá especificar a chave padrão do KMS fornecendo um ARN na forma de `arn:aws:kms:REGION:AWSACCOUNTID:alias/aws/ses`. Por exemplo, se o seu ID da conta da AWS for 123456789012 e você desejar usar a chave padrão do KMS na região us-east-1, o ARN da chave do KMS padrão seria `arn:aws:kms:us-east-1:123456789012:alias/aws/ses`. Se você usar a chave padrão do KMS, não será necessário realizar etapas extras para conceder permissão ao SES para usar a chave. + Para usar uma chave gerenciada pelo cliente que você criou no KMS, forneça o ARN da chave do KMS e adicione uma instrução à sua política de chave para conceder ao SES permissão para usá-la. Para obter mais informações sobre concessão de permissões, consulte [Concessão de permissões ao Amazon SES para recebimento de e-mails](receiving-email-permissions.md). Para obter mais informações sobre o uso do KMS com o SES, consulte o [Guia do desenvolvedor do AWS Key Management Service](https://docs.aws.amazon.com/kms/latest/developerguide/services-ses.html). Se você não especificar uma chave do KMS no console ou na API, o SES não criptografará seus e-mails. **Importante** Seu e-mail é criptografado pelo SES usando o cliente de criptografia do S3 antes que ele seja enviado para o S3 para armazenamento. Ele não é criptografado usando a criptografia no lado do servidor do S3. Ou seja, você deve usar o cliente de criptografia do S3 para descriptografar o e-mail depois de recuperá-lo do S3, pois o serviço não tem acesso para usar suas chaves do KMS para a descriptografia. Esse cliente de criptografia está disponível no [AWS SDK para Java](https://aws.amazon.com/sdk-for-java/) e no [AWS SDK para Ruby](https://aws.amazon.com/sdk-for-ruby/). Para obter mais detalhes, consulte o [Guia do usuário do Amazon Simple Storage Service](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingClientSideEncryption.html). + **Perfil do IAM**: aquele a ser usado pelo SES para acessar os recursos na ação *Entregar ao S3* (bucket do Amazon S3, tópico do SNS e chave do KMS). Se não for fornecido, você precisará conceder explicitamente permissões ao SES para acessar cada recurso individualmente. Consulte [Concessão de permissões ao Amazon SES para recebimento de e-mails](receiving-email-permissions.md). Se você quiser gravar em um bucket do S3 que existe em uma região onde o *recebimento de e-mails* do SES não está disponível, você deve usar um perfil do IAM que tenha a política de permissão de gravação no S3 como uma política em linha do perfil. Você pode aplicar a política de permissão para essa ação diretamente pelo console: 1. Escolha **Criar novo perfil** no campo **Perfil do IAM**, insira um nome e selecione **Criar perfil**. (A política de confiança do IAM para esse perfil será gerada automaticamente em segundo plano.) 1. Uma vez que a política de confiança do IAM foi gerada automaticamente, você só precisará adicionar a política de permissão da ação ao perfil. Selecione **Visualizar perfil** em **Perfil do IAM** para abrir o console do IAM. 1. Na guia **Permissões**, selecione **Adicionar permissões** e **Criar política em linha**. 1. Na página **Especificar permissões**, selecione **JSON** no **Editor de política**. 1. Copie e cole a política de permissão de [Permissões de perfil do IAM para ação do S3](receiving-email-permissions.md#receiving-email-permissions-s3-iam-role) para o **Editor de política** e substitua os dados de texto em vermelho pelos seus próprios dados. (Não se esqueça de excluir qualquer código de exemplo no editor.) 1. Escolha **Próximo**. 1. Revise e crie sua política de permissão para o perfil do IAM selecionando **Criar política**. 1. Selecione a guia do seu navegador em que está aberta a página do SES **Criar regra**: **Adicionar ações** e continue com as etapas restantes para criar regras. + **Tópico do SNS**: o nome ou o ARN do tópico do Amazon SNS a ser notificado quando um e-mail for salvo no bucket do S3. Um exemplo de ARN de um tópico do SNS é *arn:aws:sns:us-east-1:123456789012:MyTopic*. Você também pode criar um tópico do SNS ao criar sua ação selecionando **Criar tópico do SNS**. Para obter mais informações sobre tópicos do SNS, consulte o [Guia do desenvolvedor do Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html). **nota** O tópico do SNS escolhido deve estar na mesma região da AWS que o endpoint do SES usado para receber e-mail. Use somente a criptografia de chave do KMS *gerenciada pelo cliente* com tópicos do SNS associados às regras de recebimento do SES, pois você precisará editar a política de chave do KMS para permitir que o SES publique no SNS. Isso contrasta com as políticas de chave do KMS *gerenciadas pela AWS*, que não podem ser editadas por padrão. # Ação Publish to Amazon SNS topic (Publicar em um tópico do Amazon SNS) A ação do **SNS** publica o e-mail usando uma notificação do Amazon SNS. A notificação inclui o conteúdo completo do e-mail. Essa ação tem as seguintes opções. + **SNS Topic (Tópico do SNS)**: o nome ou o ARN do tópico do Amazon SNS no qual publicar os e-mails. As notificações do Amazon SNS conterão uma cópia do e-mail bruto, sem modificações, que geralmente está no formato Multipurpose Internet Mail Extensions (MIME). Para obter mais informações sobre o formato MIME, consulte [RFC 2045](https://tools.ietf.org/html/rfc2045). **Importante** Se você escolhe receber e-mails por meio das notificações do Amazon SNS, o tamanho máximo do e-mail (incluindo cabeçalhos) é 150 KB. E-mails grandes serão devolvidos. Se você prever que seus e-mails serão maiores do que isso, salve-os em um bucket do Amazon S3. Um exemplo de ARN de um tópico do Amazon SNS é *arn:aws:sns:us-east-1:123456789012:MyTopic*. Você também pode criar um tópico do Amazon SNS ao configurar a sua ação escolhendo **Create SNS Topic (Criar tópico do SNS)**. Para obter mais informações sobre tópicos do Amazon SNS, consulte o [Guia do desenvolvedor do Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html). **nota** O tópico do Amazon SNS escolhido deve estar na mesma região da AWS que o endpoint do Amazon SES usado para receber e-mail. Use somente a criptografia de chave do KMS *gerenciada pelo cliente* com tópicos do SNS associados às regras de recebimento do SES, pois você precisará editar a política de chave do KMS para permitir que o SES publique no SNS. Isso contrasta com as políticas de chave do KMS *gerenciadas pela AWS*, que não podem ser editadas por padrão. + **Encoding (Codificação)**: a codificação a ser usada para o e-mail na notificação do Amazon SNS. UTF-8 é mais fácil de usar, mas pode não preservar todos os caracteres especiais quando uma mensagem foi codificada com um formato diferente. O Base64 preserva todos os caracteres especiais. Para obter informações sobre UTF-8 e Base64, consulte [RFC 3629](https://tools.ietf.org/html/rfc3629) e [RFC 4648](https://tools.ietf.org/html/rfc4648), respectivamente. Quando você recebe um e-mail, o Amazon SES executa as regras existentes no conjunto de regras de recebimento ativo. Você pode configurar regras de recebimento para enviar notificações usando o Amazon SNS. As regras de recebimento podem enviar dois tipos diferentes de notificações: + **Notificações enviadas a partir de ações do SNS**: quando você adiciona uma ação do [SNS](#receiving-email-action-sns) a uma regra de recebimento, ela envia informações sobre o e-mail. Se a mensagem for de 150 KB ou menor, esse tipo de notificação também incluirá o corpo MIME completo do e-mail. + **Notificações enviadas a partir de outros tipos de ação**: quando você adiciona qualquer outro tipo de ação (incluindo as ações [Bounce (Devolução)](receiving-email-action-bounce.md), [Lambda](receiving-email-action-lambda.md), [Stop Rule Set (Interromper conjunto de regras)](receiving-email-action-stop.md), o [WorkMail](receiving-email-action-workmail.md)) a uma regra de recebimento, pode opcionalmente especificar um tópico do Amazon SNS. Se você fizer isso, receberá notificações quando essas ações forem executadas. Essas notificações contêm informações sobre o e-mail, mas não incluem o conteúdo do e-mail. **Topics** + [Conteúdo de notificações para o recebimento de e-mails do Amazon SES](receiving-email-notifications-contents.md) + [Exemplos de notificações para o recebimento de e-mails do Amazon SES](receiving-email-notifications-examples.md) # Conteúdo de notificações para o recebimento de e-mails do Amazon SES Todas as notificações para recebimento de e-mails são publicadas nos tópicos do Amazon Simple Notification Service (Amazon SNS) JavaScript no formato Object Notation (JSON). Por exemplos de notificação, consulte [Exemplos de notificação ](receiving-email-notifications-examples.md). **Contents** + [Objeto JSON de nível superior](#receiving-email-notifications-contents-top-level-json-object) + [receipt object](#receiving-email-notifications-contents-receipt-object) + [action object](#receiving-email-notifications-contents-action-object) + [dkimVerdict object](#receiving-email-notifications-contents-dkimverdict-object) + [dmarcVerdict object](#receiving-email-notifications-contents-dmarcverdict-object) + [spamVerdict object](#receiving-email-notifications-contents-spamverdict-object) + [spfVerdict object](#receiving-email-notifications-contents-spfverdict-object) + [virusVerdict object](#receiving-email-notifications-contents-virusverdict-object) + [mail object](#receiving-email-notifications-contents-mail-object) + [commonHeaders object](#receiving-email-notifications-contents-mail-object-commonHeaders) ## Objeto JSON de nível superior O objeto JSON de nível superior contém os seguintes campos. | Nome do campo | Description | | --- | --- | | notificationType | O tipo de notificação. Para esse tipo de notificação, o valor é sempre `Received`. | | [`receipt`](#receiving-email-notifications-contents-receipt-object) | O objeto que contém informações sobre a entrega de e-mails. | | [`mail`](#receiving-email-notifications-contents-mail-object) | O objeto que contém informações sobre o e-mail associado à notificação. | | content | String que contém o e-mail bruto, não modificado, normalmente no formato Multipurpose Internet Mail Extensions (MIME). Para obter mais informações sobre o formato MIME, consulte [RFC 2045](https://tools.ietf.org/html/rfc2045). Este campo só está presente somente se a notificação foi acionada por uma ação do SNS. As notificações acionadas por todas as outras ações não contêm esse campo. | ## receipt object O objeto `receipt` tem os seguintes campos. | Nome do campo | Description | | --- | --- | | [`action`](#receiving-email-notifications-contents-action-object) | O objeto que encapsula informações sobre a ação que foi executada. Para obter uma lista de valores possíveis, consulte [action object](#receiving-email-notifications-contents-action-object). | | [`dkimVerdict`](#receiving-email-notifications-contents-dkimverdict-object) | Objeto que indica se a verificação de correio DomainKeys identificado (DKIM) foi aprovada. Para obter uma lista de valores possíveis, consulte [dkimVerdict object](#receiving-email-notifications-contents-dkimverdict-object). | | dmarcPolicy | Indica as configurações de Domain-based Message Authentication, Reporting & Conformance (DMARC) para o domínio de envio. Esse campo só será exibido se a mensagem não passar na autenticação de DMARC. Os valores possíveis para esse campo são:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/ses/latest/dg/receiving-email-notifications-contents.html) | | [`dmarcVerdict`](#receiving-email-notifications-contents-dmarcverdict-object) | O objeto que indica se a verificação de Domain-based Message Authentication, Reporting & Conformance (DMARC) foi bem-sucedida. Para obter uma lista de valores possíveis, consulte [dmarcVerdict object](#receiving-email-notifications-contents-dmarcverdict-object). | | processingTimeMillis | Sequência que especifica o período, em milissegundos, do momento em que o Amazon SES recebeu a mensagem até o momento em que ele acionou a ação. | | recipients | Uma lista de destinatários (especificamente, os endereços de RCPT TO do envelope) que foram correspondidos pela [regra de recebimento](receiving-email-receipt-rules-console-walkthrough.md) ativa. Os endereços listados aqui podem ser diferentes daqueles listados no campo `destination` no [mail object](#receiving-email-notifications-contents-mail-object). | | [`spamVerdict`](#receiving-email-notifications-contents-spamverdict-object) | O objeto que indica se a mensagem é spam. Para obter uma lista de valores possíveis, consulte [spamVerdict object](#receiving-email-notifications-contents-spamverdict-object). | | [`spfVerdict`](#receiving-email-notifications-contents-spfverdict-object) | O objeto que indica se a verificação Sender Policy Framework (SPF) foi bem-sucedida. Para obter uma lista de valores possíveis, consulte [spfVerdict object](#receiving-email-notifications-contents-spfverdict-object). | | timestamp | Sequência que especifica a data e a hora em que a ação foi acionada, no formato [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). | | [virusVerdict](#receiving-email-notifications-contents-virusverdict-object) | O objeto que indica se a mensagem contém vírus. Para obter uma lista de valores possíveis, consulte [virusVerdict object](#receiving-email-notifications-contents-virusverdict-object). | ### action object O objeto `action` tem os seguintes campos. | Nome do campo | Description | | --- | --- | | type | String que indica o tipo de ação que foi executada. Os valores possíveis são `S3`, `SNS`, `Bounce`, `Lambda`, `Stop` e `WorkMail`. | | topicArn | Sequência que contém o nome do recurso da Amazon (ARN) do tópico do Amazon SNS no qual a notificação foi publicada. | | bucketName | Sequência que contém o nome do bucket do Amazon S3 no qual a mensagem foi publicada. Presente apenas para o tipo de ação do S3. | | objectKey | Sequência que contém um nome que identifica exclusivamente o e-mail no bucket do Amazon S3. Ela é igual ao `messageId` em [mail object](#receiving-email-notifications-contents-mail-object). Presente apenas para o tipo de ação do S3. | | smtpReplyCode | String que contém o código de resposta SMTP, conforme definido pelo [RFC 5321](https://tools.ietf.org/html/rfc5321). Presente apenas para o tipo de ação de devolução. | | statusCode | String que contém o código de status aprimorado SMTP, conforme definido pelo [RFC 3463](https://tools.ietf.org/html/rfc3463). Presente apenas para o tipo de ação de devolução. | | message | String que contém o texto legível a ser incluído na mensagem de devolução. Presente apenas para o tipo de ação de devolução. | | sender | String que contém o endereço do remetente do e-mail que foi devolvido. Esse é o endereço de e-mail a partir do qual a mensagem de devolução foi enviada. Presente apenas para o tipo de ação de devolução. | | functionArn | Sequência que contém o ARN da função do Lambda que foi acionada. Presente apenas para o tipo de ação do Lambda. | | invocationType | Sequência que contém o tipo de invocação da função do Lambda. Os possíveis valores são `RequestResponse` e `Event`. Presente apenas para o tipo de ação do Lambda. | | organizationArn | Cadeia de caracteres que contém o ARN da organização Amazon WorkMail. Presente somente para o tipo de WorkMail ação. | ### dkimVerdict object O objeto `dkimVerdict` tem os seguintes campos. | Nome do campo | Description | | --- | --- | | status | String que contém o veredicto do DKIM. Os valores possíveis são: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/ses/latest/dg/receiving-email-notifications-contents.html) | ### dmarcVerdict object O objeto `dmarcVerdict` tem os seguintes campos. | Nome do campo | Description | | --- | --- | | status | String que contém o veredicto do DMARC. Os valores possíveis são: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/ses/latest/dg/receiving-email-notifications-contents.html) | ### spamVerdict object O objeto `spamVerdict` tem os seguintes campos. | Nome do campo | Description | | --- | --- | | status | String que contém o resultado da verificação de spam. Os valores possíveis são: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/ses/latest/dg/receiving-email-notifications-contents.html) | ### spfVerdict object O objeto `spfVerdict` tem os seguintes campos. | Nome do campo | Description | | --- | --- | | status | String que contém o veredicto do SPF. Os valores possíveis são: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/ses/latest/dg/receiving-email-notifications-contents.html) | ### virusVerdict object O objeto `virusVerdict` tem os seguintes campos. | Nome do campo | Description | | --- | --- | | status | String que contém o resultado da verificação de vírus. Os valores possíveis são: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/ses/latest/dg/receiving-email-notifications-contents.html) | ## mail object O objeto `mail` tem os seguintes campos. | Nome do campo | Description | | --- | --- | | destination | Uma lista completa de todos os endereços de destinatários (incluindo os destinatários Para: e Cc:) dos cabeçalhos MIME dos e-mails de entrada. | | messageId | Sequência que contém o ID exclusivo atribuído ao e-mail pelo Amazon SES. Se o e-mail foi entregue ao Amazon S3, o ID da mensagem também é a chave de objeto do Amazon S3 que foi usada para gravar a mensagem em seu bucket do Amazon S3. | | source | Sequência que contém o endereço de e-mail (especificamente o endereço MAIL FROM (E-MAIL DE) do envelope) do qual o e-mail foi enviado. | | timestamp | Cadeia de caracteres que contém a hora em que o e-mail foi recebido, em ISO8601 formato. | | headers | Uma lista de cabeçalhos do Amazon SES e seus cabeçalhos personalizados. Cada cabeçalho tem os seguintes campos: `name` e `value`. | | [`commonHeaders`](#receiving-email-notifications-contents-mail-object-commonHeaders) | Uma lista de cabeçalhos comuns a todos os e-mails. Cada cabeçalho tem os seguintes campos: `name` e `value`. | | headersTruncated | Sequência que especifica se os cabeçalhos foram truncados na notificação, o que acontece se os cabeçalhos tiverem mais do que 10 KB. Os possíveis valores são `true` e `false`. | ### commonHeaders object O objeto `commonHeaders` pode ter os campos mostrados na tabela a seguir. Os campos presentes neste objeto variam de acordo com quais campos estavam presentes no e-mail recebido. | Nome do campo | Description | | --- | --- | | messageId | O ID da mensagem original. | | date | A data e hora em que o Amazon SES recebeu a mensagem. | | to | O cabeçalho To do e-mail. | | cc | O cabeçalho CC do e-mail. | | bcc | O cabeçalho BCC do e-mail. | | from | O cabeçalho From do e-mail. | | sender | O cabeçalho Sender do e-mail. | | returnPath | O cabeçalho Return-Path do e-mail. | | replyTo | O cabeçalho Reply-To do e-mail. | | subject | O cabeçalho Subject do e-mail. | # Exemplos de notificações para o recebimento de e-mails do Amazon SES Esta seção inclui exemplos dos seguintes tipos de notificações: + [Uma notificação enviada como resultado de uma ação do SNS.](#receiving-email-notifications-examples-sns-action) + [Uma notificação enviada como resultado de outro tipo de ação](#receiving-email-notifications-examples-alert) (uma *notificação de alerta*). ## Notificação de uma ação do SNS Esta seção contém um exemplo de notificação de ação do SNS. Diferentemente da notificação de alerta mostrada anteriormente, ela inclui uma seção `content` que contém o e-mail, que está geralmente no formato Multipurpose Internet Mail Extensions (MIME). ``` { "notificationType":"Received", "receipt":{ "timestamp":"2015-09-11T20:32:33.936Z", "processingTimeMillis":222, "recipients":[ "recipient@example.com" ], "spamVerdict":{ "status":"PASS" }, "virusVerdict":{ "status":"PASS" }, "spfVerdict":{ "status":"PASS" }, "dkimVerdict":{ "status":"PASS" }, "action":{ "type":"SNS", "topicArn":"arn:aws:sns:us-east-1:012345678912:example-topic" } }, "mail":{ "timestamp":"2015-09-11T20:32:33.936Z", "source":"61967230-7A45-4A9D-BEC9-87CBCF2211C9@example.com", "messageId":"d6iitobk75ur44p8kdnnp7g2n800", "destination":[ "recipient@example.com" ], "headersTruncated":false, "headers":[ { "name":"Return-Path", "value":"<0000014fbe1c09cf-7cb9f704-7531-4e53-89a1-5fa9744f5eb6-000000@amazonses.com>" }, { "name":"Received", "value":"from a9-183.smtp-out.amazonses.com (a9-183.smtp-out.amazonses.com [54.240.9.183]) by inbound-smtp.us-east-1.amazonaws.com with SMTP id d6iitobk75ur44p8kdnnp7g2n800 for recipient@example.com; Fri, 11 Sep 2015 20:32:33 +0000 (UTC)" }, { "name":"DKIM-Signature", "value":"v=1; a=rsa-sha256; q=dns/txt; c=relaxed/simple; s=ug7nbtf4gccmlpwj322ax3p6ow6yfsug; d=amazonses.com; t=1442003552; h=From:To:Subject:MIME-Version:Content-Type:Content-Transfer-Encoding:Date:Message-ID:Feedback-ID; bh=DWr3IOmYWoXCA9ARqGC/UaODfghffiwFNRIb2Mckyt4=; b=p4ukUDSFqhqiub+zPR0DW1kp7oJZakrzupr6LBe6sUuvqpBkig56UzUwc29rFbJF hlX3Ov7DeYVNoN38stqwsF8ivcajXpQsXRC1cW9z8x875J041rClAjV7EGbLmudVpPX 4hHst1XPyX5wmgdHIhmUuh8oZKpVqGi6bHGzzf7g=" }, { "name":"From", "value":"sender@example.com" }, { "name":"To", "value":"recipient@example.com" }, { "name":"Subject", "value":"Example subject" }, { "name":"MIME-Version", "value":"1.0" }, { "name":"Content-Type", "value":"text/plain; charset=UTF-8" }, { "name":"Content-Transfer-Encoding", "value":"7bit" }, { "name":"Date", "value":"Fri, 11 Sep 2015 20:32:32 +0000" }, { "name":"Message-ID", "value":"<61967230-7A45-4A9D-BEC9-87CBCF2211C9@example.com>" }, { "name":"X-SES-Outgoing", "value":"2015.09.11-54.240.9.183" }, { "name":"Feedback-ID", "value":"1.us-east-1.Krv2FKpFdWV+KUYw3Qd6wcpPJ4Sv/pOPpEPSHn2u2o4=:AmazonSES" } ], "commonHeaders":{ "returnPath":"0000014fbe1c09cf-7cb9f704-7531-4e53-89a1-5fa9744f5eb6-000000@amazonses.com", "from":[ "sender@example.com" ], "date":"Fri, 11 Sep 2015 20:32:32 +0000", "to":[ "recipient@example.com" ], "messageId":"<61967230-7A45-4A9D-BEC9-87CBCF2211C9@example.com>", "subject":"Example subject" } }, "content":"Return-Path: <61967230-7A45-4A9D-BEC9-87CBCF2211C9@example.com>\r\nReceived: from a9-183.smtp-out.amazonses.com (a9-183.smtp-out.amazonses.com [54.240.9.183])\r\n by inbound-smtp.us-east-1.amazonaws.com with SMTP id d6iitobk75ur44p8kdnnp7g2n800\r\n for recipient@example.com;\r\n Fri, 11 Sep 2015 20:32:33 +0000 (UTC)\r\nDKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/simple;\r\n\ts=ug7nbtf4gccmlpwj322ax3p6ow6yfsug; d=amazonses.com; t=1442003552;\r\n\th=From:To:Subject:MIME-Version:Content-Type:Content-Transfer-Encoding:Date:Message-ID:Feedback-ID;\r\n\tbh=DWr3IOmYWoXCA9ARqGC/UaODfghffiwFNRIb2Mckyt4=;\r\n\tb=p4ukUDSFqhqiub+zPR0DW1kp7oJZakrzupr6LBe6sUuvqpBkig56UzUwc29rFbJF\r\n\thlX3Ov7DeYVNoN38stqwsF8ivcajXpQsXRC1cW9z8x875J041rClAjV7EGbLmudVpPX\r\n\t4hHst1XPyX5wmgdHIhmUuh8oZKpVqGi6bHGzzf7g=\r\nFrom: sender@example.com\r\nTo: recipient@example.com\r\nSubject: Example subject\r\nMIME-Version: 1.0\r\nContent-Type: text/plain; charset=UTF-8\r\nContent-Transfer-Encoding: 7bit\r\nDate: Fri, 11 Sep 2015 20:32:32 +0000\r\nMessage-ID: <61967230-7A45-4A9D-BEC9-87CBCF2211C9@example.com>\r\nX-SES-Outgoing: 2015.09.11-54.240.9.183\r\nFeedback-ID: 1.us-east-1.Krv2FKpFdWV+KUYw3Qd6wcpPJ4Sv/pOPpEPSHn2u2o4=:AmazonSES\r\n\r\nExample content\r\n" } ``` ## Notificação de alerta Esta seção contém um exemplo de notificação do Amazon SNS que pode ser acionada por uma ação do S3. Notificações acionadas por ações do Lambda, de devolução, de interrupção e ações do WorkMail são semelhantes. Embora a notificação contenha informações sobre o e-mail, não apresenta o conteúdo do e-mail em si. ``` { "notificationType": "Received", "receipt": { "timestamp": "2015-09-11T20:32:33.936Z", "processingTimeMillis": 406, "recipients": [ "recipient@example.com" ], "spamVerdict": { "status": "PASS" }, "virusVerdict": { "status": "PASS" }, "spfVerdict": { "status": "PASS" }, "dkimVerdict": { "status": "PASS" }, "action": { "type": "S3", "topicArn": "arn:aws:sns:us-east-1:012345678912:example-topic", "bucketName": "my-S3-bucket", "objectKey": "\email" } }, "mail": { "timestamp": "2015-09-11T20:32:33.936Z", "source": "0000014fbe1c09cf-7cb9f704-7531-4e53-89a1-5fa9744f5eb6-000000@amazonses.com", "messageId": "d6iitobk75ur44p8kdnnp7g2n800", "destination": [ "recipient@example.com" ], "headersTruncated": false, "headers": [ { "name": "Return-Path", "value": "<0000014fbe1c09cf-7cb9f704-7531-4e53-89a1-5fa9744f5eb6-000000@amazonses.com>" }, { "name": "Received", "value": "from a9-183.smtp-out.amazonses.com (a9-183.smtp-out.amazonses.com [54.240.9.183]) by inbound-smtp.us-east-1.amazonaws.com with SMTP id d6iitobk75ur44p8kdnnp7g2n800 for recipient@example.com; Fri, 11 Sep 2015 20:32:33 +0000 (UTC)" }, { "name": "DKIM-Signature", "value": "v=1; a=rsa-sha256; q=dns/txt; c=relaxed/simple; s=ug7nbtf4gccmlpwj322ax3p6ow6yfsug; d=amazonses.com; t=1442003552; h=From:To:Subject:MIME-Version:Content-Type:Content-Transfer-Encoding:Date:Message-ID:Feedback-ID; bh=DWr3IOmYWoXCA9ARqGC/UaODfghffiwFNRIb2Mckyt4=; b=p4ukUDSFqhqiub+zPR0DW1kp7oJZakrzupr6LBe6sUuvqpBkig56UzUwc29rFbJF hlX3Ov7DeYVNoN38stqwsF8ivcajXpQsXRC1cW9z8x875J041rClAjV7EGbLmudVpPX 4hHst1XPyX5wmgdHIhmUuh8oZKpVqGi6bHGzzf7g=" }, { "name": "From", "value": "sender@example.com" }, { "name": "To", "value": "recipient@example.com" }, { "name": "Subject", "value": "Example subject" }, { "name": "MIME-Version", "value": "1.0" }, { "name": "Content-Type", "value": "text/plain; charset=UTF-8" }, { "name": "Content-Transfer-Encoding", "value": "7bit" }, { "name": "Date", "value": "Fri, 11 Sep 2015 20:32:32 +0000" }, { "name": "Message-ID", "value": "<61967230-7A45-4A9D-BEC9-87CBCF2211C9@example.com>" }, { "name": "X-SES-Outgoing", "value": "2015.09.11-54.240.9.183" }, { "name": "Feedback-ID", "value": "1.us-east-1.Krv2FKpFdWV+KUYw3Qd6wcpPJ4Sv/pOPpEPSHn2u2o4=:AmazonSES" } ], "commonHeaders": { "returnPath": "0000014fbe1c09cf-7cb9f704-7531-4e53-89a1-5fa9744f5eb6-000000@amazonses.com", "from": [ "sender@example.com" ], "date": "Fri, 11 Sep 2015 20:32:32 +0000", "to": [ "recipient@example.com" ], "messageId": "<61967230-7A45-4A9D-BEC9-87CBCF2211C9@example.com>", "subject": "Example subject" } } } ``` # Ação Stop rule set (Interromper conjunto de regras) A ação **Stop (Interromper)** termina a avaliação do conjunto de regras de recebimento e, opcionalmente, o notifica por meio do Amazon SNS. Essa ação tem as seguintes opções. + **SNS Topic (Tópico do SNS)**: o nome ou ARN do tópico do Amazon SNS a ser notificado quando a ação de interrupção for realizada. Um exemplo de ARN de um tópico do Amazon SNS é *arn:aws:sns:us-east-1:123456789012:MyTopic*. Você também pode criar um tópico do Amazon SNS ao configurar a sua ação escolhendo **Create SNS Topic (Criar tópico do SNS)**. Para obter mais informações sobre tópicos do Amazon SNS, consulte o [Guia do desenvolvedor do Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html). **nota** O tópico do Amazon SNS escolhido deve estar na mesma região da AWS que o endpoint do Amazon SES usado para receber e-mails. # Ação Integrate with Amazon WorkMail (Integrar com o Amazon WorkMail) A ação **WorkMail** integra com o Amazon WorkMail. Se o Amazon WorkMail realize todo o processamento de seus e-mails, normalmente você não usará essa ação diretamente, pois o Amazon WorkMail cuida da configuração. Essa ação tem as seguintes opções. + **Organization ARN (ARN da organização)**: o ARN da organização do Amazon WorkMail. Os ARNs da organização do Amazon WorkMail estão no formato `arn:aws:workmail:region:account_ID:organization/organization_ID`, em que: + `region` é a região em que você está usando o Amazon SES e o Amazon WorkMail. (Você deve usá-los na mesma região.) Um exemplo é us-east-1. + `account_ID` é o ID da conta da AWS. Você pode encontrar o ID de sua conta da AWS na página [Conta](https://console.aws.amazon.com/billing/home?#/account) do Console de Gerenciamento da AWS. + `organization_ID` é um identificador exclusivo que o Amazon WorkMail gera quando você cria uma organização. Você pode localizar o ID da organização no console do Amazon WorkMail na página Organization Settings (Configurações da organização) da sua organização. Um exemplo de ARN de organização do Amazon WorkMail é *arn:aws:workmail:us-east-1:123456789012:organization/m-68755160c4cb4e29a2b2f8fb58f359d7*. Para obter informações sobre organizações do Amazon WorkMail, consulte o [Guia do administrador do Amazon WorkMail](https://docs.aws.amazon.com/workmail/latest/adminguide/organizations_overview.html). + **SNS Topic (Tópico do SNS)**: o nome ou ARN do tópico do Amazon SNS a ser notificado quando a ação do Amazon WorkMail for realizada. Um exemplo de ARN de um tópico do Amazon SNS é *arn:aws:sns:us-east-1:123456789012:MyTopic*. Você também pode criar um tópico do Amazon SNS ao configurar a sua ação escolhendo **Create SNS Topic (Criar tópico do SNS)**. Para obter mais informações sobre tópicos do Amazon SNS, consulte o [Guia do desenvolvedor do Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html). **nota** O tópico do Amazon SNS escolhido deve estar na mesma região da AWS que o endpoint do Amazon SES usado para receber e-mails. **nota** O Amazon SES só permite ações do WorkMail em regiões onde o WorkMail está disponível. Consulte [Endpoints e cotas do Amazon WorkMail](https://docs.aws.amazon.com/general/latest/gr/workmail.html) na Referência geral da AWS. # Demonstração da criação de filtros de endereços IP no console Esta seção demonstra como configurar filtros de endereço IP usando o console do Amazon SES. A filtragem de endereços IP permite que você forneça um amplo nível de controle. Esses filtros de IP permitem bloquear ou permitir explicitamente todas as mensagens de endereços IP ou intervalos de endereços IP específicos. Opcionalmente, você pode usar a API `CreateReceiptFilter` para criar um filtro de endereço IP, como descrito na [Referência da API do Amazon Simple Email Service](https://docs.aws.amazon.com/ses/latest/APIReference/API_CreateReceiptFilter.html). **nota** Se você quiser apenas receber e-mails de uma lista finita de endereços IP conhecidos, configure uma lista de bloqueio que contenha `0.0.0.0/0`e configure uma lista de permissão que contenha os endereços IP confiáveis. Essa configuração bloqueia todos os endereços IP por padrão e só permite e-mails de endereços IP que você especificar explicitamente. ## Pré-requisitos Os seguintes pré-requisitos devem ser atendidos antes de prosseguir com a configuração do controle de e-mail baseado em destinatário usando filtros de endereço IP: 1. Primeiro, você precisa [criar e verificar uma identidade de domínio](verify-addresses-and-domains.md) no Amazon SES. 1. Em seguida, você precisa especificar quais servidores de e-mail podem aceitar e-mails para seu domínio [publicando um registro MX](receiving-email-mx-record.md) para as configurações de DNS do seu domínio. (O registro MX deve se referir ao endpoint do Amazon SES que recebe e-mails para a AWS região em que você usa o Amazon SES.) ## Criar filtros de endereços IP **Para criar filtros de endereços IP usando o console** 1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon SES em [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/). 1. No painel de navegação esquerdo, escolha **Email Receiving (Recebiment de e-mails)**. 1. Selecione a guia **IP address filters (Filtros de endereços IP)**. 1. Selecione **Create Filter (Criar filtro)**. 1. Digite um nome exclusivo para o seu filtro; a legenda do campo indicará os requisitos de sintaxe. (O nome deve conter menos de 64 caracteres alfanuméricos, hífen (-), sublinhado (\$1) e ponto (.). O nome deve começar e terminar com uma letra ou um número.) 1. Insira um endereço IP ou um intervalo de endereços IP; a legenda do campo fornecerá exemplos especificados na sintaxe Classless Inter-Domain Routing (CIDR). (Um exemplo de um endereço IP único é 10.0.0.1. Um exemplo de um intervalo de endereços IP é 10.0.0.1/24. Para obter mais informações sobre notação CIDR, consulte [RFC 2317](https://tools.ietf.org/html/rfc2317).) 1. Escolha o **tipo de política** selecionando o botão de opção **Block (Bloquear)** ou **Allow (Permitir)**. 1. Escolha **Criar filtro**. 1. Se você quiser adicionar outro filtro IP, escolha **Create filter (Criar filtro)** e repita as etapas anteriores para cada filtro adicional que você desejar adicionar. 1. Se você quiser remover um filtro de endereço IP, selecione-o e escolha a opção **Delete (Excluir)**.