Skip to content

Commit 1af2720

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 1af2720

File tree

2 files changed

+24
-0
lines changed

2 files changed

+24
-0
lines changed
Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
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-20T15:00:00Z
5+
---
6+
7+
The Email Workers 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,
8+
honoring these protocols when the sending domain has them configured. So far, when sending domains did not implement these protocols, emails could stil be forwarded
9+
to mailbox providers.
10+
11+
Starting on _2025-07-01_, we will require all email to be authenticated using either one of those protocols in order to forward it. Preferably passing DMARC checks as well, although
12+
that will not be required at this time. If you are using a Worker with an Email trigger and forward the incoming email, you will need to handle the case where
13+
the forward action may fail due to missing authentication on the incoming email.
14+
15+
SPAM has been an long-standing issue with email and by enforcing mail authentication we will be able to immediately filter out some of it, and identify SPAM senders
16+
when some of it gets through. SPF/DKIM/DMARC are not new protocols and there is ample documentation available on how to configure them. In fact, most of the senders
17+
already have these protocols configured. If you use a large mailbox provider, it is likely you are already using these protocols. If you manage your own domain,
18+
please ensure you have these protocols correctly configured.

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

Lines changed: 6 additions & 0 deletions
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, which will be required in the near future in order to successfully deliver email to Cloudflare.
53+
54+
### Mail authentication requirement
55+
56+
Starting on 2025-07-01, Cloudflare will require emails to either pass SPF verification or be correctly DKIM signed in order to forward them. Having DMARC configured will also reflect positively and is recommended, although not yet required at this time.
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

0 commit comments

Comments
 (0)