Salesforce
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.
Antes de começar
Para configurar DKIM no Salesforce, use a página DKIM Keys do Setup: crie uma chave, adicione no DNS os dois registros CNAME que o Salesforce gera e clique em Activate. O DKIM (DomainKeys Identified Mail) assina cada mensagem para que o servidor de destino confirme que ela veio do seu domínio e não foi alterada.
- Acesso. Você precisa da permissão Customize Application e de acesso para editar a zona DNS do domínio. O Salesforce diz que não dá suporte direto à parte de DNS.
- Domínios. Crie uma chave por domínio e subdomínio de envio. O domínio da chave precisa coincidir com o domínio inteiro do From.
- Como o e-mail sai. A chave assina o e-mail enviado pelo Salesforce. O Salesforce informa que Send through Gmail e Send through Office 365 não precisam de DKIM à parte. Marketing Cloud e Account Engagement (Pardot) têm documentação própria.
O envio pelo Salesforce agora falha quando o domínio de envio não está verificado, e uma chave DKIM ativa faz essa verificação.
Passo a passo
Criar as DKIM keys no Salesforce
- No Setup, use o Quick Find para selecionar DKIM Keys e clique em Create New Key.
- Em RSA key size, escolha 2048-bit, como recomenda a RFC 8301.
- Em Selector, informe um seletor DKIM de até 62 letras, dígitos e hífens, começando com letra ou número. Em Alternate Selector, informe outro.
- Em Domain, digite o domínio do From, como
exemplo.com.br, e evite o nome My Domain da organização. Depois de salvar, não dá para alterar. - Em Domain Match Pattern, repita o mesmo domínio. O Salesforce desaconselha curingas em domínios que são seus.
- Clique em Save. O Salesforce hospeda as chaves públicas e gera os seus registros CNAME, normalmente em até 15 minutos.
Publicar os registros CNAME
-
Em DKIM Keys, clique no seletor da chave. Se TXT Record Status mostrar
Publishing in progress, aguarde alguns minutos. -
Confira o formato que seu provedor de DNS espera. Se ele completar o domínio sozinho, digite só
myselector._domainkey. Confira também se cada nome está livre: um CNAME não pode dividir o nome com outro registro. Se o nome já estiver em uso, não mexa nele e crie uma chave com outro seletor. -
Adicione CNAME Record e Alternate CNAME Record no seu provedor de DNS, com os valores daquela página:
Host Tipo Valor myselector._domainkey.exemplo.com.brCNAMEmyselector.XXXXXX.custdkim.salesforce.commyalternate._domainkey.exemplo.com.brCNAMEmyalternate.XXXXXX.custdkim.salesforce.comXXXXXXé um código gerado pelo Salesforce.
No Cloudflare, confira se nenhum dos registros está como Proxied.
Ativar a chave
- Aguarde o DNS atualizar, o que pode levar até 72 horas.
- Recarregue DKIM Key Details, que não se atualiza sozinha. Um círculo verde com uma marca branca e uma mensagem de confirmação indicam que a chave está pronta.
- Em DKIM Keys, clique em Edit na chave e depois em Activate e OK. O Salesforce passa a assinar o e-mail do domínio.
O Salesforce faz a rotação da chave a cada 30 dias, sem ação da sua parte. Mantenha os dois registros CNAME no lugar, porque, se o servidor de destino não encontrar a chave, a assinatura falha.
Confirme que funcionou
- Informe o domínio e o seletor no verificador de DKIM ou rode
nslookup -type=TXT myselector._domainkey.exemplo.com.br 1.1.1.1. Uma resposta correta mostra o seu CNAME e depois um registro TXT com a chave pública. A consulta pode trazer só a chave ativa na rotação, então confira também o outro seletor. - Envie uma mensagem da produção para uma caixa em outro provedor.
- Cole os cabeçalhos no analisador de cabeçalhos. O esperado é
dkim=passcomheader.d=no domínio do From.
Problemas comuns
O botão Activate fica desabilitado. O Salesforce só libera o botão depois que os dois registros CNAME resolvem corretamente. Procure por um CNAME com proxy, outro registro no mesmo nome, uma chave criada para outro domínio ou um seletor repetido.
O DKIM passa e o DMARC falha. O Salesforce diz que o alinhamento falha quando o Domain da chave não coincide com o domínio do From, e a RFC 9989 só considera um domínio de assinatura alinhado. Crie uma chave nova para o domínio certo. Veja também SPF no Salesforce.
Not allowed to send from an unauthorized domain. O Email Composer mostra isso quando o domínio não está verificado. Em automações, procure nos logs de e-mail por 550 5.7.1 Delivery not authorized, message discarded. Ative uma chave para esse domínio ou configure um authorized email domain.
Um relay quebra a assinatura. O Salesforce diz que um relay pode alterar cabeçalhos assinados e sugere desativar a chave e usar o DKIM do relay. Cuidado: confirme antes que o relay assina o seu domínio. A regra de verificação vale para email relay, então configure um authorized email domain antes de desativar, ou a entrega pode falhar.