Salesforce
Como configurar SPF, DKIM e DMARC no Salesforce
Inclua _spf.salesforce.com no SPF, ative uma chave DKIM de 2048 bits com dois CNAMEs e entenda por que o Bounce Management impede o alinhamento do SPF.
Verifique a configuração atual:
Passo a passo, por protocolo
Registro SPF do Salesforce: como adicionar _spf.salesforce.com
O registro SPF do Salesforce é uma entrada, include:_spf.salesforce.com, no seu TXT de SPF. Veja como adicionar e quando o SPF alinha no DMARC.
Configurar DKIM no Salesforce: criar a chave e ativar
Como configurar DKIM no Salesforce: crie a chave no Setup, publique os dois registros CNAME, ative e resolva o botão Activate desabilitado.
Configurar SPF, DKIM e DMARC no Salesforce começa com uma pergunta: por qual caminho o seu e-mail sai? Este guia mostra como os três registros trabalham juntos no Salesforce e onde costumam dar problema. O passo a passo detalhado está no guia de SPF no Salesforce e no guia de DKIM no Salesforce. Os nomes de menus aparecem em inglês, como na documentação da Salesforce.
Quais e-mails precisam destes registros
O Salesforce pode enviar o e-mail de um usuário de três formas.
- Send through Salesforce. Os servidores do próprio Salesforce entregam a mensagem com o seu domínio no endereço From. Os registros deste guia valem para esse caminho.
- Send through Gmail ou Office 365. Cada usuário conecta a própria caixa, e a mensagem sai por essa conta. A Salesforce informa que, nesse caminho, não é preciso adicionar registros SPF ou DKIM no seu DNS.
- Email Relay. O Salesforce encaminha os e-mails pelo serviço de e-mail da sua empresa. A comparação dessas opções feita pela Salesforce não traz nenhum passo de SPF ou DKIM para o relay.
Como SPF, DKIM e DMARC se encaixam
SPF (Sender Policy Framework) lista os servidores autorizados a enviar pelo seu domínio. A Salesforce publica uma única entrada para os e-mails enviados pelo aplicativo, _spf.salesforce.com, e pede que você use só essa. Este é o exemplo oficial:
v=spf1 mx include:_spf.salesforce.com ~all
Acrescente o include ao registro SPF que você já tem, porque um domínio só pode publicar um. Se você também envia pelo Google Workspace ou pelo Microsoft 365, a Salesforce pede que os includes deles venham antes do dela.
DKIM (DomainKeys Identified Mail) adiciona uma assinatura que comprova que o seu domínio autorizou a mensagem. Você cria a chave no Setup, em DKIM Keys. A Salesforce orienta usar RSA de 2048 bits, a menos que algum aplicativo exija uma chave menor. Não existe seletor fixo. O seletor é o rótulo que os servidores de destino usam para encontrar a chave, e você mesmo escolhe um Selector e um Alternate Selector. Os exemplos da Salesforce são example-sf-a e example-sf-b. Depois o Salesforce mostra dois registros CNAME, apelidos de DNS com destinos em custdkim.salesforce.com. Publique os dois, porque o Salesforce faz a rotação da chave a cada 30 dias e usa o nome alternativo nessa troca. Com a chave ativa, a assinatura sai com o seu domínio, e o alinhamento do DKIM fica sob o seu controle.
DMARC (Domain-based Message Authentication, Reporting and Conformance) diz aos servidores de destino o que fazer com mensagens que falham nessas verificações e pede relatórios. A Salesforce apoia e recomenda o DMARC. A decisão e o registro são seus. Publique um registro TXT com o nome _dmarc 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 esse endereço pelo seu endereço de relatórios do DMARC Pulse. A Salesforce também avisa que o Gmail e o Outlook podem tratar uma organização de alto volume como remetente em massa, e remetentes em massa precisam dos três registros.
Por que o DKIM decide o DMARC no Salesforce
O DMARC passa quando o SPF ou o DKIM passa com um domínio alinhado ao endereço From, ou seja, igual ao domínio do From ou com o mesmo domínio principal. A RFC 9989 §5.3.5 exige apenas um resultado alinhado.
O SPF verifica o remetente do envelope, o endereço de retorno usado para mensagens devolvidas. Duas opções da página Deliverability, no Setup, mudam esse endereço:
- Activate bounce management registra as entregas que falharam.
- Enable compliance with standard email security mechanisms é a opção que a Salesforce chama de Email Security Compliance.
Com qualquer uma delas ligada, o Salesforce troca o remetente do envelope por um endereço de retorno em bnc.salesforce.com. A Salesforce chama isso de endereço VERP (Variable Envelope Return Path). O exemplo oficial é sampleemail=salesforce.com__abc123@abc123.bnc.salesforce.com. O SPF então passa para o domínio da Salesforce e não alinha com o seu.
Uma assinatura DKIM alinhada resolve esse problema. A Salesforce afirma que o DMARC não exige o alinhamento do SPF quando o DKIM passa alinhado. Ela recomenda o DKIM para quem quer manter o processamento de bounces.
Se você não puder criar a chave DKIM, a alternativa da Salesforce é um registro SPF com as duas opções desligadas. Outro artigo da Salesforce recomenda desligar as duas depois que SPF e DKIM estiverem no ar. Avalie isso antes, porque o Salesforce deixa de registrar as entregas com falha quando o Bounce Management está desligado.
A ordem que mantém o e-mail funcionando
- Acrescente o include ao seu registro SPF.
- Crie a chave DKIM, publique os dois CNAMEs e aguarde o DNS. A Salesforce diz que as mudanças podem levar até 72 horas.
- Ative a chave em DKIM Keys.
- Se já existe DMARC, preserve política, alinhamento e relatórios; caso contrário, crie uma política de monitoramento em
p=none. Não publique outro registro. Confirme o alinhamento do Salesforce no passo 5 antes de contar com uma política de aplicação. - Envie um teste pelo Salesforce e cole os cabeçalhos no Analisador de Cabeçalhos. Procure
dkim=pass,header.d=com o seu domínio edmarc=pass. - Acompanhe os relatórios agregados, definidos na RFC 9990, até o Salesforce e todas as outras fontes legítimas passarem. A RFC 9989 §5.1.6 manda corrigir o e-mail legítimo antes de aplicar uma política.
- Preserve política, alinhamento e relatórios existentes. Na primeira implantação, monitore em
p=none; após alinhar todos os remetentes legítimos, avaliep=quarantine.p=rejecté opcional e exige avaliar listas de discussão e encaminhamento separadamente. O receptor decide a entrega de cada mensagem.
Problemas comuns
Not allowed to send from an unauthorized domain
A Salesforce agora exige verificação de domínio para e-mails enviados pelo Salesforce com um domínio que não pertence a ela. Endereços terminados em @gmail.com, @hotmail.com ou @outlook.com, e-mails do Marketing Cloud e envios pelas integrações com Gmail ou Office 365 ficam de fora. A exigência começou a ser aplicada depois da versão Spring '26. O usuário vê essa mensagem no editor de e-mail. O log de e-mail mostra 550 5.7.1 Delivery not authorized, message discarded. E-mails de Apex, flows e automações podem falhar sem aviso. Crie e ative uma chave DKIM para aquele domínio exato. Um domínio de e-mail autorizado é a alternativa quando não for possível usar DKIM. A verificação do endereço de cada usuário continua valendo.
O botão Activate continua cinza
O Salesforce só libera o botão depois de encontrar os dois registros CNAME no DNS. Recarregue primeiro a página de detalhes da chave, porque ela não se atualiza sozinha. Depois compare os registros com os valores mostrados ali. A Salesforce lista estes erros frequentes: erro de digitação, só um dos dois CNAMEs publicado, domínio raiz repetido no nome do registro e um ponto a mais no final. Se você usa Cloudflare, deixe os dois registros como DNS only, porque um CNAME com proxy não fica visível de fora. Um CNAME também não pode dividir o nome com outro registro.
O DKIM passa, mas o DMARC falha
Compare o campo Domain da chave com o domínio do endereço From. A Salesforce considera a diferença uma falha de alinhamento e pede uma chave separada para cada domínio e subdomínio. Informe nesse campo o seu domínio de e-mail, e deixe de fora o nome do My Domain. O alinhamento relaxado do DMARC aceita um subdomínio do domínio que assina. A verificação de domínio da Salesforce é mais rígida e só conta uma chave quando o domínio dela coincide com todo o domínio do From.
Uma chave nova não pode ser ativada
Duas chaves do mesmo domínio não podem usar o mesmo seletor. O Salesforce ainda cria a chave quando você repete um seletor, mas não deixa ativá-la. Crie uma chave nova com seletores novos.
O DKIM some depois de atualizar o sandbox
As chaves DKIM não são copiadas para o sandbox. Depois de uma atualização, crie a chave de novo e publique os novos CNAMEs. O domínio de e-mail autorizado é a opção que pode ser importada da produção.
O destinatário vê "Sent on behalf of"
A opção Enable Sender ID compliance causa isso. Ela coloca um endereço no-reply da Salesforce no campo Sender, e alguns programas de e-mail mostram esse campo. Desmarque a opção na página Deliverability. A Salesforce só a recomenda quando um destinatário exige Sender ID. Organizações criadas a partir do Summer '24 não conseguem ligá-la.
O SPF retorna permerror
O SPF permite 10 consultas DNS por verificação, e passar disso retorna permerror. No momento em que este guia foi escrito, _spf.salesforce.com publica um único mecanismo exists, então o include usa 2 das 10. O mx do exemplo oficial usa pelo menos mais uma. Confira o total no Verificador de SPF. Um segundo registro SPF no mesmo domínio também retorna permerror, então edite sempre o que já existe.
E-mails do Marketing Cloud continuam falhando
Este guia trata dos e-mails enviados pelo aplicativo Salesforce. O Marketing Cloud Engagement autentica pelo próprio Private Domain ou Sender Authentication Package. O artigo de SPF da Salesforce aponta conteúdos separados para o Marketing Cloud e para o Account Engagement (Pardot).