DKIM Author Domain Signing Practices (ADSP)

DKIM Author Domain Signing Practices (ADSP) Trend Micro, NSSG

10101 N. De Anza Blvd Cupertino CA 95014 USA +1.408.257-1500 doug_otis@trendmicro.com

Internet Area DKIM Working Group email, e-mail, rfc2822, rfc 2822, rfc822, rfc 822, rfc2821, rfc 2821, rfc821, rfc 821, rfc4871, rfc 4871, DKIM, domain keys, ADSP, architecture, mta, user, delivery, smtp, submission, Internet, mailfrom, author, return address, key domain, author key domain, author address, author domain Author Domain Signing Practices (ADSP) advertises the adoption level of DomainKeys Identified Mail (DKIM), as described in , for outbound messages publicly exchanged using SMTP, as described in . Application of ADSP by Mail User Agents (MUAs) might need to be offered as an option, to accommodate messages exchanged over different public protocols. This document describes records that authors' domains can publish to advertise their DKIM practices for outgoing messages containing the Author Domain. ADSP will not dictate any specific use of DKIM identity parameters. Such identity restrictions go beyond the charter and unnecessarily limit ADSP applicability. Confirmation of an individual author's identity is orthogonal to and fully independent of ADSP.

DomainKeys Identified Mail (DKIM) defines a mechanism by which email messages can be cryptographically signed, permitting a Key Domain to claim responsibility for the introduction of a message into the mail stream. Receiving hosts can verify the signature by querying the Key Domain to retrieve the appropriate public key, and thereby confirm that the message was attested to by a party in possession of the private key and in control of a portion of the Key Domain. However, the legacy of the Internet is such that not all messages will be signed, and the absence of a signature on a message is not an a priori indication of forgery. In fact, during early phases of deployment it is likely that most messages will remain unsigned. However, some domains might decide to sign all of their outgoing mail, for example, to better protect their brand name. It is desirable such domains be able to advertise that fact to other hosts. This is the premise of Author Domain Signing Practices (ADSP). Hosts implementing this specification can inquire what Author Domain Signing Practices an Author Domain advertises. This inquiry is called an Author Domain Signing Practices discovery. The detailed requirements for Author Domain Signing Practices are given in . This document refers extensively to and assumes the reader is familiar with it. The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in

Some terminology used herein is derived directly from . In several cases, references in that document to Sender have been changed to Author here, to emphasize the relationship to the Author address(es) in the From: header field described in . Briefly, A "Local-part" is the part of an address preceding the @ sign, as defined in and used in .

A Valid Signature is any message signature which correctly verifies using procedures described in section 6.1 of .

The Key Domain is the domain listed in the d= tag of a Valid Signature.

The Author Key Domain is the domain listed in the d= tag of a Valid Signature that is at or above the Author Domain. The Author Key Domain must match all of its domain components with that of the Author Domain. When a referenced Key contains a t=s tag and value, the Author Key Domain will match with the entire Author Domain. ADSP does not require the i= tag to match with any local-parts, and can include subdomains of the Author Domain.

An "Author Address" is an email address in the From header field of a message . If the From header field contains multiple addresses, the message has multiple Author Addresses.

An "Author Domain" is determined by the entire right-hand-side of the Author Address (the portion that is to the right of the "@", excluding the "@" itself).

"Author Domain Signing Practices" (or just "practices") consist of a machine-readable record published at the _adsp. subdomain of the Author Domain. The ADSP record includes statements about the outgoing mail practices for messages containing the Author Domain.

Domain owners can publish Author Domain Signing Practices via a distribution service, such as the Domain Name System; specific details are given in . Hosts can obtain Author Domain Signing Practices of the domain(s) specified by the Author Domain as described in . If a message has multiple Author Addresses, ADSP discoveries SHOULD be performed independently. This standard will not cover the consolidation of combined ADSP results.

A receiving host might obtain varying amounts of useful information through ADSP transactions. If a message has no Valid Signature, ADSP results at the Author Domain are directly relevant to the message. If a message has a Valid Signature from an Author Key Domain, ADSP provides no benefit since the message is compliant with any possible ADSP assertion. If a message has a Valid Signature not at an Author Key Domain, the receiver can use both the Key Domain and ADSP results in its evaluation of the message.

