CertaDNS
Skip to lesson

TLS Reporting · lesson 2 of 2

Reading one

After this lesson you can

Name the cause behind each failure type a report can carry.

Assumes you have read What TLS-RPT reports.

Each failed session in a report carries a result type, and the type names the cause precisely enough to act on. There are only a handful worth knowing.

The failure types

TypeWhat happenedWhere the fault is
starttls-not-supportedThe receiving host did not advertise STARTTLSYour MX host — or an attacker stripping it.
certificate-expiredThe presented certificate was out of dateYour MX host’s certificate.
certificate-host-mismatchThe certificate did not cover the MX hostnameYour certificate’s subject names.
certificate-not-trustedThe chain did not validate to a trusted rootA missing intermediate, usually.
validation-failureTLS negotiation failed for another reasonProtocol or cipher mismatch.
sts-policy-fetch-errorThe policy could not be retrievedYour policy host or its certificate.
sts-policy-invalidThe policy was fetched and would not parseYour policy file.
sts-webpki-invalidThe policy host’s certificate did not validateYour policy host’s certificate.
dane-requiredThe sender required DANE and could not validate itYour TLSA records or DNSSEC chain.

Reading the pattern

One sender, all your MX hosts, certificate-not-trusted
   -> that sender's trust store lacks an intermediate you
      are not sending. Fix the chain, not the certificate.

All senders, one MX host, certificate-host-mismatch
   -> that host's certificate does not name it. A host added
      to the MX set without being added to the certificate.

All senders, all hosts, sts-policy-fetch-error
   -> your policy host is down, or its certificate expired.
      Nothing to do with mail servers at all.

One sender, starttls-not-supported, intermittently
   -> a middlebox on that path. Or, rarely, the thing
      MTA-STS exists to detect.

The two axes are the same as in DMARC reporting: sender and host. A failure confined to one sender is usually theirs; one confined to one host is yours and is narrow; one affecting everything is yours and is not a mail problem at all.

starttls-not-supported deserves a second look

Nearly every occurrence is a misconfigured host or a middlebox. The remaining fraction is an actual downgrade attempt, and this report is the only place it would ever appear — which is the entire argument for publishing TLS-RPT even without a policy.

Knowledge check

Reports from every sender show sts-webpki-invalid, but mail is still being delivered normally. What has happened?

Try it on a real domain

Free, no account, public DNS only.

Last reviewed