What is TLS-RPT? SMTP TLS reporting explained, with a setup example
TL;DR: TLS-RPT (SMTP TLS Reporting) is a DNS record that asks other mail servers to send you daily reports about TLS problems when they deliver email to your domain. It is defined in RFC 8460. You publish a TXT record at _smtp._tls.yourdomain.com with a reporting address. It is most useful alongside MTA-STS, which tells senders to require TLS. The reports are JSON files, so use a parser or a reporting service to read them.
What TLS-RPT does
When a server sends email to your domain, it tries to use TLS encryption. If the TLS handshake fails, or the certificate is wrong, the sender may fall back to plain text or fail. TLS-RPT lets senders tell you about those problems, so you can fix them. It does not block anything by itself.
The DNS record
Add a TXT record:
Name: _smtp._tls.example.com
Type: TXT
Value: v=TLSRPTv1; rua=mailto:[email protected]
rua is the address or HTTPS URL that receives reports. Use a mailbox you monitor, or a service that processes reports. See DNS record types.
How it relates to MTA-STS and DANE
- MTA-STS publishes a policy telling senders to require TLS and which MX hosts to trust.
- DANE uses DNSSEC to pin certificates. See DNSSEC explained.
- TLS-RPT reports failures for either.
For basic email authentication, set SPF, DKIM and DMARC first. TLS-RPT is a second layer.
What the reports contain
Reports arrive as compressed JSON, usually daily. They list the policy that applied, the number of successful and failed sessions and failure types such as certificate expired, certificate not trusted or STARTTLS not offered. Look for repeated failure types, then fix certificates or MX settings. Check your certificate setup with TLS 1.2 vs 1.3.
Should you set it up?
If you run your own mail server or care about secure delivery, yes, since it costs one DNS record. If you use Google Workspace or Microsoft 365, check their documentation, because the provider handles server TLS but you can still publish TLS-RPT and MTA-STS.
FAQs
What is TLS-RPT?
A DNS-based reporting standard for failures of TLS when email is delivered to your domain.
Is TLS-RPT required?
No, but it is useful for visibility.
Where do I add the record?
As a TXT record at _smtp._tls.yourdomain.
Do I need MTA-STS too?
Not required, but they work best together.
What format are the reports?
Compressed JSON.
Can I send reports to a web URL?
Yes, rua can use an HTTPS endpoint.
Does TLS-RPT stop spoofing?
No. That is what DMARC is for.
Which RFC defines it?
RFC 8460.
Conclusion
TLS-RPT costs a single TXT record and gives you visibility into failed secure deliveries. Add it, watch the reports and combine it with MTA-STS if you want senders to require TLS.
HostCloud helps Indian websites with reliable hosting, domains and support. See the options at https://hostcloud.in.
Sources: