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.whitelistgruppiert Datensätze unter einemwhitelist_name.WHITELIST_NAMEist 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 konsultiertWHITELIST_NAME = correspondents, {localpart}/correspondentsdie 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_regexist ein erweiterter regulärer POSIX-Ausdruck. Er wird ohne Beachtung der Groß-/Kleinschreibung gegen das Feld abgeglichen, das dasmatch_fielddes 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 demFrom:-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 einFrom:, 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 demList-Id:-Header der Nachricht. Die Beiträge einer Mailingliste tragen beliebigeFrom:-Adressen, daher kann keinfrom-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 dieFrom:-Domain authentifiziert ist:state.auth.dkim = passoder ein ARC-Pass, den DMARC ebenfalls bestätigt (state.auth.arc = passundstate.auth.dmarc = pass). Ein ARC-Pass allein belegt nur die Integrität der Kette (eine Ein-Hop-Kette kann über ein gefälschtesFrom:selbst erzeugt werden) und erfüllt den Datensatz daher nicht für sich genommen. Die Spalte ist standardmäßig wahr, wie beipepsi-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 jederdkim_required-Pass erfüllt sie. Setzt ein Datensatz mehrere Bedingungen, müssen alle erfüllt sein.signature_required→ trifft nur zu, wennstate.signature_verifiedtrueist, was pepsi-stage-decrypt für eine Nachricht setzt, deren Ende-zu-Ende-Signatur gegen einen vertrauenswürdigen Schlüssel verifiziert wurde. Einvalid-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 = passund die Domain instate.auth.arc_sealers). Das ist es, was einenlist-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 bislast_seen + max_idlezu; jeder authentifizierte Beitrag, auf den er zutrifft, schiebtlast_seennach vorn (höchstens täglich), undpepsi-queue gclöscht ihn, sobald er verfällt.Festhalten von Bestätigungsanfragen: Mit
RECORD_LIST_CONFIRMATIONSwird eine Nachricht, die wie die Abonnement-Bestätigungsanfrage einer Liste aussieht (eine einzelneMessage-ID:,confirmimSubject:, ein-request- /-confirm- /-join- /-subscribe-Absender oderReply-To:), je lokalem Empfänger fürLIST_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: falsezusammen und schaltet zuNEXT_STAGEweiter; bei keinem Treffer schaltet es unverändert weiter. Eine Nachricht ohneFrom:-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ürdkim_required-Datensätze),state.auth.dmarc/state.auth.arc_override(fürdmarc_required-Datensätze),state.auth.arc_sealers(fürsealer_domain-Datensätze) undstate.signature_verified(fürsignature_required-Datensätze; geschrieben von pepsi-stage-decrypt). DerFrom:-Header stammt aus derfrom_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, instateeingemischt; andernfalls bleibtstateunverändert. Nebeneffekte: Daslast_seeneines getroffenen gelernten Listendatensatzes wird aufgefrischt, und mitRECORD_LIST_CONFIRMATIONSwird eine Bestätigungsanfrage inpepsi.list_confirmationgeschrieben.
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).