Skip to content

Commit 2340807

Browse files
committed
Email Workers auth requirement
Update docs mentioning that mail authentication will be required in the near future to be able to forward email from CF.
1 parent 010ebfe commit 2340807

File tree

2 files changed

+27
-1
lines changed

2 files changed

+27
-1
lines changed
Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
---
2+
title: Mail authentication requirements for Email Routing
3+
description: Emails will need to be authenticated either via SPF or DKIM in order to be forwarded.
4+
date: 2025-06-30T10:00:00Z
5+
---
6+
7+
The Email Routing platform supports [SPF](https://datatracker.ietf.org/doc/html/rfc7208) records and [DKIM (DomainKeys Identified Mail)](https://en.wikipedia.org/wiki/DomainKeys_Identified_Mail) signatures and
8+
honors these protocols when the sending domain has them configured. However, if the sending domain doesn't implement them,
9+
we still forward the emails to upstream mailbox providers.
10+
11+
Starting on July 3, 2025, we will require all emails to be authenticated using at least one of the protocols, SPF or DKIM, to
12+
forward them. We alsostrongly recommend that all senders implement the DMARC protocol.
13+
14+
If you are using a Worker with an Email trigger to receive email messages and forward them upstream, you will need to handle the case where
15+
the forward action may fail due to missing authentication on the incoming email.
16+
17+
SPAM has been a long-standing issue with email. By enforcing mail authentication, we will increase the efficiency of identifying abusive senders and blocking
18+
bad emails.
19+
If you're an email server delivering emails to large mailbox providers, it's likely you already usethese protocols; otherwise, please ensure
20+
you have them properly configured.

src/content/docs/email-routing/postmaster.mdx

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,11 @@ dig TXT cf2024-1._domainkey.example.com +short
4949
### DMARC enforcing
5050

5151
Email Routing enforces Domain-based Message Authentication, Reporting & Conformance (DMARC). Depending on the sender's DMARC policy, Email Routing will reject emails when there is an authentication failure. Refer to [dmarc.org](https://dmarc.org/) for more information on this protocol.
52+
It is recommended that all senders implement the DMARC protocol in order to successfully deliver email to Cloudflare.
53+
54+
### Mail authentication requirement
55+
56+
Starting on 2025-07-03, Cloudflare will require emails to either pass SPF verification or be correctly DKIM-signed to forward them. Having DMARC configured will also have a positive impact and is recommended.
5257

5358
### IPv6 support
5459

@@ -152,6 +157,7 @@ Email Routing uses an internal Domain Name System Blocklists (DNSBL) service to
152157
```txt
153158
554 <YOUR_IP_ADDRESS> found on one or more RBLs (abusixip). Refer to https://developers.cloudflare.com/email-routing/postmaster/#spam-and-abusive-traffic/
154159
```
160+
155161
We update our RBLs regularly. You can use combined block list lookup services like [MxToolbox](https://mxtoolbox.com/blacklists.aspx) to check if your IP matches other RBLs. IP reputation blocks are usually temporary, but if you feel your IP should be removed immediately, please contact the RBL's maintainer mentioned in the SMTP error directly.
156162

157163
### Anti-spam
@@ -226,4 +232,4 @@ Email Routing does not support sending or replying from your Cloudflare domain.
226232

227233
### Signs such "`+`" and "`.`" are treated as normal characters for custom addresses
228234

229-
Email Routing does not have advanced routing options. Characters such as `+` or `.`, which perform special actions in email providers like Gmail and Outlook, are currently treated as normal characters on custom addresses. More flexible routing options are in our roadmap.
235+
Email Routing does not have advanced routing options. Characters such as `+` or `.`, which perform special actions in email providers like Gmail and Outlook, are currently treated as normal characters on custom addresses. More flexible routing options are in our roadmap.

0 commit comments

Comments
 (0)