HubSpot
Configurar DMARC no HubSpot: registro SPF e DKIM
Como configurar DMARC no HubSpot: copie o registro SPF da sua conta, crie os dois CNAMEs de DKIM e o TXT de DMARC e confirme o status Authenticated.
Verifique a configuração atual:
Para configurar DMARC no HubSpot, você conecta um domínio de envio de e-mail e publica os registros que a própria conta gera: o registro SPF do HubSpot, dois CNAMEs de DKIM e um TXT de DMARC. Este guia mostra cada um na ordem em que você publica.
Como o HubSpot autentica seus e-mails
O HubSpot só marca um domínio como Authenticated depois que três verificações são confirmadas. O SPF (Sender Policy Framework) informa aos servidores de destino quem pode enviar pelo domínio, e aqui essa lista vem do include da sua conta. O DKIM (DomainKeys Identified Mail) assina com uma chave privada; os CNAMEs do HubSpot levam à chave pública de verificação. O DMARC verifica se um desses dois resultados coincide com o domínio do endereço visível no campo From. Essa coincidência se chama alinhamento.
Enquanto você não conecta um domínio, o HubSpot envia os e-mails de marketing e transacionais por um domínio gerenciado por ele. Um endereço como user@exemplo.com.br vira user=exemplo.com.br@hs-domain.com. O DKIM precisa estar configurado antes de o seu domínio aparecer no campo From.
O SPF é verificado no return-path, o endereço oculto que recebe as devoluções. O HubSpot já deixa esse endereço configurado para e-mails de marketing nos servidores compartilhados. Ele documenta o return-path personalizado, disponível no Marketing Hub Enterprise, como o caminho para obter alinhamento de SPF. Contas com IP dedicado usam um subdomínio de return-path do próprio domínio. Em uma configuração padrão com IP compartilhado, conte com o DKIM para o DMARC passar.
Antes de começar
- Você precisa de uma assinatura Starter, Professional ou Enterprise do Marketing Hub, Sales Hub, Service Hub ou Content Hub, além da permissão Domain settings.
- Escolha o domínio de envio. Para um site em
www.exemplo.com.br, o HubSpot recomenda um subdomínio comonews.exemplo.com.bra quem usa IP compartilhado. O domínio raiz também serve se não hospedar conteúdo. - O domínio conectado deve ser o mesmo do endereço no campo From.
- Os domínios de envio valem para e-mails de marketing e transacionais. E-mails individuais usam a caixa de entrada conectada a essas ferramentas.
Passo 1: Conecte o domínio de envio
- Clique no ícone de configurações na barra de navegação superior.
- Na barra lateral esquerda, vá em Content > Domains & URLs.
- Abra a aba Email Sending e clique em Connect sending domain.
- Informe um endereço de e-mail que você usa para e-mails de marketing e clique em Next.
- Confirme o domínio e clique em Next.
- Clique em Sign in with [provider] se o HubSpot oferecer essa opção para o seu provedor de DNS. Caso contrário, clique em No, I'll set it up manually.
- Copie cada valor das colunas Host e Required data para o seu provedor de DNS.
Passo 2: Crie os registros DKIM do HubSpot
O HubSpot usa dois registros CNAME para o DKIM. A primeira parte de cada host é o seletor, o rótulo que o servidor de destino usa para encontrar a chave. O artigo de solução de problemas do HubSpot dá hs1-123456._domainkey como exemplo de host. Ele mostra destinos no formato exemplo-com-br.hs[#]a.dkim.hubspotemail.net e exemplo-com-br.hs[#]b.dkim.hubspotemail.net.
O HubSpot gera esses valores por domínio e não publica uma lista fixa de seletores. Copie os valores da sua conta. Quanto ao alinhamento, a assinatura DKIM fica vinculada ao domínio que você conectou e, por isso, alinha com um endereço desse domínio no campo From.
Se você usa a Cloudflare, desligue o CNAME flattening de todo o domínio e as configurações de proxy, como o HubSpot pede.
Passo 3: Crie o registro SPF do HubSpot
A coluna Required data traz o valor da sua conta. Os exemplos do HubSpot usam o formato include:123456.spf03.hubspotemail.net. O número e a parte spf03 variam, então copie o seu da tela de configuração.
Um domínio só pode publicar um registro SPF. Se já existir um, acrescente o include a ele. Para um domínio que também usa o Google Workspace, o registro combinado fica assim, com o include da sua conta no lugar do exemplo:
v=spf1 include:_spf.google.com include:123456.spf03.hubspotemail.net ~all
- Mantenha
v=spf1e o termo finalalluma única vez cada. - O exemplo
-alldo HubSpot retorna SPF fail para origens não listadas; não decide a entrega.~allretorna softfail, que a RFC 7208 orienta não usar sozinho para rejeitar. Identifique os remetentes legítimos de MAIL FROM antes de mudar o final. - Remova os IPs do HubSpot que você tenha colado antes. O HubSpot informa que o registro dele já cobre os IPs que a sua conta usa.
- Fique de olho no limite. O SPF permite 10 consultas de DNS no total entre
include,a,mx,ptr,existseredirect, contando os registros aninhados. Confira o total no verificador de SPF.
Passo 4: Publique o DMARC
Primeiro confira se o domínio raiz já tem um registro TXT _dmarc. Se tiver, edite esse registro: acrescente o seu endereço de relatórios em rua e mantenha a política atual. Não crie um segundo registro, porque os servidores de destino descartam os dois. Se não houver nenhum, crie um registro TXT com o nome _dmarc no domínio raiz e comece em modo de monitoramento:
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, que recebe os relatórios agregados definidos na RFC 9990. O HubSpot recomenda alinhamento relaxado. adkim e aspf têm r como padrão, então você pode omiti-los.
O suporte do HubSpot não gerencia o seu DNS nem escolhe a sua política de DMARC. Quem administra o DNS publica esse registro.
Um subdomínio como news.exemplo.com.br herda o registro do seu Domínio Organizacional, em geral o domínio que você registrou. Os servidores de destino o encontram pela busca em árvore de DNS da RFC 9989. Use a tag sp se os subdomínios precisarem de outra política.
Passo 5: Confira o status e aplique a política
Aguarde pelo menos 20 minutos depois de atualizar o DNS. Os registros costumam atualizar em 10 a 70 minutos e podem levar até 48 horas. Depois, abra a aba Email Sending e veja o status:
- Not authenticated: nenhum dos três métodos foi verificado.
- Partially authenticated: o DKIM está verificado, e o SPF ou o DMARC ainda não.
- Authenticated: DKIM, SPF e DMARC estão verificados.
Clique em Continue setup para revisar um registro com problema. Envie um teste e leia os cabeçalhos no analisador de cabeçalhos. Confirme o registro DMARC no verificador de DMARC. Preserve política, alinhamento e relatórios existentes. Na primeira implantação, monitore em p=none; após alinhar todos os remetentes legítimos, avalie p=quarantine. p=reject é opcional e exige avaliar listas de discussão e encaminhamento separadamente. O receptor decide a entrega de cada mensagem.
Problemas comuns
- O domínio não conecta porque hospeda um site. O HubSpot retorna erro para um domínio já usado para hospedar conteúdo. Use um subdomínio separado. Um site em
wwwnão impede o uso do domínio raiz. - O domínio aparece duplicado no host do DKIM. Alguns provedores de DNS acrescentam o domínio automaticamente, o que gera
hs1-123456._domainkey.exemplo.com.br.exemplo.com.br. Informe o valor de Host sem o domínio raiz:hs1-123456._domainkeypara um domínio raiz. Se você conectou um subdomínio comonews.exemplo.com.br, mantenha o rótulo dele, como emhs1-123456._domainkey.news. - Aparece um aviso
Typo,Missing recordouConflicting record. Compare os registros no seu DNS com os valores do HubSpot e clique em Refresh ou verifique de novo na configuração do domínio. - Aparece
TIME_1com a Cloudflare. O HubSpot informa que esse erro depois de cinco horas geralmente indica que a Cloudflare está bloqueando as requisições, e não demora de propagação. - A dica de consulta não bate com o seu registro. A checklist do HubSpot manda procurar
include:shared.hubspot.come usar o seletorsmtpapi. A sua tela de configuração pode mostrar outros valores, como o includespf03ehs1-123456. Compare com o que a sua conta mostra em Host e Required data. - Aparece
Invalid DMARC policy. O valor depouspé inválido. Usenone,quarantineourejectem letras minúsculas. - Existem dois registros
_dmarc. Os servidores de destino descartam esses registros, e a sua política deixa de ser aplicada. Mantenha um único registro começando comv=DMARC1. - Os artigos do HubSpot ainda citam
pct. A RFC 9989 removeu essa tag e criou atpara modo de teste. Faça a aplicação gradual passando denoneparaquarantinee depois parareject. - O domínio tem null MX. Alguns provedores rejeitam e-mails de um domínio que publica
MX 0 ., e o HubSpot recomenda remover esse registro. Um domínio usado só para envio pode ficar sem MX. - O endereço do remetente mostra
hs-domain.com. O domínio não está conectado ou o endereço não foi verificado. Você precisa ser dono do domínio e ter acesso a ele para conectar, então um domínio que você não controla não pode ser autenticado.