Come usare questo generatore TLS-RPT
Passo 1: Aggiungi destinazioni di reporting
Inserisci dove vuoi ricevere i report di fallimento TLS:
Email (raccomandato per iniziare)
mailto:tlsrpt@captaindns.com
Webhook HTTPS (per automazione)
https://tlsrpt.captaindns.com/v1/report
Puoi aggiungere più destinazioni - i report vanno a tutte.
Passo 2: Copia il record generato
Il generatore crea un record RFC 8460 valido:
v=TLSRPTv1; rua=mailto:tlsrpt@captaindns.com
Passo 3: Pubblica nel DNS
Crea un record TXT a _smtp._tls.captaindns.com con il valore generato.
Esempio per captaindns.com:
- Tipo: TXT
- Host:
_smtp._tls - Valore:
v=TLSRPTv1; rua=mailto:tlsrpt@captaindns.com
Passo 4: Verifica la pubblicazione
Usa il nostro TLS-RPT Record Checker per confermare la configurazione corretta.
Formato record TLS-RPT
Componenti richiesti
| Componente | Formato | Esempio |
|---|---|---|
| Versione | v=TLSRPTv1 | Deve essere esattamente questo |
| URI di reporting | rua=schema:destinazione | rua=mailto:reports@captaindns.com |
Schemi URI supportati
mailto: - Consegna email
rua=mailto:team-sicurezza@captaindns.com
I report arrivano come allegati JSON compressi.
https: - Consegna webhook
rua=https://api.captaindns.com/tlsrpt/ingest
I report vengono inviati POST come JSON con Content-Type: application/tlsrpt+gzip
Destinazioni multiple
Separa con virgole:
v=TLSRPTv1; rua=mailto:reports@captaindns.com,https://tlsrpt.captaindns.com/report
Autorizzazione reporting esterno
Quando invii report a un dominio diverso, è richiesta l'autorizzazione.
Scenario
Il tuo dominio: captaindns.com
Destinazione report: mailto:reports@tlsrpt-service.com
Autorizzazione richiesta
tlsrpt-service.com deve pubblicare:
captaindns.com._report._tls.tlsrpt-service.com TXT "v=TLSRPTv1"
Usare reporting sullo stesso dominio
Per evitare la complessità dell'autorizzazione, usa un indirizzo sul tuo dominio:
v=TLSRPTv1; rua=mailto:tlsrpt@captaindns.com
Esempi per provider DNS
Cloudflare
- Vai alle impostazioni DNS del tuo dominio
- Aggiungi record:
- Tipo: TXT
- Nome:
_smtp._tls - Contenuto: Il tuo valore record generato
- TTL: Auto
AWS Route 53
- Apri la zona ospitata per il tuo dominio
- Crea record:
- Nome record:
_smtp._tls - Tipo record: TXT
- Valore:
"v=TLSRPTv1; rua=mailto:tlsrpt@captaindns.com" - TTL: 3600
- Nome record:
Aruba / OVH
- Vai alle impostazioni DNS
- Aggiungi record personalizzato:
- Host:
_smtp._tls - Tipo: TXT
- TTL: 3600
- Dati: Il tuo valore record generato
- Host:
Configurazione completa sicurezza email
TLS-RPT fa parte della sicurezza completa del trasporto email:
1. MTA-STS (Applica TLS)
Indica ai server mittenti di richiedere crittografia TLS.
2. TLS-RPT (Riporta fallimenti)
Riporta quando l'applicazione TLS fallisce.
- Usa questo generatore
- Verifica stato TLS-RPT
3. Distribuzione raccomandata
- Distribuisci MTA-STS con
mode: testing - Aggiungi TLS-RPT per ricevere report
- Monitora i report per 2-4 settimane
- Passa MTA-STS a
mode: enforce - Continua a monitorare via TLS-RPT
Capire i report TLS-RPT
Struttura del report
{
"organization-name": "Google Inc.",
"date-range": {
"start-datetime": "2024-01-15T00:00:00Z",
"end-datetime": "2024-01-16T00:00:00Z"
},
"contact-info": "postmaster@google.com",
"report-id": "2024011512345",
"policies": [{
"policy": {
"policy-type": "sts",
"policy-string": ["version: STSv1", "mode: enforce", "mx: mail.captaindns.com", "max_age: 604800"],
"policy-domain": "captaindns.com"
},
"summary": {
"total-successful-session-count": 8432,
"total-failure-session-count": 3
},
"failure-details": [{
"result-type": "certificate-expired",
"sending-mta-ip": "198.51.100.1",
"receiving-mx-hostname": "mail.captaindns.com",
"failed-session-count": 3
}]
}]
}
Campi chiave spiegati
| Campo | Significato |
|---|---|
| organization-name | Organizzazione mittente |
| date-range | Periodo di reporting di 24 ore |
| total-successful-session-count | Connessioni TLS riuscite |
| total-failure-session-count | Connessioni TLS fallite |
| result-type | Motivo del fallimento (certificate-expired, sts-policy-invalid, ecc.) |
| sending-mta-ip | IP che ha fallito la connessione |
FAQ - Domande frequenti
D: Cos'è TLS-RPT e perché ne ho bisogno?
R: TLS-RPT (SMTP TLS Reporting) è un record DNS che indica ai server di posta mittenti dove inviare report sui fallimenti di connessione TLS. Senza di esso, non hai visibilità sui fallimenti di crittografia che influenzano la consegna delle email.
D: Dove pubblico il record generato?
R: Pubblica il record generato come record TXT a _smtp._tls.captaindns.com. Funziona con qualsiasi provider DNS incluso Cloudflare, Route53, Aruba, OVH, ecc.
D: In che formato sono i report?
R: I report TLS-RPT sono documenti JSON, tipicamente compressi gzip. Includono: organizzazione mittente, intervallo date, informazioni policy (MTA-STS/DANE), conteggi sessioni e dettagli fallimenti. I report vengono inviati circa ogni 24 ore.
Strumenti complementari
| Strumento | Scopo |
|---|---|
| TLS-RPT Syntax Checker | Valida record prima della pubblicazione |
| TLS-RPT Record Checker | Verifica configurazione DNS in produzione |
| MTA-STS Generator | Crea policy MTA-STS |
| MTA-STS Record Checker | Verifica distribuzione MTA-STS |
| Verifica dominio email | Audit completo autenticazione |
Risorse utili
- RFC 8460 - SMTP TLS Reporting (specifica ufficiale)
- RFC 8461 - MTA-STS (protocollo complementare)
- Google - Configurare TLS reporting
- Postfix - Documentazione TLS