Author Domain Signing Practices discovery at an Author Domain provides four possible results: Messages containing the Author Domain may not have an Author Key Domain signature. All messages containing the Author Domain are initially signed by an Author Key Domain. All messages containing the Author Domain not signed by an Author Key Domain are to be dismissed. The Author Domain can not support SMTP.

Author Signing Practices records are published using the DNS TXT resource record type. NON-NORMATIVE DISCUSSION [to be removed before publication]: There has been considerable discussion on the DKIM WG mailing list regarding the relative advantages of TXT and a new resource record (RR) type. Read the archive for details. The RDATA for ADSP resource records is textual in format, with specific syntax and semantics relating to their role in describing Author Domain Signing Practices. The "Tag=Value List" syntax described in section 3.2 of is used. Records not in compliance with that syntax or the syntax of individual tags described in Section 4.3 MUST be ignored, although they MAY cause the logging of warning messages via an appropriate system logging mechanism. If the RDATA contains multiple character strings, the strings are to be logically concatenated with no delimiters placed between the strings. The ADSP record for an Author Domain is published at a _adsp. subdomain directly below the Author Domain; e.g., the ADSP record for example.com would be a TXT record that is published at _adsp.example.com. A domain MUST NOT publish more than one ADSP record; the semantics of an ADSP transaction returning multiple ADSP records for a single domain are undefined. (Note that example.com and mail.example.com are different domains.)

Author Domain Signing Practices are intended to apply to all mail containing the Author Domain. As an optional defensive strategy against subdomain spoofing, ADSP records could also be placed at domains that might appear to support SMTP. Wildcards within a domain publishing ADSP records will not pose a problem. This is discussed in more detail in .

ADSP records use the "tag=value" syntax described in section 3.2 of . Tags used in ADSP records are described below. Unrecognized tags MUST be ignored. In the ABNF below, the WSP token is imported from . The ALPHA and DIGIT tokens are imported from . practices (plain-text; REQUIRED). Possible values are as follows: (Default) The Author Domain permits unsigned outbound mail. All mail containing the Author Domain is initially signed by an Author Key Domain. All mail containing the Author Domain is signed by an Author Key Domain. Furthermore, if a message arrives without a valid Author Key Domain signature, receiving hosts are encouraged to dismiss the message.

ABNF: adsp-dkim-tag = %x64.6b.69.6d *WSP "=" *WSP ("OPEN" / "CLOSED" / "LOCKED") Flags, represented as a colon-separated list of names (plain-text; OPTIONAL, default is that no flags are set). Flag values are: The practices are not to be applied to subdomains of the Author Domain. This information might assist receiving hosts to better classify subdomains lacking MX or ADSP, but that have A records during an MX mandate transitional phase.

ABNF: adsp-t-tag = %x74 *WSP "=" *WSP adsp-t-tag-flag 0*( *WSP ":" *WSP adsp-t-tag-flag ) adsp-t-tag-flag = "s" / hyphenated-word ; for future extension hyphenated-word = ALPHA [ *(ALPHA / DIGIT / "-") (ALPHA / DIGIT) ] Unrecognized flags MUST be ignored.

Hosts discovering an ADSP record SHOULD produce a result semantically equivalent to applying the following steps in the order listed below. In practice, several of these steps can be performed in parallel to improve performance. However, implementations SHOULD avoid unnecessary DNS transactions. For the purposes of this section a "valid ADSP record" is one that is both syntactically and semantically correct; in particular, it matches the ABNF for a tag-list and includes a defined dkim= tag. Verify Domain Exists. The host SHOULD perform a DNS query for an MX record at the Author Domain (with no prefix). If a non-existent domain error is returned, the discovery algorithm MUST terminate with an error indicating SMTP is not supported by the Author Domain. NON-NORMATIVE DISCUSSION: To better protect domains not supporting SMTP, an initial query for an MX record is a reasonable choice since this record is predominately published by domains supporting SMTP and is more readily cached than a negative result. Whenever SMTP mandates MX records to support public exchanges, then not obtaining an MX record will terminate the discovery algorithm with an appropriate error. Fetch ADSP Record. The host SHOULD query DNS for a TXT record corresponding to the Author Domain prefixed by _adsp. (note the trailing dot). If a valid ADSP record is obtained, use that record; otherwise, continue to the next step. Verify Support of SMTP. When an MX record has not been found at the Author Domain, the host SHOULD query DNS for an A record at the Author Domain. When no A records exist at this location, the discovery algorithm terminates with a result indicating SMTP is not supported by the Author Domain. NON-NORMATIVE DISCUSSION: Whenever SMTP mandates MX records to support public exchanges, subsequent checks for A records should not be made, since the discovery process would conclude at the first step. If any of the DNS transactions involved in Author Signing Practices discovery result in a temporary error condition, the algorithm terminates without returning a result; possible actions include queuing the message or returning an SMTP error indicating a temporary failure. NOTE: Within a DNS transaction, as defined by section 5.2.2 and section 3, when a CNAME is returned, the alias name is to be processed as if it were the initial name. section 10.3 makes an exception for Exchange host names returned by MX records. An Exchange host name must not return a CNAME.

