Configurar registros DNS para enviar e-mails no Odoo¶
Esta documentação apresenta três protocolos de autenticação complementares (SPF, DKIM e DMARC) usados para comprovar a legitimidade de um remetente de e-mail. A não conformidade com esses protocolos reduzirá muito as chances de seus e-mails chegarem ao destino.
As bases de dados Odoo Online e Odoo.sh que usam o endereço de subdomínio padrão do Odoo (ex.: @company-name.odoo.com) são pré-configurados para enviar e-mails autenticados em conformidade com os protocolos SPF, DKIM e DMARC.
Se, em vez disso, optar por usar um domínio personalizado, configurar corretamente os registros SPF e DKIM é essencial para evitar que os e-mails sejam colocados em quarentena como spam ou não sejam entregues aos destinatários.
Se estiver usando o servidor de e-mail padrão do Odoo para enviar e-mails de um domínio personalizado, os registros SPF e DKIM devem ser configurados conforme apresentado abaixo. Se estiver usando um servidor de envio de e-mail, é necessário usar os registros SPF e DKIM específicos desse serviço de e-mail e um domínio personalizado.
Nota
Os provedores de serviços de e-mail aplicam regras diferentes aos e-mails recebidos. Um e-mail pode ser classificado como spam mesmo que seja aprovado nas verificações SPF e DKIM.
SPF (Sender Policy Framework)¶
O protocolo SPF (Sender Policy Framework) permite que o proprietário de um nome de domínio especifique quais servidores têm permissão para enviar e-mails a partir desse domínio. Quando um servidor recebe um e-mail, ele verifica se o endereço IP do servidor de envio está na lista de IPs permitidos de acordo com o registro SPF do remetente.
No Odoo, o teste SPF é realizado no endereço de devolução definido no campo Domínio do alias encontrado em Configurações gerais da base de dados. Se estiver usando um domínio personalizado como Domínio do alias, é necessário configurá-lo para ser compatível com SPF.
A política SPF de um domínio é definida por um registro TXT. A maneira de criar ou modificar esse registro depende do provedor que hospeda a zona :abbr:`DNS (Domain Name System) ` do nome de domínio.
Se o nome de domínio ainda não tiver um registro SPF, crie um usando a seguinte entrada:
v=spf1 include:_spf.odoo.com ~all
Se o nome de domínio já tiver um registro SPF, o registro deverá ser atualizado. Não crie um novo, pois um domínio deve ter apenas um registro SPF.
Example
Se o registro TXT for v=spf1 include:_spf.google.com ~all, edite-o para adicionar include:_spf.odoo.com: v=spf1 include:_spf.odoo.com include:_spf.google.com ~all
Verifique o registro SPF usando uma ferramenta como MXToolbox SPF Record Check. O processo para criar ou modificar um registro SPF depende do provedor que hospeda a zona de DNS do nome de domínio. Os provedores mais comuns e suas documentações estão listados abaixo.
DKIM (DomainKeys Identified Mail)¶
O DomainKeys Identified Mail (DKIM) permite que um usuário autentique e-mails com uma assinatura digital.
When sending an email, the Odoo email server includes a unique DKIM signature in the headers. The recipient’s server decrypts this signature using the DKIM record in the database’s domain name. If the signature and the key contained in the record match, it proves the message is authentic and has not been altered during transport.
A habilitação do DKIM é obrigatória ao enviar e-mails de um domínio personalizado com o servidor de e-mail do Odoo.
Add a CNAME record for domain¶
To enable DKIM, add a canonical name (CNAME) record to the domain name system (DNS) zone of the domain name:
odoo._domainkey IN CNAME odoo._domainkey.odoo.com.
If the domain name is company-name.com, make sure to create a CNAME record where the CNAME record
(key/name) is odoo._domainkey.company-name.com, and the canonical name (value/content) is
odoo._domainkey.odoo.com.. For example, note the differences between each key/value in italics:
Key |
odoo._domainkey |
||
|---|---|---|---|
Value |
odoo._domainkey.odoo.com. |
||
OR |
odoo._domainkey.dbname.odoo.com. |
… where dbname is the name of the Odoo database. |
On most DNS platforms, the DNS provider adds the custom domain (e.g., company-name.com) by default. In this case, the key looks different while the value remains the same:
Key |
odoo._domainkey.company-name.com |
… where company-name.com is the custom domain. |
|
|---|---|---|---|
Value |
odoo._domainkey.odoo.com. |
||
OR |
odoo._domainkey.dbname.odoo.com. |
… where dbname is the name of the Odoo database. |
Nota
If the DNS provider does not add the custom domain by default, make sure to include it.
Add a CNAME record for subdomain¶
If there’s a subdomain (e.g., marketing in marketing.company-name.com), add a CNAME record to include it for compliance as well:
Key |
odoo._domainkey.marketing |
… where marketing is the subdomain. |
|
|---|---|---|---|
OR |
odoo._domainkey.marketing.company-name.com |
… where company-name.com is the custom domain. |
|
Value |
odoo._domainkey.odoo.com. |
||
OR |
odoo._domainkey.dbname.odoo.com. |
… where dbname is the name of the Odoo database. |
See DNS provider documentation¶
A maneira de criar ou modificar um registro CNAME depende do provedor que hospeda a zona de DNS do nome de domínio. Os provedores mais comuns e suas documentações estão listados abaixo.
Check if the DKIM record is valid using a tool like MXToolbox DKIM Record Lookup. Enter example.com:odoo in the DKIM lookup tool, specifying
that the selector being tested is odoo for the custom domain example.com.
DMARC (Domain-based Message Authentication, Reporting and Conformance)¶
O registro DMARC é um protocolo que unifica o SPF e o DKIM. As instruções contidas no registro DMARC de um nome de domínio informam ao servidor de destino o que fazer com um e-mail recebido que não passa na verificação SPF e/ou DKIM.
Nota
O objetivo desta documentação é ajudar a compreender o impacto que o DMARC tem sobre a capacidade de entrega de e-mails, em vez de fornecer instruções precisas para a criação de um registro DMARC. Consulte um recurso como DMARC.org para definir o registro DMARC.
Há três políticas DMARC:
p=nonep=quarantinep=reject
p=quarantine e p=reject instruem o servidor que recebe um e-mail a colocá-lo em quarentena ou ignorá-lo se a verificação SPF ou DKIM falhar.
Nota
Para que o DMARC seja aprovado, a verificação DKIM ou SPF precisa ser aprovada e os domínios devem estar alinhados. Se o tipo de hospedagem for Odoo Online, a configuração DKIM no domínio de envio é necessária para ser aprovado pelo DMARC.
A aprovação no DMARC geralmente significa que o e-mail será entregue com sucesso. No entanto, é importante observar que outros fatores, como filtros de spam, ainda podem rejeitar ou colocar uma mensagem em quarentena.
p=none é usado para que o proprietário do domínio receba relatórios sobre entidades que usam seu domínio. Isso não deve afetar a capacidade de entrega.
Example
_dmarc IN TXT “v=DMARC1; p=none; rua=mailto:postmaster@example.com” significa que os relatórios DMARC agregados serão enviados para postmaster@example.com.
Documentação SPF, DKIM e DMARC de provedores comuns¶
Registro TXT da GoDaddy <https://www.godaddy.com/help/add-a-txt-record-19232>`_
Para testar totalmente a configuração, use a ferramenta Teste de e-mails, que oferece uma visão geral completa do conteúdo e da configuração em um único e-mail enviado. O Teste de e-mails também pode ser usado para configurar registros de outros provedores menos conhecidos.