86. pepsi-tlsrpt¶
Erstellt und versendet die täglichen SMTP-TLS-Reporting-Berichte (RFC 8460).
86.1. Rolle¶
pepsi-tlsrpt ist die Absenderseite von SMTP TLS Reporting (RFC 8460). Wenn [pepsi-tlsrpt] SEND_REPORTS an ist (es ist standardmäßig aus), halten die Relay-Stages das Ergebnis jeder ausgehenden TLS-Sitzung, einen Erfolg oder einen klassifizierten Fehler, in der Tabelle der Aggregat-Zähler pepsi.tls_session fest. Eine Klartext-Zustellung zählt nur, wenn MTA-STS oder DANE TLS verlangte, und zwar als starttls-not-supported. Eine Sitzung, die DANE = warn durchließ, obwohl das Zertifikat zu keinem TLSA-Eintrag passte, zählt als tlsa-invalid. Eine angekündigte MTA-STS-Richtlinie, die beim ersten Kontakt nicht abgerufen werden konnte, zählt als sts-policy-fetch-error oder sts-webpki-invalid und wird ohne MX-Host gemeldet.
Einmal täglich per Cron ausgeführt, stellt dieses Werkzeug die Zähler eines Tages zu einem Sammelbericht pro Richtliniendomain zusammen, schlägt die _smtp._tls-rua-Berichtsadresse dieser Domain nach und schickt den gzip-komprimierten JSON-Bericht dorthin, an höchstens die ersten fünf Ziele, die der Eintrag nennt. Es verschickt den Bericht per E-Mail (mailto:, bei REPORT_STAGE in die Pipeline injiziert, sodass er signiert und weitergeleitet wird) oder per HTTPS-POST (https:). Es verbindet sich über [pepsi-postgres] und wird durch [pepsi-tlsrpt] konfiguriert. Es ist keine Stage. Als Cron-Job startet es normalerweise als root und läuft dann vor dem Verbinden als Dienstkonto pepsi weiter, sodass der Crontab-Eintrag kein sudo -u pepsi braucht. Referenz: pepsi-tlsrpt(1).
Die ankündigende Hälfte (das Veröffentlichen unseres eigenen _smtp._tls-Eintrags aus [pepsi-tlsrpt] RUA) wird von pepsi-setup erledigt.
86.2. Funktionen¶
report — stellt die Berichte des Tages zusammen und verschickt sie (Standardwert: gestern, UTC).
--datewählt einen anderen UTC-Tag;--dry-rungibt das JSON jedes Berichts aus und behält die Zähler. Die Zähler einer berichteten Domain für diesen Tag werden gelöscht, sodass erneute Läufe idempotent sind.prune — löscht Zähler, die älter als das Aufbewahrungsfenster sind (
[pepsi-tlsrpt] RETAIN_DAYS, Standardwert 7;--older-thanüberschreibt), und erfasst dabei Tage, die nie berichtet wurden (z. B. eine Domain, die keinruaankündigt).pepsi-tlsrpt-prune.timerführt es täglich aus, ob Berichte gesendet werden oder nicht.
Eine Berichtsnachricht trägt state.tlsrpt = true; die Sitzungsaufzeichnung der Relay-Stages überspringt solche Nachrichten, sodass ein Bericht, der selbst auf einen TLS-Fehler stößt, nie einen Bericht über einen Bericht erzeugt. Er wird von REPORT_FROM gesendet, nicht vom Null-Absender, weil RFC 8460 §5.3 verlangt, dass sich ein Bericht unter DKIM und DMARC ausrichten lässt.
86.3. Sicherheit¶
Beide rua-Formen stammen aus einem DNS-Eintrag, den die Domain veröffentlicht, über die berichtet wird, daher werden beide als feindliche Eingabe behandelt. Ein mailto:-Ziel muss eine einzelne schlichte local@domain-addr-spec sein (keine Header- oder Empfänger-Injektion in die Berichtsnachricht). An ein https:-Ziel wird über den HTTPS-Client der Schlüsselentdeckung mit den System-CA-Wurzeln gesendet: Jede Adresse, auf die der Hostname auflöst, muss öffentlich sein (kein Loopback-, RFC-1918-, CGNAT- oder Link-Local-Ziel innerhalb des Netzes des Mailservers), Weiterleitungen werden nicht verfolgt, die Antwort ist auf 64 KiB und die Anfrage auf 30 s begrenzt — siehe „Key-discovery SSRF“ in Sicherheitsmodell und Ein entfernter Absender. Nur die ersten fünf Ziele einer Domain werden verwendet, sodass ein Eintrag, der Hunderte von Adressen Dritter nennt, nicht jeden berichtenden Server zu einem Massenversender dafür machen kann. Die Aufbewahrung der Zähler steht in der Verfügbarkeitstabelle (Verfügbarkeit).
86.4. Konfiguration¶
[pepsi-tlsrpt]: SEND_REPORTS (Standardwert no — ob die Relay-Stages überhaupt Sitzungen festhalten), RUA (die Berichtsadresse, die wir bekanntgeben und die pepsi-setup in den _smtp._tls-TXT-Eintrag verwandelt), REPORT_FROM (zum Senden erforderlich) und REPORT_STAGE (wohin ein mailto:-Bericht injiziert wird), die optionalen, im Bericht gezeigten ORGANIZATION und CONTACT sowie RETAIN_DAYS (Standardwert 7). Siehe pepsi.conf(5).
86.5. Siehe auch¶
pepsi-setup, pepsi-stage-relay-to-internet, pepsi-stage-relay-to-smarthost, Architektur, pepsi-tlsrpt(1), pepsi.conf(5).