在使用SendGrid的Adobe Commerce基础架构上,对中传出电子邮件的DMARC故障进行故障诊断

如果商店中传出的电子邮件(订单确认、密码重置和通过Adobe的内置SendGrid集成发送的类似事务性电子邮件)未通过DMARC检查、被标记为垃圾邮件或被收件人邮件服务器拒绝,则可能有两个明显的原因。 在进行任何DNS更改之前,请检查哪一项适用于您。

描述 description

环境

  • 云基础架构上的Adobe Commerce,任何版本,通过Adobe的内置SendGrid集成发送传出电子邮件 — 为云项目自动配置的SendGrid子帐户,其中通过支持案例请求DKIM/SPF域身份验证。 如果您通过自己的单独SendGrid帐户或未通过Adobe配置的任何其他SMTP/邮件提供商发送邮件,则本文不适用 — 请直接向该提供商设置DKIM/SPF/DMARC。
  • DKIM/SPF域身份验证(因此还有此DMARC疑难解答路径)仅在Pro项目的生产和暂存环境中可用。 它在入门级环境中不受支持 — 入门级的可交付性本身更受限制,并且无法通过此路径进行基于DNS的修复。

问题/症状

开始之前:确认这实际上是一个身份验证问题。

并非所有与DMARC监控一起报告的投放失败都是由DMARC/DKIM/SPF引起的 — 收件人端跳出(完整邮箱、灰名单、IP限制)在报告中看起来类似,但与域身份验证无关。 在假设本指南适用之前,请查看SendGrid活动信息源中的特定退回/阻止原因。

  • 传出电子邮件退回或因与DMARC相关的错误而被拒绝
  • 电子邮件以垃圾邮件形式登陆,尤其是在Microsoft/Outlook和Google托管的收件人域中

如何确认每个症状

退回或拒绝并出现与DMARC相关的错误:在邮件客户端中打开退回或拒绝邮件的原始源,并检查Authentication-Results标头。

示例:

Authentication-Results: mx.google.com;
       dkim=fail;
       spf=fail (google.com: domain of bounce@mail.adobe.com does not designate XXX.XXX.XXX.XXX as permitted sender);
       dmarc=fail (p=REJECT sp=REJECT dis=REJECT) header.from=adobe.com

要查找的内容:此标头中的dmarc=fail结果确认拒绝与DMARC相关,而不是不相关的退回(完整邮箱、列入灰名单、IP限制)。

解决方法 resolution

请按照以下步骤解决问题:

步骤1:检查域是否已发布DMARC记录

运行此项以查看策略是否已存在:

dig TXT _dmarc.yourdomain.com +short

要查找的内容:如果存在策略,这将返回以v=DMARC1;开头的带引号的TXT值(例如: "v=DMARC1; p=reject; rua=mailto:dmarc-reports@yourdomain.com")。 如果命令未返回任何内容,则不会发布该域的DMARC记录。 验证示例:查询_dmarc.adobe.com当前未返回任何内容,这意味着adobe.com未发布DMARC记录。

场景A:DMARC记录已存在(最常见)

如果返回记录,则您的域已具有DMARC策略 — 通常由组织的IT或安全团队独立设置,与Adobe Commerce无关。 在这种情况下,DMARC故障几乎总是意味着SendGrid的域身份验证(DKIM和SPF)尚未针对发送域进行设置或调整,也不意味着DMARC记录本身有任何问题。

解决方案:按照现有SendGrid电子邮件服务文档进行操作,通过支持案例请求DKIM和SPF域身份验证。 一旦SendGrid的DKIM/SPF记录正确添加到您的DNS并与发送域保持一致,您现有的DMARC策略就会开始传递 — 无需更改DMARC记录本身。

DNS记录值会随着时间的推移而改变:请勿重复使用旧支持案例或内部文档中的CNAME/TXT值。 SendGrid子帐户分配可以重新发出,因此过去正确的记录可能不再与您当前的SendGrid配置匹配。 始终通过新的支持案例请求当前值,而不是重新应用历史值。

如果这是暂存或非生产环境:默认情况下为暂存和生产启用SendGrid,但通常仅为生产环境请求DKIM/SPF域身份验证,并且从未为暂存环境请求跟进。 它可能会持续几个月(依赖宽松或缺席的DMARC政策),然后在您的组织收紧对DMARC的执行后立即失败。 如果您只是在生产环境正常的情况下才在暂存环境中看到失败,请专门为暂存环境请求DKIM/SPF身份验证 — 不要假设生产请求已涵盖该请求。

验证DKIM/SPF记录是否已传播

请求并应用DKIM/SPF域身份验证后,在重新测试DMARC对齐或重新打开用例之前,请确认记录已在DNS中实际传播。 SendGrid的域身份验证为您的发送子域发布三条CNAME记录:一条用于链接品牌(em),两条用于DKIM签名密钥(s1._domainkey、s2._domainkey)。

dig CNAME em.yourdomain.com +short
dig CNAME s1._domainkey.yourdomain.com +short
dig CNAME s2._domainkey.yourdomain.com +short

要查找的内容:每个命令应返回以.sendgrid.net.结尾的CNAME目标。如果命令未返回任何内容,则该记录尚未添加或尚未传播。 已验证的示例:查询s1._domainkey.adobe.com和s2._domainkey.adobe.com返回:

s1.domainkey.uXXXXXXX.wlXXX.sendgrid.net.
s2.domainkey.uXXXXXXX.wlXXX.sendgrid.net.

在此示例中,对em.adobe.com的同一检查返回了空结果,这意味着未配置特定记录。 显式请求它,而不是假定它包含在之前的DKIM/SPF请求中。 如果记录在添加后24-48小时内仍未解决,请跟进现有支持案例,而不是打开新的支持案例。

场景B:不存在DMARC记录

如果以上命令未返回任何内容,则您的域根本没有DMARC策略。 在这种情况下,除了根据场景A设置DKIM/SPF之外,您还应该发布DMARC记录。 以监视模式启动,而不是强制启动:

_dmarc.yourdomain.com   TXT   "v=DMARC1; p=none; rua=mailto:dmarc-reports@yourdomain.com; pct=100"
  • p=none — 仅监视器,不影响邮件投放。 从这里开始。
  • rua=mailto:... — 发送汇总报告的位置;使用您实际监视的邮箱,而不是店面的发送地址。
  • 在查看报告几周并确认合法邮件(包括SendGrid)通过对齐后,移至p=quarantine,最后移至p=reject。

在确认您自己的合法邮件传递之前,请勿直接跳转到p=quarantine或p=reject,因为这样做可能会导致收件人服务器自动拒绝您自己的事务性电子邮件。

相关阅读

  • SendGrid电子邮件服务文档 (DKIM/SPF设置 — 以上两种情况都需要执行第一步)
  • 如果您在获取DMARC记录时需要任何帮助,请联系Platform团队以获取进一步支持。
recommendation-more-help
experience-cloud-kcs-help-kbarticles