ADSP introduces some new namespaces that have been registered with IANA. In all cases, new values are assigned only for values that have been documented in a published RFC that has IETF Consensus . INFORMATIVE NOTE [to be removed before publication]: Per the definition, a domain must start with a letter or digit. Hence names such as _adsp. that start with an underscore cannot collide with host names and domains used by and .

An ADSP record provides for a list of specification tags. IANA has established the ADSP Specification Tag Registry for specification tags that can be used in ADSP fields. The initial entries in the registry comprise:

The dkim= tag spec, defined in , provides for a value specifying Outbound Signing Practices. IANA has established the ADSP Outbound Signing Practices Registry for Outbound Signing Practices. The initial entries in the registry comprise:

The t= tag spec, defined in , provides for a value specifying Flags. IANA has established the ADSP Flags Registry for ADSP Flags. The initial entries in the registry comprise:

+------+-----------------+ | TYPE | REFERENCE | +------+-----------------+ | s | (this document) | +------+-----------------+ ADSP Flags Registry Initial Values

Security considerations in the Author Domain Signing Practices are mostly related to attempts on the part of malicious senders to represent themselves as authors for whom they are not authorized to send mail, often in an attempt to defraud recipients of the message. Messages signed by keys having a g= tag restricting the range of valid local-parts are likely applied by systems that are beyond the direct control of the Author Key Domain. As a result, additional care should be taken when the restricted local-part is not within an Author Address. Acceptance of g= keys signing messages on behalf of non-Author Addresses is discouraged. Additional security considerations regarding Author Domain Signing Practices are found in the DKIM threat analysis.

Email recipients often have a core set of content authors that they already trust. Common examples include financial institutions with which they have an existing relationship and Internet web transaction sites with which they conduct business. Email abuse often seeks to exploit the name-recognition that recipients will have, for a legitimate email author, by using its domain name in the From: header field. Especially since many popular MUAs do not display the author's email address, there is no empirical evidence of the extent that this particular unauthorized use of a domain name contributes to recipient deception or that eliminating it will have significant effect. However, closing this exploit could facilitate some types of optimized processing by receive-side message filtering engines, since it could permit them to maintain higher-confidence assertions based upon trusted Author Key Domains. Unauthorized uses of domain names occur elsewhere in messages, as do unauthorized uses of organizations' names. These attacks are outside the scope of this specification. ADSP does not provide any benefit unless receiving host systems act upon ADSP results, either by treating the message differently during the delivery process or by showing some indicator to the end recipient. Such a system is out of scope for this specification. The ADSP discovery algorithm performs up to three DNS transactions per Author Domain. Since these transactions are driven by domain names in email message headers of possibly fraudulent email, receiving hosts attempting to discover ADSP records can become participants in traffic multiplication attacks.

An attack might be waged against DNS infrastructure in an attempt to disable services dependent upon DNS. Such attacks could be made worse by receiving hosts employing ADSP discovery. For this reason, SMTP should consider making MX records mandatory for public exchanges. The ADSP discovery process is not expected to impact the likelihood of an attacker being successful at poisoning local DNS resolvers. In addition, such DNS security issues are addressed by DNSSEC. Because ADSP operates within the framework of the legacy e-mail system, the default result in the absence of an ADSP record is for the Author Domain to be considered OPEN where not all messages are expected to be signed by a Author Key Domain. It is therefore important that the ADSP clients distinguish a DNS failure such as SERVFAIL from other DNS errors so that appropriate actions can be taken. To ensure message reception remains viable for crucial systems when DNS fails, IP addresses of crucial SMTP clients should be white listed to allow ADSP and DKIM to be selectively bypassed during such events.

