50. pepsi-stage-check-whitelist

Markiert Mail von vertrauenswürdigen Absendern als Nicht-Spam.

50.1. Rolle

pepsi-stage-check-whitelist konsultiert eine benannte weiße Liste vertrauenswürdiger Absender und hält, wenn der From:-Header der Nachricht passt, state.spam = false fest, sodass ein späteres pepsi-stage-anti-spam die Nachricht ohne Zahlung durchlässt. Platzieren Sie es vor der Anti-Spam-Stage. Es annotiert nur den State und schaltet weiter; es verwirft, bounct oder pausiert eine Nachricht nie. Referenz: pepsi-stage-check-whitelist(1).

50.2. Funktionen

  • Datenbankgestützte Whitelists: Die Tabelle pepsi.whitelist gruppiert Datensätze unter einem whitelist_name. WHITELIST_NAME ist eine kommagetrennte Liste der zu konsultierenden Gruppen, und ein Eintrag darf eine Vorlage sein, die {localpart} oder {login} enthält und je Umschlagempfänger expandiert wird. So konsultiert WHITELIST_NAME = correspondents, {localpart}/correspondents die gemeinsame Liste des Betreibers und die eigene Liste jedes Empfängers, in dem Namensraum, den pepsi-whitelist diesen Benutzer verwalten lässt. Nur ein Empfänger an einer lokalen Domain darf eine Whitelist benennen (sonst würde ein vom Angreifer gewählter Mitempfänger zur Liste eines beliebigen lokalen Benutzers expandieren), und {login} verlangt zusätzlich, dass sich die Adresse zu einem passwd-Konto auflöst; platzieren Sie die Stage bei dessen Verwendung also hinter pepsi-stage-aliases. Jeder zutreffende Name wird in einer einzigen Abfrage geprüft.

  • POSIX-ERE-Abgleich: Jeder whitelist_regex ist ein erweiterter regulärer POSIX-Ausdruck. Er wird ohne Beachtung der Groß-/Kleinschreibung gegen das Feld abgeglichen, das das match_field des Datensatzes benennt. Der Abgleich nutzt PostgreSQLs ~*-Operator in einem einzigen Round-Trip und wird nach fünf Sekunden abgebrochen; ein abgebrochener Abgleich zählt als kein Treffer, sodass ein pathologisches Muster kein Datenbank-Backend blockieren kann. Die Felder sind:

    • from (der Standardwert) — die aus dem From:-Header herausgeparste addr-spec, nie der rohe Header-Wert: Andernfalls würde eine Whitelist-Adresse in der Anzeigenamen-Position einen Treffer vortäuschen. RFC-5322-Kommentare und CFWS werden entfernt, und ein From:, das mehr als ein Postfach benennt, passt auf nichts (das DKIM-/DMARC-Urteil wird für die erste Adresse berechnet, ein Treffer auf einer späteren würde also zwei Fragen über zwei Absender beantworten).

    • list-id — der RFC-2919-Bezeichner aus dem List-Id:-Header der Nachricht. Die Beiträge einer Mailingliste tragen beliebige From:-Adressen, daher kann kein from-Muster sagen „alles, was über diese Liste kam“.

    Der Ausdruck selbst ist nicht verankert; verankern Sie ihn mit ^/$, um eine ganze Adresse abzugleichen (was pepsi-stage-auto-whitelist schreibt).

    Eine Zeile, deren Ausdruck genau eine Adresse oder Listenkennung oder jedes Postfach einer Domain beschreibt (die Formen, die pepsi-whitelist und pepsi-stage-auto-whitelist schreiben, wenn der Text ASCII ist), wird über einen Index gefunden, statt dass der Ausdruck ausgewertet wird. Das Ergebnis ist dasselbe; nur die übrigen Zeilen werden einzeln ausgewertet, sodass der Aufwand der Prüfung nicht mit der Zahl der gelernten Korrespondenten wächst.

  • Optionale Bedingungen je Datensatz:

    • dkim_required → trifft nur zu, wenn die From:-Domain authentifiziert ist: state.auth.dkim = pass oder ein ARC-Pass, den DMARC ebenfalls bestätigt (state.auth.arc = pass und state.auth.dmarc = pass). Ein ARC-Pass allein belegt nur die Integrität der Kette (eine Ein-Hop-Kette kann über ein gefälschtes From: selbst erzeugt werden) und erfüllt den Datensatz daher nicht für sich genommen. Die Spalte ist standardmäßig wahr, wie bei pepsi-whitelist add.

    • dmarc_required → trifft nur zu, wenn die Nachricht beim Ingress DMARC über einen der beiden ausgerichteten Bezeichner bestanden hat, eine ausgerichtete DKIM-Signatur oder einen ausgerichteten SPF-Pass (state.auth.dmarc = pass), oder ein vertrauenswürdiger ARC-Versiegler sie trotz eines DMARC-Fehlschlags durchgelassen hat (state.auth.arc_override). Das ist die Stufe für einen Korrespondenten, dessen Domain nicht per DKIM signiert; ein nicht ausgerichteter SPF-Pass zählt nicht, und jeder dkim_required-Pass erfüllt sie. Setzt ein Datensatz mehrere Bedingungen, müssen alle erfüllt sein.

    • signature_required → trifft nur zu, wenn state.signature_verified true ist, was pepsi-stage-decrypt für eine Nachricht setzt, deren Ende-zu-Ende-Signatur gegen einen vertrauenswürdigen Schlüssel verifiziert wurde. Ein valid-untrusted-Urteil setzt es bewusst nicht, sodass ein solcher Datensatz eine echte „dieser Korrespondent signiert, nachprüfbar“-Schranke ist und nicht ein „irgendjemand hat dies signiert“. Platzieren Sie eine Decrypt-Stage vor dieser, sonst trifft der Datensatz nie zu. Eine Signatur aus einem S/MIME-EnvelopedData (AES-CBC) zählt nicht: Ob sich ein verändertes CBC-Chiffrat noch verifizieren lässt, hängt von seinem Padding ab, und das Urteil entscheidet, ob der Absender zum Zahlen oder Bestätigen aufgefordert wird (CBC-Padding- und Format-Orakel gegen nicht authentifiziertes S/MIME).

    • sealer_domain → passt nur, wenn die Nachricht mit einer ARC-Kette ankam, die validiert hat, und die benannte ADMD unter ihren Siegelnden ist (state.auth.arc = pass und die Domain in state.auth.arc_sealers). Das ist es, was einen list-id-Datensatz sicher macht: List-Id: ist unauthentifizierter Text, den jeder kopieren kann, und eine gültige ARC-Kette vermittelt für sich genommen kein Vertrauen (RFC 8617 §8.4). Erst die Benennung der siegelnden Stelle macht aus dem Paar einen Beleg.

  • Ablaufende Listendatensätze: Ein von pepsi-stage-auto-whitelist gelernter list-id-Datensatz trifft nur bis last_seen + max_idle zu; jeder authentifizierte Beitrag, auf den er zutrifft, schiebt last_seen nach vorn (höchstens täglich), und pepsi-queue gc löscht ihn, sobald er verfällt.

  • Festhalten von Bestätigungsanfragen: Mit RECORD_LIST_CONFIRMATIONS wird eine Nachricht, die wie die Abonnement-Bestätigungsanfrage einer Liste aussieht (eine einzelne Message-ID:, confirm im Subject:, ein -request- / -confirm- / -join- / -subscribe-Absender oder Reply-To:), je lokalem Empfänger für LIST_CONFIRMATION_DAYS (7) festgehalten, sodass die Auto-Whitelist-Stage die Liste aus der Antwort dieses Empfängers lernen kann. Das Festhalten vertraut nichts.

  • Nicht-destruktiv: Bei einem Treffer führt es spam: false zusammen und schaltet zu NEXT_STAGE weiter; bei keinem Treffer schaltet es unverändert weiter. Eine Nachricht ohne From:-Header und eine, auf die kein konfigurierter Whitelist-Name zutrifft, passen auf nichts.

50.3. Konfiguration

[stage-<name>]: PROGRAM = pepsi-stage-check-whitelist, WHITELIST_NAME (erforderlich; die kommagetrennte Liste der whitelist_name-Gruppen, wörtlich oder als Vorlage), NEXT_STAGE (erforderlich, weil die Stage die Nachricht immer weiterreicht) sowie die gemeinsamen Lokalitätsoptionen LOCAL_DOMAINS (Standardwert [pepsi-ingress] ACCEPTED_DOMAINS), TARGETS und RECIPIENT_DELIMITER, die zum Expandieren der Platzhalter und zum Beschränken der Bestätigungsanfragen auf lokale Empfänger verwendet werden, und RECORD_LIST_CONFIRMATIONS (Standardwert no) / LIST_CONFIRMATION_DAYS (Standardwert 7). Siehe pepsi-stage-check-whitelist(1).

50.4. State

  • Eingaben: state.auth.dkim / state.auth.arc / state.auth.dmarc (für dkim_required-Datensätze), state.auth.dmarc / state.auth.arc_override (für dmarc_required-Datensätze), state.auth.arc_sealers (für sealer_domain-Datensätze) und state.signature_verified (für signature_required-Datensätze; geschrieben von pepsi-stage-decrypt). Der From:-Header stammt aus der from_header-Spalte; List-Id: wird aus dem Header-Block gelesen, weshalb diese Stage die Header lädt (aber nie den Nachrichtentext).

  • Ausgaben: bei einem Treffer spam: false, in state eingemischt; andernfalls bleibt state unverändert. Nebeneffekte: Das last_seen eines getroffenen gelernten Listendatensatzes wird aufgefrischt, und mit RECORD_LIST_CONFIRMATIONS wird eine Bestätigungsanfrage in pepsi.list_confirmation geschrieben.

50.5. Siehe auch

pepsi-stage-anti-spam, pepsi-stage-arc, Unterstützte Funktionen, pepsi-stage-check-whitelist(1). Sicherheit: die gefälschte Mail, die eine Whitelist nicht zulassen darf (Ein entfernter Absender), die Grenze für von Benutzern geschriebene Muster (Verfügbarkeit), warum die Stage nicht in EDITABLE_STAGES aufgeführt werden sollte, wenn das Filtern verpflichtend ist (Adressbezogene Einstellungen sind eine Vertrauensgrenze), und wer die Tabelle schreiben darf (Die Privilegientrennung).