SendGrid
Registro SPF do SendGrid: como configurar SPF, DKIM e DMARC
Onde fica o registro SPF do SendGrid, os CNAMEs da Domain Authentication, os seletores DKIM s1 e s2 e como publicar o DMARC com segurança.
Verifique a configuração atual:
Como funciona o registro SPF do SendGrid
O registro SPF do SendGrid fica em um subdomínio seu, como em1234.exemplo.com.br. Você o cria com a Domain Authentication, o recurso do SendGrid que também configura o DKIM, uma assinatura que permite ao servidor de destino confirmar que a mensagem não foi alterada no caminho.
O SendGrid define o Return-Path (o endereço oculto que recebe os retornos) nesse subdomínio. Os servidores de destino verificam o SPF com base no Return-Path, portanto leem o registro de em1234.exemplo.com.br. O SPF da raiz do seu domínio continua como está.
A automated security vem ligada por padrão. Você publica registros CNAME, que apontam um nome para outro, e o SendGrid mantém os dados de SPF e DKIM por trás deles. Ele pode atualizar esses dados quando você adiciona um IP dedicado. Com a automated security desligada, você publica os registros MX e TXT por conta própria e precisa alterá-los sempre que sua configuração de envio mudar.
Passo 1: Inicie a autenticação do domínio
- No console do Twilio SendGrid, vá em Settings > Sender Authentication.
- Na seção Domain Authentication, clique em Get Started.
- Escolha o seu provedor de DNS em Which Domain Name Server (DNS) host do you use? e diga se quer personalizar também os links. Clique em Next.
- Em Domain You Send From, digite o domínio que aparece no endereço From. A Twilio pede o domínio raiz, sem
wwwnemhttp://. - Abra Advanced Settings. Mantenha Use automated security marcado, a não ser que o seu DNS não aceite sublinhado em registros CNAME. Clique em Next.
Se o DNS estiver na GoDaddy, a automated security estiver ligada e você não tiver escolhido link branding, o SendGrid pode oferecer a configuração automática pelo Domain Connect. Você entra na conta da GoDaddy, aprova a alteração e o SendGrid configura o DNS. A configuração automática e a automated security são opções separadas. Nos demais casos, use a aba Manual Setup e copie os registros à mão.
Passo 2: Publique os registros DNS
A página Install DNS Records lista quatro registros. Três são CNAMEs parecidos com estes:
em1234→u1234567.wl123.sendgrid.net(Return-Path e SPF)s1._domainkey→s1.domainkey.u1234567.wl123.sendgrid.net(DKIM)s2._domainkey→s2.domainkey.u1234567.wl123.sendgrid.net(DKIM)
Esses valores são exemplos. Copie para o painel de DNS os que o SendGrid mostrar para a sua conta e clique em Verify. O quarto registro é o de DMARC, explicado no passo 3. Se você escolheu link branding, a página também lista dois CNAMEs para os links. O SendGrid gera o rótulo em1234. A opção Use a custom return path, em Advanced Settings, permite escolher outro. Um rótulo igual ao de um CNAME existente sobrescreve esse registro, então confira o seu DNS antes.
Seletores DKIM do SendGrid
s1 e s2 são os seletores DKIM padrão, os nomes que indicam ao servidor de destino qual chave buscar. O SendGrid ativa um seletor por vez e faz o rodízio entre eles quando necessário, por isso mantenha os dois publicados. Esses registros ficam no seu domínio. Depois que ele é verificado, a mensagem cujo domínio do From coincide é assinada com o seu domínio em d=, o que permite ao DKIM se alinhar com o seu endereço From. Até lá, o SendGrid usa sendgrid.net, que não se alinha com o seu domínio.
Com a automated security desligada
No lugar dos CNAMEs, o SendGrid entrega três registros:
- MX em
em1234.exemplo.com.br→mx.sendgrid.net - TXT em
em1234.exemplo.com.br→v=spf1 include:sendgrid.net ~all - TXT em
m1._domainkey.exemplo.com.br→ a chave DKIM, começando comk=rsa; t=s; p=
include:sendgrid.net é o include de SPF documentado pelo SendGrid, e ele fica no subdomínio em. A página de SPF da Twilio mostra um exemplo terminado em -all, e a página de configuração usa ~all. Copie o valor que aparece no seu console. A partir daí, manter esses registros atualizados passa a ser tarefa sua.
Passo 3: Publique o registro DMARC do SendGrid
O quarto registro do SendGrid é um TXT em _dmarc com o valor v=DMARC1; p=none;. Esse valor não pede relatórios. Acrescente seu endereço de coleta à política existente ou use o exemplo de monitoramento abaixo apenas na primeira política.
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 o endereço pelo seu endereço de relatórios do DMARC Pulse. A tag rua pede aos provedores de e-mail os relatórios agregados, definidos na RFC 9990, que mostram quais servidores enviam mensagens em nome do seu domínio. Já p=none pede que eles não apliquem nenhuma ação de DMARC enquanto você coleta esses relatórios.
Mantenha um único registro DMARC. Se o seu domínio já tiver um, edite esse registro. A seção 4.10 da RFC 9989 manda os servidores descartarem todos os registros quando encontram mais de um no mesmo nome.
O DMARC precisa que o SPF ou o DKIM passe em um domínio alinhado com o seu endereço From. A RFC 9989 define o alinhamento relaxado como padrão nos dois casos, portanto um subdomínio vale quando pertence ao mesmo domínio organizacional. O SendGrid atende a essa regra duas vezes: o SPF se alinha por em1234.exemplo.com.br e o DKIM se alinha por d=exemplo.com.br.
Preserve o aspf existente. Um Return-Path em subdomínio pode falhar no SPF estrito, mas DKIM aprovado no domínio exato basta para DMARC. Relaxar o alinhamento é uma decisão deliberada para todo o domínio.
Passo 4: Confira e depois aplique
Envie uma mensagem de teste para uma caixa que você controla e cole os cabeçalhos no Analisador de Cabeçalhos. O esperado é spf=pass para o subdomínio em, dkim=pass para o seu domínio e dmarc=pass. O cabeçalho DKIM-Signature mostra o seu domínio em d= e o seletor ativo em s=. Você também pode rodar o verificador de SPF no subdomínio em e o verificador de DKIM com o seletor s1 ou s2, ou m1 se a automated security estiver desligada.
Mantenha a política, o alinhamento e os destinatários dos relatórios ao autenticar o SendGrid. Uma primeira política pode começar em p=none. Use os relatórios para inventariar todos os remetentes legítimos do domínio, inclusive envios raros e sazonais, antes de considerar quarentena. Rejeitar exige uma decisão manual separada que considere listas e encaminhamentos; é opcional, e os receptores decidem a entrega.
Problemas comuns
- Os registros continuam sem verificação depois de publicados. A validação pode levar até 48 horas. Se só uma parte for verificada, espere e depois procure um valor digitado errado.
- O seu provedor de DNS acrescenta o domínio. GoDaddy, Amazon Route 53 e Namecheap podem somar o seu domínio ao nome digitado, o que gera
em1234.exemplo.com.br.exemplo.com.br. Digite só o host,em1234. DNS Validation Error (Code: 1004)em domínio na Cloudflare. Registros CNAME novos podem vir como Proxied, e CNAMEs com proxy não ficam visíveis publicamente. Mude cada registro do SendGrid para DNS only.- Outro registro no nome do CNAME. Identifique primeiro o serviço que o usa. Não apague MX/TXT/CNAME ativos sem conferir. Escolha um nome livre aceito pela conta ou coordene a migração com quem assina antes de substituir o DNS.
- O seu DNS não aceita sublinhado. Os registros do SendGrid precisam dele. Desligar a automated security só ajuda se o provedor aceitar sublinhado em nomes de registros TXT, porque o registro DKIM em
m1._domainkeytambém tem um. Caso contrário, o SendGrid sugere considerar outro provedor de DNS. - Aparece
Expected TXT record atcom a automated security desligada. A sua chave DKIM foi dividida em várias partes entre aspas. Junte tudo em uma única sequência. - A verificação deu certo, mas o DMARC aparece com falha. O SendGrid não exige que o DMARC passe para concluir a Domain Authentication. A página Install DNS Records indica a falha e você continua podendo enviar, então corrija o registro
_dmarcno seu provedor de DNS. - O e-mail ainda mostra
via sendgrid.net(ouvia eu.sendgrid.netem contas regionais), ou o DMARC falha em algumas mensagens. O SendGrid aplica um domínio autenticado quando ele coincide com o endereço From. Sem correspondência, usa o seu domínio autenticado padrão e, na falta dele,sendgrid.net. Um subusuário procura primeiro o próprio domínio correspondente, depois o próprio padrão e, por fim, um domínio atribuído pela conta principal. Subdomínios não herdam a autenticação do domínio pai, então autentique cada domínio de onde você envia. - Você envia de um endereço como
@yahoo.com. Os registros do Yahoo não autorizam o SendGrid, então SPF e DKIM falham e o servidor de destino aplica a política de DMARC do Yahoo. Pode aparecer521 5.2.1 : (DMARC) This message failed DMARC Evaluation and is being refused due to provided DMARC Policy, e o SendGrid registra o caso como Block. Envie de um domínio autenticado por você. - Falha no SPF estrito. Preserve a política e confirme DKIM aprovado com
d=igual ao From. Se também precisa alinhar SPF, avalie um Return-Path personalizado que corresponda ao domínio do From. Preserve Sender é último recurso via suporte: você passa a cuidar de devoluções, denúncias e supressões. Relaxaraspfé opcional e afeta todos os remetentes. - Você verificou só um remetente. A Single Sender Verification confirma que um endereço é seu. A Twilio diz que ela serve apenas para testes e pede que você conclua a Domain Authentication antes de enviar em produção.
- A sua chave DKIM ainda tem 1024 bits. A Twilio informa que as configurações existentes não mudam sozinhas e que quem criou a primeira Domain Authentication depois de maio de 2021 já tem chave de 2048 bits. Para migrar, autentique o domínio outra vez com um seletor DKIM personalizado, confirme que a nova configuração funciona e apague a antiga.
- O mesmo domínio está em duas contas ou subusuários. Em Advanced Settings, marque Use a custom DKIM selector na segunda e digite três letras ou números, como
orgou001. Assim os CNAMEs de DKIM deixam de entrar em conflito com o primeiro conjunto.