Wildcards within a domain, excluding wildcard MX records, that also publish ADSP records, do not pose a significant problem. While referencing SMTP related records will not provide NXDOMAIN results, either an MX or A record is still obtained as evidence of SMTP support. NON-NORMATIVE NOTE: Complete ADSP coverage for all subdomains of a domain remains possible. However, ADSP records must be published at every subdomain containing A records, in addition to subdomains containing MX records. When SMTP adopts an MX record mandate for public exchanges, ADSP records would be required only at subdomains containing MX records.

&rfc1034; &rfc2119; &rfc2181; &rfc2434; &rfc2821; &rfc2822; &rfc4033; &rfc4034; &rfc4686; &rfc4871; &rfc5234; &rfc5016;

These examples are intended to illustrate typical uses of ADSP. They are not intended to be exhaustive, nor to apply to every domain's or mail system's individual situation. Administrators are advised to consider the ways that mail processing can modify messages in a manner that will invalidate existing DKIM signatures, such as mailing lists, courtesy forwarders, and other paths that could add or modify headers, or modify the message body. In that case, if these modifications invalidate DKIM signatures, receiving hosts will consider the mail not to have an Author Key Domain signature, even though a Valid Signature was present when the mail was originally sent.

A common mail system configuration handles all of a domain's users' incoming and outgoing mail through a single MTA or group of MTAs. In that case, the MTA(s) can be configured to sign outgoing mail with an Author Key Domain signature. In this situation it might be appropriate to publish a CLOSED ADSP record for the Author Domain, depending on whether users also send mail through other paths that do not apply an Author Key Domain signature. Such paths could include MTAs at hotels or hotspot networks used by travelling users, or web sites that provide "mail an article" features.

Another common configuration uses a domain solely for bulk or broadcast mail, with no individual human users, again typically sending all the mail through a single MTA or group of MTAs that can apply an Author Key Domain signature. In this case, before publishing a CLOSED ADSP record, the domain's management should be confident that all of its outgoing mail will be sent through signing MTAs. Lacking individual users, the domain is unlikely to participate in mailing lists, but could still send mail through other paths that might invalidate signatures. Domain owners also often use specialist mailing providers to send their bulk mail. In that case, the mailing provider needs access to a suitable signing key in order to apply an Author Key Domain signature. One possible route would be for the Author Key Domain owner to generate the key and give it to the mailing provider. Another would be for the Author Key Domain to delegate a subdomain below the _domainkey. label to the mailing provider. For example, bigbank.example might delegate esp-00._domainkey.bigbank.example to such a provider. In that case, the provider could generate keys and DKIM DNS records itself and provide Author Key Domain signatures.

In some cases, a domain might sign all its outgoing mail with an Author Key Domain signature, but prefers that receiving host systems dismiss mail without a valid Author Key Domain signature to avoid confusion with mail sent from fraudulent sources unable to apply an Author Key Domain signature. (This latter kind of mail is sometimes loosely called "forgeries".) In that case, it might be appropriate to publish a "LOCKED" ADSP record. Note that a domain SHOULD NOT publish a LOCKED ADSP record when it wishes to maximize the likelihood that its mail is delivered, since it could cause some fraction of the mail to be discarded. As a special case, if a domain sends no mail at all, it can safely publish a LOCKED ADSP record, since any mail with an Author Address for this domain is a forgery.

Another common use case is for a third party to enter into an agreement whereby that third party will send bulk or other mail on behalf of a designated Author Domain, using that domain in the RFC2822 From: or other headers. Due to the many and varied complexities of such agreements, third party signing is not addressed in this specification.

This document was based upon the draft-ietf-dkim-ssp-003.

Conditioned Author Signing Practices Discovery Procedure SMTP verification step to be made only when an MX record had not been found.

Modified the Author Signing Practices Discovery Procedure to better conform with terms in RFC2821. In addition, a note now covers the issue of CNAMEs.