Amazon SES
Amazon SES DKIM: como configurar DKIM, registro SPF e DMARC
Configure o Amazon SES DKIM com três CNAMEs do Easy DKIM, adicione o registro SPF a um MAIL FROM personalizado e publique o DMARC.
Verifique a configuração atual:
Como o Amazon SES autentica seus e-mails
Configurar o DKIM no Amazon SES se resume a três registros CNAME no seu domínio. O SES gera os registros, você publica e, a partir daí, o SES assina seus e-mails com o seu próprio domínio. Este guia cobre esses registros, o registro SPF de um domínio MAIL FROM personalizado e o registro DMARC que liga os dois.
O DMARC verifica se o SPF ou o DKIM passou para um domínio igual ao domínio do From que as pessoas veem. Essa correspondência se chama alinhamento, e basta um resultado alinhado.
Antes de qualquer configuração, nenhum dos dois alinha:
- SPF. O SES usa um subdomínio de
amazonses.comcomo MAIL FROM, o remetente oculto do envelope, que recebe as devoluções. O SPF passa para esse domínio, que é da Amazon, por isso não alinha com o seu. - DKIM. O DKIM (DomainKeys Identified Mail) acrescenta uma assinatura digital a cada mensagem. O SES acrescenta automaticamente a própria assinatura, com
d=amazonses.com. O Easy DKIM adiciona outra, com o seu domínio emd=.
Os dados do Amazon SES para ter à mão:
- Include de SPF:
amazonses.com, publicado no subdomínio do MAIL FROM personalizado. O domínio raiz não precisa dele. - Seletores DKIM: o SES gera três para cada identidade, então não existe nome fixo. O seletor é o rótulo antes de
._domainkeyque indica ao servidor de destino qual chave pública buscar. No BYODKIM (chave própria), você escolhe um seletor. - Alinhamento DKIM: a assinatura alinha quando o Easy DKIM ou o BYODKIM está ativo no seu domínio. A assinatura
d=amazonses.comnão alinha com o seu domínio.
Passo 1: Configure o Amazon SES DKIM com uma identidade de domínio
Os nomes de menu estão como aparecem no console em inglês.
- No console do SES, selecione a região da AWS de onde você envia. No painel de navegação, em Configuration, escolha Identities e depois Create identity.
- Em Identity details, escolha Domain e informe o domínio sem
www. - Mantenha as opções padrão de DKIM: Easy DKIM com chave de 2048 bits (
RSA_2048_BITem Advanced DKIM settings) e DKIM signatures ativado. Clique em Create identity. - Na aba Authentication da identidade, expanda Publish DNS records e copie os três registros CNAME. Crie os três no seu provedor de DNS exatamente como aparecem.
Cada nome tem o formato token._domainkey.exemplo.com.br, e cada valor tem o formato token.dkim.amazonses.com. O token é o seletor DKIM. O SES gera três para cada identidade, então copie em vez de digitar. A zona depois do token muda conforme a região e a identidade e pode ser dkim.us-west-2.amazonses.com, por isso use o valor do console.
As alterações de DNS podem levar até 72 horas para se propagar. Quando o SES detecta os três registros, DKIM configuration mostra Successful e Identity status mostra Verified. Mantenha os registros publicados depois disso. Se eles sumirem, o SES desativa a assinatura DKIM e avisa você por e-mail.
As identidades são por região da AWS. Para enviar de uma segunda região, crie e verifique a identidade lá também. Outra opção é o Deterministic Easy DKIM (DEED): uma identidade réplica em outra região reaproveita os registros DNS de uma identidade principal com Easy DKIM. No console, as réplicas aparecem como Global identities.
Passo 2: Adicione o registro SPF do Amazon SES com um MAIL FROM personalizado
O Easy DKIM sozinho já pode passar no DMARC. O MAIL FROM personalizado cria uma segunda rota alinhada, e a AWS diz que usar SPF e DKIM juntos dá ao DMARC a melhor chance de autenticar seus e-mails.
- Abra a identidade de domínio verificada. No painel Custom MAIL FROM domain, clique em Edit.
- Marque Use a custom MAIL FROM domain e informe um subdomínio em MAIL FROM domain, por exemplo
mail.exemplo.com.br. Escolha um subdomínio que não envie nem receba e-mail e que não tenha outro uso. - Em Behavior on MX failure, escolha Use default MAIL FROM domain durante a configuração. Com Reject message, o SES recusa os e-mails dessa identidade enquanto o registro MX estiver errado. Clique em Save changes.
- Publique nesse subdomínio os dois registros da tabela Publish DNS records:
- Um MX com prioridade
10apontando para o endpoint de feedback da sua região, por exemplofeedback-smtp.us-east-1.amazonses.com. Ele recebe as notificações de devolução e de reclamação e precisa ser o único MX desse subdomínio. - Um TXT com o valor de SPF abaixo. A AWS diz que o valor normalmente precisa das aspas que aparecem no console, mas alguns provedores de DNS não as exigem.
- Um MX com prioridade
v=spf1 include:amazonses.com ~all
Esse TXT deve ser o único registro SPF do subdomínio, porque um nome só pode publicar um. O registro SPF do domínio raiz não precisa de include:amazonses.com. O SPF é verificado no domínio do MAIL FROM, que agora é o subdomínio, então deixe o registro da raiz como está.
O SES procura o registro MX por até 72 horas, e o estado passa de Pending para Success. Até lá, vale a opção escolhida em Behavior on MX failure.
Passo 3: Publique o registro DMARC do Amazon SES
O DMARC agora é definido pela RFC 9989, e a RFC 9990 define os relatórios agregados. As duas substituem a RFC 7489. Se o seu domínio já tem um registro _dmarc, edite esse registro em vez de criar um segundo. Mantenha a política atual e acrescente o endereço de relatórios à tag rua, separado por vírgula. Quando há mais de um registro DMARC, os servidores de destino descartam todos.
Crie um registro TXT chamado _dmarc no seu domínio (_dmarc.exemplo.com.br):
Use este valor inicial somente se não existe política DMARC nesse nome. Caso contrário, edite o registro existente preservando p=, alinhamento e destinatários de relatórios; adicione ali seu destino rua monitorado. Não crie outro registro de política.
v=DMARC1; p=none; rua=mailto:dmarc@exemplo.com.br
Troque dmarc@exemplo.com.br pelo seu endereço de relatórios do DMARC Pulse. O p=none é o modo de monitoramento: você recebe os relatórios e ainda não pede nenhuma ação aos servidores de destino.
Alinhamento relaxado aceita subdomínios relacionados; estrito exige domínios idênticos. Preserve adkim e aspf existentes. O MAIL FROM personalizado do SES é um subdomínio: SPF estrito pode falhar enquanto DKIM do domínio exato ainda aprova o DMARC.
Passo 4: Confira o resultado e depois aplique a política
Envie uma mensagem de teste e confira os resultados adicionados pelo seu provedor receptor. Confirme dkim=pass e dmarc=pass; leia d= no DKIM-Signature correspondente para o domínio de assinatura real e s= para o seletor. header.i é o AUID e pode conter endereço ou subdomínio; não define o alinhamento DMARC, especialmente com adkim=s.
2. Informe o token de um dos seus CNAMEs como seletor no verificador de DKIM.
3. Leia os relatórios agregados. Cada linha traz o domínio de header_from e os resultados de DKIM e SPF. A RFC 9990 torna envelope_from opcional, então alguns relatórios podem não trazer esse campo. Nas linhas do SES, dkim ou spf em policy_evaluated deve indicar pass.
Preserve a política e os destinatários de relatórios existentes. Na primeira implantação, monitore em p=none. Após todos os remetentes legítimos passarem com alinhamento, avalie p=quarantine. Considere p=reject separadamente, incluindo os riscos de listas de discussão e encaminhamento; ele é opcional. O receptor decide o tratamento de cada mensagem.
O domínio que publica p=reject precisa aplicar assinaturas DKIM válidas (RFC 9989, seção 7.4), então conclua o Passo 1 antes. Se pessoas do seu domínio participam de listas de discussão, a RFC recomenda não publicar p=reject.
Problemas comuns
O DKIM continua pendente depois de 72 horas
Confira os nomes dos registros no provedor de DNS. Alguns acrescentam o domínio sem avisar e criam token._domainkey.exemplo.com.br.exemplo.com.br. Tire o domínio do nome ou coloque um ponto no final dele. Mantenha o sublinhado de _domainkey e não acrescente outro antes do token. Se o seu provedor de DNS não aceitar sublinhado no nome do registro, fale com o suporte dele, porque o sublinhado é obrigatório.
Os e-mails só têm a assinatura de amazonses.com
Verificar apenas um endereço de e-mail não configura o DKIM do domínio. Verifique a identidade de domínio. Se você também verificou um endereço específico, as configurações dele se sobrepõem às do domínio. Abra essa identidade e confirme que DKIM signatures está ativado, ou exclua a identidade para que o endereço siga o domínio.
amazonses.com aparece nos relatórios DMARC
Há dois motivos. O MAIL FROM padrão usa um subdomínio de amazonses.com, e o SES acrescenta automaticamente a assinatura d=amazonses.com. A AWS diz que essa assinatura é necessária para os ciclos de feedback de reclamações e que você pode ignorá-la. Confira se a linha também tem um resultado alinhado com o seu domínio.
O MAIL FROM personalizado fica em Pending ou passa para Failed
O subdomínio precisa de exatamente um registro MX. Com dois, a configuração falha. O SES tenta detectar o registro por 72 horas e depois marca Failed, e aí é preciso refazer a configuração. Em Pending, TemporaryFailure e Failed, vale a opção de Behavior on MX failure. Com Use default MAIL FROM domain, os e-mails saem por um subdomínio de amazonses.com e o SPF deixa de alinhar. Com Reject message, o SES recusa o envio e retorna o erro MailFromDomainNotVerified.
Envio por outra região ou outra conta da AWS
A configuração de DKIM não passa de uma conta da AWS para outra, nem de uma região para outra, a menos que você use uma réplica DEED. Cada conta da AWS precisa da própria configuração e dos próprios registros. Cada região também, a menos que você use uma réplica DEED. Se você remover os registros, o SES desativa a assinatura naquela região ou conta e avisa por e-mail. Se receber um aviso de revogação, publique os registros de novo dentro do prazo informado. Depois da revogação, é preciso refazer a configuração desde o início.
Alinhamento estrito derruba o DMARC
Com adkim=s, verifique e assine com o domínio exato do From, inclusive o subdomínio de envio. Com aspf=s, conte com DKIM alinhado se MAIL FROM diferir. Relaxar o alinhamento afeta todo o domínio e exige decisão de política; não remova tags estritas automaticamente.
Migração entre Easy DKIM e BYODKIM
A AWS avisa que o SES não assina com o método antigo enquanto o novo está pendente, então os e-mails podem sair sem assinatura DKIM. A AWS sugere usar um subdomínio como etapa intermediária ou fazer a troca durante uma parada.
Resultados diferentes no Microsoft Outlook
A AWS relata que o Microsoft Enterprise Outlook valida só uma das duas assinaturas DKIM, escolhida ao acaso. Um SPF alinhado pelo MAIL FROM personalizado dá a essas mensagens uma segunda rota.
Se o DMARC ainda falhar, veja Amazon SES DMARC fail.