Conjuntos de regras e regras - Amazon Simple Email Service

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á.

Conjuntos de regras e regras

Os conjuntos de regras são contêineres para regras que você atribui a um endpoint de entrada para que ele possa realizar ações em e-mails permitidos pela política de tráfego do endpoint de entrada. Um conjunto de regras pode ser usado por vários endpoints de entrada.

As regras informam ao seu endpoint de entrada como lidar com e-mails recebidos executando as ações definidas na regra quando as mensagens atendem às condições da regra. Cada regra pode ter várias condições e ações. As regras criadas dentro de um conjunto de regras são executadas na ordem especificada dentro do conjunto de regras.

Você cria as condições da regra selecionando uma propriedade de e-mail e um operador condicional para um valor inserido que deve corresponder à mensagem antes que a regra execute suas ações. Você define as ações a serem executadas, bem como sua ordem de execução.

Para maior granularidade, suas regras também podem conter exceções definidas de forma semelhante às condições, mas aqui você está definindo uma condição à qual a mensagem não deve corresponder. As condições e exceções operam de forma independente: você pode criar uma regra com apenas exceções, se quiser, bem como combinar condições e exceções.

Devido à granularidade precisa de como as regras podem ser definidas em um conjunto de regras, a lista a seguir é fornecida para ajudar a ilustrar a relação dos componentes do conjunto de regras:

  • Os conjuntos de regras contêm:

    • Regras: você pode definir a ordem na qual as regras são executadas dentro do conjunto de regras.

      As regras contêm:

      • Condições: a regra será aplicada se a mensagem corresponder à avaliação das condições; e se a regra tiver exceções, veja abaixo.

      • Exceções: a regra será aplicada se a mensagem não corresponder à avaliação das exceções; e se a regra tiver condições, veja acima.

      • Ações: as ações são acionadas quando a regra se aplica; todas as condições correspondem e nenhuma das exceções.

        Você pode definir a ordem na qual as ações são executadas dentro da regra.

Uma vez que cada regra pode ter várias condições, exceções e ações, e o fato de você poder definir a ordem de como as regras e ações são executadas, isso permite criar uma solução de tratamento de e-mail muito personalizada e automatizada, adaptada às suas necessidades comerciais específicas.

Um conjunto de regras é um recurso independente que pode ser usado por mais de um endpoint de entrada, mas as regras pertencem exclusivamente ao conjunto de regras no qual foram criadas. Portanto, você deve primeiro criar um conjunto de regras ou editar um existente antes de criar regras para agir com base no e-mail que chega ao seu endpoint de entrada.

O procedimento da próxima seção demonstra como criar conjuntos de regras e suas regras no console do SES.

Criar conjuntos de regras e regras no console do SES

O procedimento a seguir mostra como usar a página Conjuntos de regras no console do SES para criar conjuntos de regras e suas regras e gerenciar os que você já criou.

Para criar e gerenciar conjuntos de regras e regras usando o console
  1. Faça login no AWS Management Console e abra o console do Amazon SES em https://console.aws.amazon.com/ses/.

  2. No painel de navegação esquerdo, selecione Conjuntos de regras em Mail Manager.

  3. Na página Conjuntos de regras, selecione Criar conjunto de regras e insira um nome exclusivo para o conjunto de regras.

  4. Na página de visão geral do conjunto de regras, selecione Editar e, em seguida, Criar nova regra na página de edição.

  5. Na barra lateral de Detalhes da regra, insira um nome exclusivo para sua regra.

  6. Selecione Adicionar nova condição para criar uma condição à qual a mensagem deve corresponder; ou marque a caixa EXCETO no caso de: seguida de Adicionar nova exceção para criar uma condição à qual a mensagem não deve corresponder.

  7. Crie a condição ou exceção selecionando uma propriedade de e-mail e um operador condicional para o valor inserido. Selecione Adicionar nova condição ou Adicionar nova exceção se quiser adicionar mais condições ou exceções a essa regra. Para saber mais sobre uma propriedade de condição e seus operadores e valores válidos, consulte a referência de condições da regra.

    • Se você estiver inscrito em um Complemento de e-mail, poderá selecioná-lo aqui como uma propriedade de e-mail.

  8. Selecione Adicionar nova ação para definir a ação a ser executada quando as condições da regra forem correspondidas e/ou as exceções não forem correspondidas. Para adicionar mais ações a serem executadas, selecione Adicionar nova ação. Para saber mais sobre ações e seus parâmetros, consulte a referência de Ações de regras.

    • Quando você cria duas ou mais ações, as setas para cima/para baixo são exibidas para que você possa definir a ordem de execução.

    • Para executar as ações de regra Gravar no S3, Entregar na caixa de correio, Arquivar ou Enviar para a Internet, você precisará ter a respectiva política de permissão habilitada para sua conta; caso contrário, a ação da regra falhará.

      Você pode aplicar a política de permissão para qualquer uma dessas ações diretamente do painel de Detalhes da regra depois de selecionar a ação:

    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.)

    2. 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.

    3. Na guia Permissões, selecione Adicionar permissões e Criar política em linha.

    4. Na página Especificar permissões, selecione JSON no Editor de política.

    5. Copie e cole a respectiva política de permissão de Políticas de ação de regra 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).

    6. Escolha Próximo.

    7. Revise e crie sua política de permissão para o perfil do IAM selecionando Criar política.

    8. Selecione a guia do navegador em que está aberta a página Editar conjunto de regras do SES Mail Manager e continue com as etapas restantes para criar regras.

  9. Ao terminar de criar as condições, exceções e ações para a regra, você a salva em seu conjunto de regras escolhendo Salvar conjunto de regras localizado no painel Editar conjunto de regras à esquerda.

  10. Para adicionar mais regras ao conjunto de regras, repita as etapas 4 a 9 acima.

    • Quando você cria duas ou mais regras, as setas para cima/para baixo são exibidas na coluna Reordenar do conjunto de regras para que você possa definir a ordem de execução.

  11. Você pode visualizar e gerenciar os conjuntos de regras que você já criou na página Conjuntos de regras. Se houver um conjunto de regras que você queira remover, selecione o respectivo botão de opção e, em seguida, Excluir.

  12. Para editar um conjunto de regras, selecione seu nome para abrir sua página de visão geral. A partir daqui, selecione Editar, onde é possível reordenar a execução de suas regras, adicionar mais regras escolhendo Criar nova regra ou excluir uma regra selecionando o respectivo botão de opção e, em seguida, Excluir.

  13. Para editar uma regra, selecione o respectivo botão de opção. Em qualquer um dos contêineres na barra lateral de Detalhes da regra, você pode editar qualquer condição ou exceção e alterar ou reordenar qualquer uma das ações. Você também pode remover condições, exceções e ações, bem como adicionar novas.

  14. Quando terminar todas as edições, salve suas alterações selecionando Salvar conjunto de regras localizado no painel Editar conjunto de regras à esquerda.

