56. pepsi-stage-block-language¶
Eine Nachricht anhand der in ihrem Nachrichtentext erkannten menschlichen Sprache(n) routen.
56.1. Rolle¶
pepsi-stage-block-language ist ein Sprachrichtlinien-Filter. Er bewertet die unter state.language festgehaltene(n) Sprache(n) (vorgelagert von pepsi-stage-detect-language geschrieben) gegen eine konfigurierte weiße und schwarze Liste und routet die Nachricht: Oberhalb der Bewertungsschwelle THRESHOLD wird sie zu NEXT_STAGE weitergeschaltet, andernfalls entscheidet ENFORCEMENT. hard (der Standardwert) leitet sie mit einem Failure-DSN-state zu BOUNCE_STAGE um, und soft stellt sie dennoch zu, mit markiertem Subject:. Der Nachrichtentext wird nie geladen (der Header-Block schon, weil der weiche Modus einen Header umschreibt), und die Stage pausiert nie. Referenz: pepsi-stage-block-language(1).
56.2. Bewertung¶
state.language ist eine Zeichenkette im HTTP-Accept-Language-Stil aus code;q=quality-Elementen, wobei jede quality die Erkennungswahrscheinlichkeit dieser Sprache ist. Die Stage fasst sie zu einer einzigen Zahl zusammen:
score = Σ q over languages listed in WHITELIST
− Σ q over languages listed in BLACKLIST
Sprachen auf keiner der beiden Listen tragen nichts bei. Mit Englisch auf der weißen und Französisch auf der schwarzen Liste ergibt en;q=0.7, fr;q=0.3 die Bewertung 0.7 − 0.3 = 0.4. Eine Nachricht, deren Bewertung strikt größer als THRESHOLD ist, schaltet weiter; andernfalls wird sie blockiert.
Nicht erkannte Mail. Wurde keine Sprache erkannt (
state.languagefehlt), wird die Bewertung gegen die Pseudo-Verteilungnone;q=1berechnet.noneselbst darf inWHITELIST/BLACKLISTstehen, sodass der Betreiber über das Schicksal nicht erkannter Mail entscheidet (noneauf die schwarze Liste zu setzen bewertet sie mit−1, auf die weiße mit+1, sie nirgends aufzuführen belässt sie bei0).Umgehung über die weiße Liste. Eine Nachricht, die ein ausdrückliches Urteil
state.spam = falseträgt, überspringt die Sprachrichtlinie vollständig und schaltet zuNEXT_STAGEweiter. Das Urteil stammt von einem vorgelagerten Treffer in pepsi-stage-check-whitelist oder von Ingress für das reservierte Postfach<Postmaster>(RFC 5321 §4.5.1).Für einen Bounce nie einen Bounce erzeugen. Eine Nachricht, die bereits ein Bounce ist (der Null-Umschlagabsender), schaltet unabhängig von ihrer Bewertung zu
NEXT_STAGEweiter (RFC 5321 §6.1).
56.3. Harte und weiche Durchsetzung¶
ENFORCEMENT entscheidet, was mit einer Nachricht geschieht, die an der Richtlinie scheitert, und beide Modi wählen genau dieselbe Menge von Nachrichten aus. Darum geht es: Die Markierung sagt den Bounce voraus, sodass ein Betreiber WHITELIST/BLACKLIST/THRESHOLD an echtem Verkehr abstimmen kann, bevor überhaupt Mail abgewiesen wird.
hard(der Standard) leitet mit einemstatefür eine dauerhafte Failure-DSN zuBOUNCE_STAGEum, sodass pepsi-stage-bounce nur dann einen Bounce ausgibt, wenn dasNOTIFYdes AbsendersFAILUREanfordert (der Standard, wenn es fehlt). Kein Header wird angefasst. Eine Nachricht, deren Inhalt aus einem S/MIME-EnvelopedDatastammt oder sich daraus nicht öffnen ließ (AES-CBC, kein Integritätsschutz), wird stattdessen markiert und wie untersoftweitergeschaltet: Die erkannte Sprache hängt davon ab, ob sich ein verändertes CBC-Chiffrat öffnen ließ, und ein Bounce würde es ihrem Absender verraten (CBC-Padding- und Format-Orakel gegen nicht authentifiziertes S/MIME).softschaltet die Nachricht stattdessen zuNEXT_STAGEweiter, hängtSUBJECT_FLAG_LABEL(Standardwert[!LANG]) an ihrSubject:an und fügt einenX-Pepsi-Detected-Languages-Header hinzu. Jede bereits an der Nachricht vorhandene Kopie dieses Headers wird zuvor entfernt, sodass ein Absender keine auf einem Pfad unterbringen kann, der pepsi-stage-decrypt nicht durchläuft (das den ganzenX-Pepsi-*-Namensraum von eingehender Mail abstreift; siehe Was ein Sicherheitsindikator bedeutet). Nichts wird gebounct, also wird keinBOUNCE_STAGEbenötigt.
Weil ENFORCEMENT die Stage über die Einstellungsschicht je Adresse erreicht, kann ein einzelnes Konto im Training sein, während der Rest der Installation durchsetzt. Das Subject: umzuschreiben bricht die DKIM-Signatur des Urhebers und unser eigenes ARC-AMS, die es beide mitsignieren. Auf einem Zweig, der in der lokalen Zustellung endet, kostet das nichts, auf einem, der weiterleitet, schon; der weiche Modus gehört daher auf den ersteren.
56.4. Fusion¶
Die Stage hat den Standardwert FUSION = yes: Unter dem vereinheitlichten pepsi-Binärprogramm mit eingeschaltetem [pepsi] ALLOW_FUSION (dem Standardwert) darf ein Vorgänger sie in seinem eigenen Worker-Prozess ausführen, statt sie separat zu dispatchen. Siehe pepsi-dispatch.
56.5. Konfiguration¶
[stage-<name>]: PROGRAM = pepsi-stage-block-language, NEXT_STAGE (erforderlich — jede Nachricht, die die Stage nicht blockiert, schaltet dorthin weiter, einschließlich eines Absenders auf der weißen Liste, eines Bounces und jeder Nachricht, die unter ``ENFORCEMENT = soft`` lediglich markiert wurde), BOUNCE_STAGE, die Sprachlisten WHITELIST/BLACKLIST (mindestens eine muss nicht leer sein, sonst würde jede Nachricht scheitern), der numerische THRESHOLD (Standardwert 0.0), ENFORCEMENT (hard, der Standardwert, oder soft) und SUBJECT_FLAG_LABEL (Standardwert [!LANG], nur im weichen Modus verwendet). pepsi-setup lehnt einen ungültigen Sprachcode oder eine Überlappung zwischen den beiden Listen ab, lehnt ENFORCEMENT = hard ohne BOUNCE_STAGE ab (auch der Worker verweigert dann den Start, da jede blockierte Nachricht scheitern würde) und warnt vor einer BLACKLIST mit leerer WHITELIST und nicht negativem THRESHOLD. Siehe pepsi-stage-block-language(1) und Konfiguration.
56.6. State¶
Eingaben:
state.language(fehlt es, wird es alsnone;q=1behandelt) und, für eine blockierte Nachricht,state.dsnund der Umschlagempfänger.Ausgaben: Auf dem Durchlasspfad bleibt
stateunberührt; auf dem harten Blockierpfad werden die Failure-DSN-Schlüssel zusammengeführt, die pepsi-stage-bounce verbraucht (state.bounce); auf dem weichen Pfad bleibtstateunberührt, und stattdessen wird der Header-Block umgeschrieben.Übergänge: Bewertung über
THRESHOLD→ weiterschalten zuNEXT_STAGE; Bewertung darauf oder darunter → umleiten zuBOUNCE_STAGE(hard) oder markiert weiterschalten zuNEXT_STAGE(soft, sowiehardbei Inhalt aus einem Chiffrat ohne Integritätsschutz).
56.7. Siehe auch¶
pepsi-stage-detect-language, pepsi-stage-check-whitelist, pepsi-stage-bounce, Unterstützte Funktionen, pepsi-stage-block-language(1).