Visual RFC.
ALL RFCs / RFC 8058
Read the RFC ↗
RFC 8058 / ONE-CLICK EMAIL UNSUBSCRIBE

Check DKIM coverage before offering one-click

03

DomainKeys Identified Mail (DKIM) authenticates signed message content. At least one valid signature must cover both unsubscribe fields and list them in its h= tag.

RFC 8058 · § 4EXAMPLE
3 / 3
Check DKIM coverage before offering one-clickIndependent DKIM comparisons distinguish the h field-name list from an actual successful verifier result. The first lists both required fields but leaves verification pending. The second assumes a valid signature covering both and allows the receiver to offer one-click, still requiring consent for POST. A third has only a valid Subject-only signature: it lacks required coverage, so the receiver follows SHOULD NOT and withholds the offer. This is a policy illustration, not real signature verification or From-domain alignment.Check a valid signature and both covered fieldsReceiver verifierOne-click UIoffer without required coverageOnly valid signature: h=subjectNeither unsubscribe field coveredSHOULD NOT offer one-clickRecommendation shown followed, not a MUST
03
An unrelated signature is insufficient.

In this separate example, the only valid signature covers Subject but not either unsubscribe field. The required signature is absent, so the shown receiver follows SHOULD NOT and withholds the offer.

Source for this drawing: RFC 8058 · Read RFC section 4 ↗

Protocol participantThreat or exceptionProtocol controlSimplified drawings · precise section references
New to this? Start hereA quick picture + helpful background

A message needs an address.

Think of a packet as a small addressed envelope. Devices pass it onward; transport protocols decide what delivery promises an application gets.

Helpful first, if these ideas are unfamiliar

These pictures are analogies to help you learn. The linked RFC explains the actual rules.

Related RFCs and changes

“Updates” changes part of an earlier RFC. “Obsoletes” replaces it. This list shows selected related documents.

KEY POINT

A signature label is not a successful authentication check.

  • Senders MUST apply at least one valid DKIM signature. Both List-Unsubscribe and List-Unsubscribe-Post MUST be covered and included in the h= tag of a valid DKIM-Signature field.
  • If the required signature is absent, the receiver SHOULD NOT offer a one-click unsubscribe for that message. This recommendation is distinct from the consent MUST NOT rule.
  • A valid signature covering other fields alone does not satisfy this requirement. Valid DKIM also does not prove user consent, benign content or the identity of whoever later possesses the unsubscribe URI.
DETAILS

These are independent authentication comparisons. The diagram abbreviates a DKIM signature to its relevant h= names and a stated verifier result; it is not a complete signature or a cryptographic verification implementation. One eligible signature suffices; the RFC does not require every signature to qualify or require From-domain alignment here.

Read the RFC section ↗

All chapters in RFC 8058

Drawing view

Scroll the drawing to see every part. Playback controls stay above it.

RFC 9700 / CHAPTERS

Chapters

For full details, tables, algorithms, and exceptions, read the original RFC.

RFC status and corrections ↗