Referência para condições e ações de regras

Condições de regra

A tabela de referência a seguir lista todas as propriedades da regra que estão disponíveis para criar uma condição de regra (ou exceção) e são categorizadas por seu tipo de expressão. As propriedades da regra que compartilham o mesmo tipo de expressão também compartilham os mesmos operadores e valores. Selecionar o tipo de expressão de uma propriedade levará você à página de referência na Referência da API do SES Mail Manager, que lista todos os operadores disponíveis e valores válidos para essa propriedade.

Condições da regra: propriedades, operadores e valores
Propriedade Tipo de expressão

Do endereço

Para o endereço

Endereço CC

Enviar de

Endereço do destinatário

Sujeito

Olá

Cabeçalho de MIME

Operadores e valores válidos para expressões de string

Intervalo de IP

Operadores e valores válidos para expressões IP

Tamanho máx. da mensagem

Operadores e valores válidos para expressões numéricas

DKIM

SPF

Trend Micro Virus Scanning (se inscrito)

Operadores e valores válidos para expressões de veredito

TLS

TLS wrapped

Ler recibo

Operadores e valores válidos para expressões booleanas

Política de DMARC

Operadores e valores válidos para expressões DMARC

Ações de regra

A tabela de referência a seguir lista todas as ações de regra que podem ser executadas quando as condições de uma regra são atendidas ou suas exceções não são atendidas. Ao selecionar uma ação, você será direcionado para a respectiva página de referência na Referência da API do SES Mail Manager, que lista os parâmetros e seus formatos para a ação. A tabela usa os nomes das ações adotados no console do Mail Manager: os nomes das APIs podem ser um pouco diferentes.

nota

Em algumas referências da API, haverá um parâmetro ActionFailurePolicy que pode ser definido como Continuar ou Descartar se a ação falhar. Isso só se aplica ao uso da API; ao usar o console, ActionFailurePolicy foi definido com o valor padrão de Continuar.

Ações de regras: ações e parâmetros
Ações e seus parâmetros Descrição

Gravar em S3

Grava o conteúdo de MIME do e-mail em um bucket S3.

Ação de transmissão SMTP

Transmite o e-mail via SMTP para outro servidor SMTP específico.

Ação de arquivamento

Arquiva o e-mail entregando-o em um arquivo do Amazon SES.

Adicionar cabeçalho

Adiciona um cabeçalho personalizado ao e-mail recebido.

Substituição de destinatários de e-mail

Substitui os destinatários do e-mail pela lista de destinatários fornecida. Se a condição dessa ação se aplicar somente a um subconjunto de destinatários, somente esses destinatários serão substituídos.

Entregar na caixa de correio

Entrega o e-mail em uma WorkMail caixa de correio da Amazon.

Entregue para a Q Business

Entrega um e-mail para um aplicativo Amazon Q Business para inclusão em sua base de conhecimento.

Enviar para a Internet

Usa o SES para enviar o e-mail aos destinatários na lista de destinatários do e-mail.

Ação descartar

Para e-mails com vários destinatários, se essa ação se aplicar a um ou mais (mas não a todos) desses destinatários, eles serão retirados da lista de destinatários do e-mail e o processamento contínuo das regras será aplicado aos destinatários restantes. Se essa ação se aplicar a todos os destinatários, o processamento das regras será interrompido, pois todos os destinatários serão retirados da lista de destinatários e não receberão o e-mail.