95.1.40. pepsi-stage-dmarc-report¶
read the DMARC aggregate reports other receivers send about us
- Handbuchabschnitt:
1
95.1.40.1.1. Name¶
pepsi-stage-dmarc-report - die DMARC-Sammelbericht-Stage der Pepsi-Pipeline.
95.1.40.1.2. Übersicht¶
pepsi-stage-dmarc-report [GLOBAL-OPTIONS] worker
95.1.40.1.3. Beschreibung¶
pepsi-stage-dmarc-report ist ein Stage-Programm, das von pepsi-dispatch(1) als persistenter Worker ausgeführt wird, der Nachrichten-IDs von der Standardeingabe liest.
Der DMARC-Eintrag einer Domain (RFC 7489) nennt in rua=, wohin Empfänger ihre Sammelberichte senden: einmal täglich, je empfangender Organisation, welche Adressen Mail mit der Domain in From: gesendet haben, wie viele Nachrichten und ob DKIM und SPF in Ausrichtung mit dieser Domain bestanden haben. Nur aus diesen Berichten erfahren Sie, ob p=reject einen legitimen Absender ablehnt, etwa einen Newsletter-Dienst oder ein Ticketsystem: bevor es das tut, und während es das tut. Diese Stage liest sie in die Datenbank ein (pepsi.dmarc_report und pepsi.dmarc_report_record); pepsi-status(1), die administrative Konsole (Logs, DMARC reports) und pepsi-setup check (siehe pepsi-setup(1)) berichten von dort.
Platzieren Sie sie auf dem eingehenden Pfad vor den Whitelist-, Challenge- und Zahlungsschranken: Der Berichtsroboter eines Empfängers passiert keine davon. Sie handelt nur bei Mail an LOCAL_PART in einer der bedienten Domains; alles andere schaltet unverändert zu NEXT_STAGE weiter, und im vereinheitlichten Binärprogramm tut es das allein anhand der Metadaten der Nachricht, ohne den Nachrichtentext zu laden. pepsi-setup --wizard platziert sie auf jeder Installation, die Mail empfängt, direkt hinter der Entschlüsselung, und pepsi-setup run schlägt dann einen DMARC-Eintrag vor, dessen rua= mailto:dmarc-reports@<domain> ist.
95.1.40.1.4. Was mit Berichtsmail geschieht¶
Eine Nachricht an die Berichtsadresse, die einen lesbaren Bericht (einen gzip-, zip- oder einfachen XML-Anhang, wie RFC 7489 §7.2.1 beschreibt) über eine bediente Domain trägt (die Domain selbst, eine Subdomain oder die Organisationsdomain einer bedienten Subdomain), wird gespeichert und verbraucht. Derselbe Bericht (gleiche Organisation, Berichts-ID, Domain und Authentifizierung) wird nicht zweimal gespeichert.
Ein Bericht über eine Domain, die dieser Host nicht bedient, wird verbraucht und ignoriert.
Mail an die Berichtsadresse, die kein lesbarer Bericht ist, wird verbraucht und verworfen (protokolliert auf
info). Jeder kann an eine veröffentlichterua=-Adresse schreiben, und solche Mail an ein nicht existierendes Postfach weiterzureichen würde sie in Bounces an gefälschte Absender verwandeln.Mit
DELIVER = yeswird die Nachricht zusätzlich anNEXT_STAGEweitergereicht, für eine Site, die ein Postfach an der Adresse führt.Jeder andere Empfänger derselben Nachricht behält seine Kopie mit seinen eigenen DSN-Parametern; nur die Berichtsadresse wird aus dem Umschlag entfernt.
95.1.40.1.5. Was ein Bericht beweist¶
Ein Bericht beweist nichts darüber, wer ihn geschrieben hat. Die Stage hält fest, wofür der Ingress bei der Mail, die ihn trug, bürgen konnte: die From:-Domain, wenn DMARC bestanden wurde, sonst die Domain des Umschlagabsenders, wenn SPF bestanden wurde. Ein Bericht mit keinem von beiden wird als nicht authentifiziert gespeichert (protokolliert auf warn). Nur authentifizierte Berichte zählen für ein Urteil: Ein gefälschter Bericht kann weder p=reject sicher erscheinen lassen noch eine Quelle erfinden, die es ablehnen würde. dkim=pass allein authentifiziert einen Bericht nicht; es sagt, dass irgendeine Signatur verifiziert wurde, nicht wessen. Eine gefälschte Kopie eines Berichts verdeckt nie die authentifizierte, da beide getrennt gespeichert werden.
95.1.40.1.6. Feindliche Eingabe¶
Ein Bericht ist eine komprimierte Datei aus dem Internet:
Die Dekompression stoppt bei
MAX_REPORT_SIZE(Standardwert 16 MiB): Eine gzip- oder zip-Bombe endet an der Obergrenze, und ein zip-Eintrag, der eine größere Größe angibt, wird abgelehnt, bevor er gelesen wird. Nur die Methode deflate wird verstanden.Der XML-Leser expandiert nur die fünf vordefinierten Entitäten und Zeichenreferenzen, nie eine Entität, die ein Dokument deklariert, sodass ein Bericht mit Entitätsexpansion („billion laughs“) die Größe behält, mit der er ankam.
Höchstens 20 000 Datensätze eines Berichts werden gespeichert; der Rest wird gezählt (
records_dropped).
95.1.40.1.7. Konfiguration¶
[stage-<name>] mit PROGRAM = pepsi-stage-dmarc-report:
- NEXT_STAGE (erforderlich)
Wohin jede Nachricht geht, die kein Bericht ist, also fast alle. pepsi-setup(1) prüft, dass das Ziel auflöst.
- LOCAL_PART (Standardwert
dmarc-reports) Der Local-Part, an dem die Berichte ankommen, in jeder
LOCAL_DOMAINS-Domain, nachdem die Subadresse entfernt wurde (RECIPIENT_DELIMITER). Die Empfängerprüfung beiRCPTnimmt ihn in jeder bedienten Domain an.- DELIVER (Standardwert
no) Die Berichtsmail zusätzlich an
NEXT_STAGEweiterreichen.- MAX_REPORT_SIZE (Standardwert
16M) Obergrenze für einen dekomprimierten Bericht, als Bytegröße (Suffixe
K/M/G).nonewird abgelehnt: Die Obergrenze ist das, was eine Bombe aufhält.- LOCAL_DOMAINS, RECIPIENT_DELIMITER
Welche Domains bedient werden (Standardwert
[pepsi-ingress] ACCEPTED_DOMAINS) und das Subadress-Trennzeichen (Standardwert[pepsi] RECIPIENT_DELIMITER, sonst+).
[pepsi-dmarc-reports] (gelesen von der Startprüfung dieser Stage, von pepsi-status(1), pepsi-queue(1) gc, der Konsole und pepsi-setup(1)):
- RETAIN_DAYS (Standardwert 90)
Tage, die ein Bericht nach dem Ende des Zeitraums, den er abdeckt, aufbewahrt wird;
pepsi-queue gclöscht ältere (mit ihren Datensätzen).- WINDOW_DAYS (Standardwert 7)
Wie viele Tage die Zusammenfassungen und das Urteil von
pepsi-setup checkzurückblicken, gemessen am Ende des Zeitraums jedes Berichts; höchstensRETAIN_DAYS.
Es gibt kein BOUNCE_STAGE: Die Stage erzeugt nie einen Bounce. Ein Datenbankfehler beim Speichern eines Berichts wird wie jeder Stage-Fehler wiederholt. Die Basiskonfiguration wird beim Start des Workers geprüft: Eine fehlerhafte lässt ihn den Start verweigern (Exit 78).
95.1.40.1.8. Nachrichtendaten¶
Die Stage lädt die ganze Nachricht (Load::Full), aber im vereinheitlichten Binärprogramm fusioniert jede Nachricht ohne Empfänger an der Berichtsadresse anhand ihrer Metadaten durch, sodass gewöhnliche Mail hier nie ihren Nachrichtentext lädt. Die Stage schreibt eine weitergereichte Nachricht nie um; eine aufgeteilte Nachricht behält ihren state (state.dsn auf die verbleibenden Empfänger zugeschnitten). Telemetrie-Schlüssel dmarc-report: eine Zählung pro gespeichertem Bericht.
95.1.40.1.9. Befehle¶
- worker
Liest Nachrichten-IDs von der Standardeingabe und verarbeitet jede. Der einzige Ausführungsmodus; der Dispatcher startet und stoppt diese Worker.
95.1.40.1.10. Globale Optionen¶
- -c FILE, –config FILE
Liest die Konfiguration aus FILE, statt die Standardorte zu durchsuchen. Muss vor dem Unterbefehl stehen.
- -L LOGLEVEL, –log LOGLEVEL
Setzt die Log-Ausführlichkeit (Standardwert
[pepsi] LOG, sonstinfo).- -v, –verbose
Zeigt Log-Meldungen aus allen Quellen.
- -h, –help; -V, –version
Gibt eine Verwendungsübersicht / die Version aus und beendet sich.
95.1.40.1.11. Exit-Status¶
- 0
Der Worker hat sich sauber beendet.
- 1
Ein Fehler ist aufgetreten (eine fehlerhafte Konfigurationsdatei, ein nicht auflösbarer Stage-Abschnitt oder eine fehlgeschlagene Datenbankverbindung). Der Grund wird in das Journal geschrieben.
- 78
Der Worker hat den Start verweigert: Sein Abschnitt oder
[pepsi-dmarc-reports]lässt sich nicht parsen.
95.1.40.1.12. Beispiele¶
Die Berichte direkt nach der Entschlüsselung lesen:
[stage-decrypt]
PROGRAM = pepsi-stage-decrypt
NEXT_STAGE = dmarc-reports
[stage-dmarc-reports]
PROGRAM = pepsi-stage-dmarc-report
NEXT_STAGE = check-whitelist
und für jede bediente Domain veröffentlichen:
_dmarc.example.org. IN TXT "v=DMARC1; p=reject; adkim=s; rua=mailto:dmarc-reports@example.org"
Eine Nachricht von Hand verarbeiten:
echo 4711 | pepsi-stage-dmarc-report -c /etc/pepsi/pepsi.conf worker
95.1.40.1.13. Siehe auch¶
pepsi-status(1), pepsi-setup(1), pepsi-queue(1), pepsi-httpd(1), pepsi-dispatch(1), pepsi.conf(5), pepsi.state(7)
RFC 7489, Domain-based Message Authentication, Reporting, and Conformance (DMARC), §7.2 (Sammelberichte) und Anhang C (ihr XML-Schema).
95.1.40.1.14. Fehler¶
Melden Sie Fehler an den Pepsi-Issue-Tracker.