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á.
Listas de endereços
As listas de endereços são um recurso do Mail Manager que permite criar e gerenciar listas de endereços de e-mail e domínios que você pode usar em políticas de tráfego e conjuntos de regras para processar e-mails recebidos com base no fato de o destinatário ou remetente de uma mensagem pertencer ou não a uma lista específica. As listas de endereços oferecem um controle mais granular sobre os fluxos de e-mail e ajudam a simplificar o gerenciamento de cenários complexos de roteamento de e-mails.
O que são as listas de endereços?
As listas de endereços são contêineres de domínios e endereços de e-mail que você pode usar para filtrar e processar mensagens de e-mail. Elas oferecem uma maneira conveniente de agrupar endereços relacionados e aplicar regras de roteamento e políticas de tráfego de forma coletiva.
Os principais casos de uso das listas de endereços incluem:
-
Listas de negação para bloquear remetentes ou domínios de spam conhecidos.
-
Listas de permissão para garantir a entrega de remetentes confiáveis.
-
Validação de destinatário para rejeitar com antecedência e-mails enviados a destinatários inexistentes.
-
Roteamento baseado em perfis para aplicar regras diferentes com base nos perfis dos destinatários.
-
Políticas baseadas em grupos para impor políticas a grupos específicos de usuários.
Como funcionam as listas de endereços
As listas de endereços no SES simplificam o gerenciamento de e-mails ao permitir a criação e manutenção de coleções de domínios e endereços de e-mail. Depois de criadas, essas listas são integradas aos fluxos de trabalho de e-mail por meio de políticas e regras de tráfego.
Quando o SES processa um e-mail, ele verifica a lista de endereços relevante para determinar se o remetente ou destinatário é membro. Com base nessa associação e nas políticas e regras configuradas, o SES então toma as medidas apropriadas, como rotear, filtrar ou rejeitar o e-mail. Esse processo permite um controle eficiente e granular sobre o tráfego de e-mails.
Configurar listas de endereços
Criar e preencher uma lista de endereços
Parte da criação de uma lista de endereços no console é preenchê-la com um ou mais endereços. Usando o Gerenciador de e-mail APIs, você pode criar listas de endereços vazias e preenchê-las posteriormente. Esta seção mostrará como fazer isso com procedimentos do console e exemplos da AWS CLI .
Para criar e preencher uma lista de endereços:
-
Abra o console do SES em https://console.aws.amazon.com/ses/
. -
No painel de navegação do Mail Manager, selecione Listas de endereços.
-
Escolha Criar lista de endereços e insira um nome no campo Nome da lista de endereços.
-
Selecione Entrada manual ou Upload em massa e siga as respectivas etapas:
-
Para entrada manual: insira um ou mais domínios ou endereços de e-mail no console.
Se você usar o caractere curinga de asterisco (
*), os seguintes formatos se aplicarão:-
Só é permitido um
*no endereço:-
O
*deve estar antes ou depois de @ quando a entrada for um endereço de e-mail. -
Quando
*está na parte local, a parte local pode ter de zero a 19 caracteres, excluindo o.* -
Quando o
*estiver no domínio, o nível do subdomínio poderá ser 2 a 9, excluindo o*.
-
-
Exemplos de formatos válidos com caractere curinga:
-
*.domain1.com a *.domain8.domain7...domain1.com
-
* @domain .com até 1234567890123456789* @domain .com
-
local@*.domain1.com a local@*.domain8.domain7...domain1.com
-
-
-
Para upload em massa: selecione Escolher arquivo e escolha um arquivo CSV ou JSON do seu computador contendo os endereços a serem carregados.
Use o formato mostrado no exemplo para cada tipo de arquivo:
-
Exemplo de arquivo CSV (observe que o cabeçalho
addressé obrigatório):addressuser1@domain.comuser2@*.domain.com*@domain.com -
Exemplo de arquivo JSON:
{ "items": [ { "address": "user1@domain.com" }, { "address": "user2@*.domain.com" }, { "address": "*@domain.com" } ] }
-
-
Depois de terminar de adicionar endereços ou selecionar um arquivo em massa, escolha Criar lista de endereços.
Usando o AWS CLI:
Crie a lista de endereços
aws mailmanager create-address-list --address-list-name "MyDenyList"
Preencha a lista de endereços
-
Upload único
aws mailmanager register-member-to-address-list \ --address-list-idal-123456789abc\ --address "user@example.com" -
Upload em massa
Para uploads em massa, primeiro você precisa criar um trabalho de importação especificando o formato CSV ou JSON:
aws mailmanager create-address-list-import-job \ --address-list-id "al-123456789abc" \ --name "MyImportJob" \ --import-data-format ImportDataType=CSVIsso retorna um ID de trabalho e um URL pré-assinado. Use esse URL pré-assinado para fazer upload do arquivo CSV ou JSON em um bucket do S3, conforme mostrado no exemplo a seguir, usando o comando curl:
curl -X PUT -T "/path/to/file" "pre-signed URL"Depois de fazer upload, inicie o trabalho de importação usando o ID de trabalho retornado no comando anterior:
aws mailmanager start-address-list-import-job --job-id "job-123456789"
Gerenciar listas de endereços
Você pode atualizar, visualizar e excluir listas de endereços conforme necessário.
Tópicos
Atualizar uma lista de endereços
É possível atualizar uma lista de endereços adicionando ou removendo endereços e, opcionalmente, adicionando ou removendo tags.
Para atualizar uma lista de endereços:
-
Na página Listas de endereços, selecione o nome da lista de endereços que deseja editar.
-
Para adicionar endereços, escolha Adicionar endereço de e-mail e continue com o método de entrada manual ou upload em massa, conforme explicado em Criar e preencher uma lista de endereços.
-
Para remover endereços, marque a caixa de seleção ao lado de cada endereço que deseja remover, escolha Remover endereço de e-mail e confirme a exclusão.
-
(Opcional) Adicione ou remova Etiquetas da sua lista de endereços escolhendo Gerenciar tags.
Usando o AWS CLI:
Adicionar
aws mailmanager register-member-to-address-list \ --address-list-idal-123456789abc\ --address "user@example.com"
Remover
aws mailmanager deregister-member-from-address-list \ --address-list-idal-123456789abc\ --address "user@example.com"
Visualizar os detalhes da lista de endereços
Para visualizar os detalhes da lista de endereços:
-
Na página Listas de endereços, selecione o nome de uma lista de endereços para ver seus detalhes.
Usando o AWS CLI:
aws mailmanager list-members-of-address-list --address-list-idal-123456789abc
Excluir uma lista de endereços
Para excluir uma lista de endereços:
-
Na página Listas de endereços, selecione o botão de opção ao lado da lista de endereços que deseja excluir e escolha Excluir.
-
Confirme a exclusão da lista digitando confirm e selecionando Excluir.
Usando o AWS CLI:
aws mailmanager delete-address-list --address-list-idal-123456789abc
Usar listas de endereços em políticas de tráfego e conjuntos de regras
As listas de endereços podem ser usadas em declarações de política de tráfego e condições de regras para processar e-mails com base na associação à lista, proporcionando controle sobre o fluxo de e-mails. As seções a seguir fornecem um exemplo do uso de listas de endereços tanto em uma política de tráfego quanto em um conjunto de regras.
Usar uma lista de endereços em uma declaração de política de tráfego
As listas de endereços podem ser selecionadas ao criar a condição de uma declaração de política de tráfego para permitir ou negar a entrada de e-mails no endpoint de entrada.
O procedimento de console a seguir e seus AWS CLI equivalentes mostram um exemplo de criação de uma declaração de política que permite que mensagens entrem em seu endpoint de entrada se o destinatário estiver na Lista de Endereços especificada.
Para usar uma lista de endereços em uma declaração de política de tráfego:
-
Crie uma política de tráfego ou edite uma existente, conforme explicado em Criar políticas de tráfego e declarações de política (console).
-
No contêiner Instrução de política, escolha Permitir para que a ação seja tomada quando as condições da declaração forem atendidas.
-
Crie a condição da declaração da seguinte forma:
-
Selecione o Endereço do destinatário no campo Protocolo.
-
Selecione Está na lista de endereços no campo Operador.
-
Selecione o nome da sua lista de endereços no campo Valor.
-
-
Embora esse seja apenas um exemplo, você pode adicionar mais condições de política que podem ser baseadas em uma variedade de operadores com qualquer uma de suas listas de endereços.
Usando o AWS CLI:
aws mailmanager create-traffic-policy \ --default-action ALLOW \ --traffic-policy-name "testpolicy" \ --policy-statements '[{ "Action": "ALLOW", "Conditions": [{ "BooleanExpression": { "Evaluate": { "IsInAddressList": { "Attribute": "RECIPIENT", "AddressLists": [ "arn:aws:ses:eu-west-3:123456789012:mailmanager-address-list/al-123456789abc" ] } }, "Operator": "IS_TRUE" } }] }]'
Usar uma lista de endereços em uma regra
As listas de endereços podem ser selecionadas ao criar a condição de uma regra usada em um dos seus conjuntos de regras para acionar a ação da regra.
O procedimento de console a seguir e seus AWS CLI equivalentes mostram um exemplo de criação de uma regra que invoca a ação de descarte se o destinatário estiver na Lista de Endereços especificada.
Para usar uma lista de endereços em uma condição de regra:
-
Crie uma regra ou edite uma existente, conforme explicado em Criar conjuntos de regras e regras (console).
-
No contêiner Condições da regra, crie a condição da regra conforme mostrado a seguir.
-
Selecione o Endereço do destinatário no campo Selecionar propriedade.
-
Selecione Está na lista de endereços no campo Selecionar operador.
-
Selecione o nome da sua lista de endereços no campo Valor.
-
-
No contêiner Ações, escolha Adicionar nova ação e selecione Descartar ação.
-
Embora esse seja apenas um exemplo, você pode adicionar mais condições de regra que podem ser baseadas em uma variedade de operadores com qualquer uma de suas listas de endereços para uma variedade de ações a serem realizadas.
Usando o AWS CLI:
aws mailmanager create-rule-set \ --rule-set-name "testruleset2" \ --rules '[{ "Name": "addresslist", "Conditions": [{ "BooleanExpression": { "Evaluate": { "IsInAddressList": { "Attribute": "RECIPIENT", "AddressLists": [ "arn:aws:ses:us-east-1:123456789012:mailmanager-address-list/al-123456789abc" ] } }, "Operator": "IS_TRUE" } }], "Actions": [{ "Drop": {} }] }]'
Melhores práticas e considerações
-
Atente-se ao tamanho das listas, pois listas muito grandes podem afetar o desempenho.
-
As listas de endereços são específicas para cada conta e só podem ser usadas na mesma conta da AWS .
-
Ainda não há suporte para listas de endereços aninhadas.
-
Cada região pode ter até 100 listas de endereços.
-
Cada lista de endereços pode ter até 100.000 endereços.