85. pepsi-stage-list-bounce¶
Ordnet einen eingehenden Bounce dem betroffenen Abonnement zu und bewertet ihn.
85.1. Aufgabe¶
pepsi-stage-list-bounce verbraucht Bounces. Kommt ein Zustellfehler an die -bounces-Adresse einer Liste zurück, ordnet die Stage ihn dem betroffenen Mitglied zu und bewertet ihn. Sobald der Punktestand die Schwelle der Liste überschreitet, wird die Zustellung für dieses Mitglied abgeschaltet, das Mitglied gewarnt und schließlich abgemeldet. Referenz: pepsi-stage-list-bounce(1).
Warnung
Drei Dinge in diesem Baum heißen „Bounce“ und sind nicht dasselbe. Dieses hier liest einen eingehenden Fehlerbericht. pepsi-stage-bounce erzeugt eine Zustellungsstatusbenachrichtigung für eine Nachricht, die Pepsi selbst nicht zustellen konnte. pepsi-failure-bouncer rettet Nachrichten, an denen die Pipeline gescheitert ist, und übergibt sie diesem Erzeuger. Eine Konfiguration, die das NEXT_STAGE dieser Stage auf den Erzeuger richtet, beantwortet einen Bounce mit einem Bounce, und pepsi-setup verweigert sie.
Dieses Subsystem ist eine Neuimplementierung von GNU Mailman 3; siehe Mailinglisten, wo benannt ist, was von upstream übernommen wurde.
85.2. Zuordnung¶
Die Zuordnung geht in vier Schritten vor, mit abnehmender Sicherheit. Die ersten beiden sind exakt, weil Pepsi die Adresse geschrieben hat, die sie lesen.
Der VERP-Umschlag. Jede Kopie, die eine Liste versendet, trägt den Umschlagabsender
<list>-bounces+<local>=<domain>=<code>@<host>; ein Bounce davon benennt das Mitglied daher eindeutig. Der Teil<list>-bouncesmuss zum eigenen Bounces-Postfach dieser Liste passen, und der Code muss sich verifizieren lassen, bevor der Adresse geglaubt wird. Der Code besteht aus acht Base32-Zeichen eines mit[pepsi-list] VERP_SECRETverschlüsselten HMAC über das Postfach, den Host und das Mitglied. Ohne die erste Prüfung könnte jeder einen Bounce gegen ein Mitglied einer Liste anrechnen lassen, auf der er nicht ist; ohne die zweite könnte jeder, der eine Liste und ein Mitglied kennt, die Adresse schreiben und mit fünf Tagen gefälschter Berichte dieses Mitglied abschalten lassen. Eine mitgliedsförmige Adresse, deren Code fehlt oder falsch ist, wird unbewertet verworfen (protokolliert, alslist-bounce-verp-rejectedgezählt) und auch nicht weitergeleitet. Auch ein VERP-Treffer muss noch wie ein Fehler aussehen: Ein vorübergehender Fehler wird unbeachtet gelassen, und eine VERP-Nachricht ohne jeden erkannten Fehler wird weitergeleitet und nicht bewertet, denn sie kann eine Abwesenheitsantwort oder der Bericht eines Virenscanners sein, der hier nur deshalb ankam, weil das auf dem Umschlag stand.Ein Proben-Token (
<list>-bounces+<token>@<host>), wennBOUNCE_PROBESeingeschaltet ist.Die heuristischen Erkenner, über die ganze Nachricht.
Nichts ließ sich klären: Der Bounce wird verpackt und an einen Menschen weitergeleitet.
85.3. Bewertung¶
Die Logik ist die von GNU Mailman 3, Schritt für Schritt nachgebildet, weil jedes Attribut, das sie liest, über die REST-API sichtbar ist und die Dokumentation einer Site erklärt, was jedes davon tut: Eine Liste, deren process_bounces aus ist, verwirft jeden Bounce ungelesen; eine fehlende Liste oder ein Nichtmitglied wird verworfen; ein Proben-Bounce schaltet das Mitglied sofort und ohne Bewertung ab, denn ein Proben-Bounce ist entscheidend; bei einem Mitglied, das bereits wegen Bounces abgeschaltet ist, handelt es sich um einen Nachläufer, der verworfen wird; ein zweiter Bounce für dasselbe Mitglied am selben Kalendertag (UTC) aktualisiert nur den Zeitstempel; ein erster Bounce oder einer, der älter als bounce_info_stale_after ist, setzt den Punktestand auf 1 zurück, und jeder andere Bounce erhöht ihn; die Verwalter werden benachrichtigt, wenn bounce_notify_owner_on_bounce_increment gesetzt ist; und bei Erreichen oder Überschreiten von bounce_score_threshold wird eine Probe gesendet, falls Proben eingeschaltet sind (was den Punktestand auf null setzt), andernfalls wird der Punktestand genullt und die Zustellung abgeschaltet.
Die Regel „höchstens eine Erhöhung pro Tag“ ist der Grund, weshalb ein Bounce-Sturm eine Liste nicht an einem Nachmittag leerräumen kann: ein Mitglied braucht bei der voreingestellten Schwelle 5 Fehler an fünf verschiedenen Tagen.
85.4. Warnung und Entfernung¶
Ein Mitglied abzuschalten ist nicht dasselbe, wie es abzumelden. Zwei periodische Durchläufe, die pepsi-list tasks --once von einem systemd-Timer ausführt (siehe pepsi-list), schließen den Vorgang ab: ein wegen Bounces abgeschaltetes Mitglied, das weniger als bounce_you_are_disabled_warnings Warnungen erhalten hat und dessen letzte Warnung mindestens bounce_you_are_disabled_warnings_interval zurückliegt, erhält eine; und sobald die Warnungen aufgebraucht sind und das Intervall erneut verstrichen ist, wird das Mitglied abgemeldet und die Verwalter werden benachrichtigt, wenn bounce_notify_owner_on_removal gesetzt ist. Ein Mitglied, das sich selbst abgeschaltet hat oder von einem Moderator abgeschaltet wurde, rührt keiner der beiden Durchläufe an.
bounce_you_are_disabled_warnings auf null zu setzen entfernt ein abgeschaltetes Mitglied beim nächsten Durchlauf ohne jede Warnmail. Das ist das dokumentierte Verhalten von upstream, und es ist beabsichtigt und kein Randfall.
Die Benachrichtigungen dieser Durchläufe werden bei [pepsi-list] NOTICE_STAGE eingespeist, weil die Durchläufe von einem Timer und nicht von einer Stage aus laufen. pepsi-setup verweigert eine Konfiguration, die diese Stage ohne sie betreibt: ohne Stage zum Einspeisen würde ein Mitglied dreimal in der Datenbank gewarnt und kein einziges Mal per Post.
85.5. Proben¶
Mit [pepsi-list] BOUNCE_PROBES = yes erhält ein Mitglied, das die Schwelle überschreitet, eine Probe, statt abgeschaltet zu werden: eine Nachricht allein an dieses Mitglied, von einem Umschlagabsender mit einem Einmal-Token, mit dem auslösenden Bounce als Anhang. Solange die Probe aussteht, steht sein Punktestand auf null. Kommt die Probe als Bounce zurück, benennt das Token das Mitglied genau und die Zustellung wird sofort abgeschaltet; kommt sie nicht zurück, geschieht nichts und das Mitglied erhält weiter Post.
Proben sind standardmäßig eingeschaltet (die von Upstream sind aus): Das Token der Probe ist das Einzige an einem Bounce, das niemand fälschen kann, daher ist es die letzte Prüfung, bevor ein Mitglied aufgrund von Berichten abgeschaltet wird, die jemand anderes gesendet hat. Der Handel lautet: eine weitere Nachricht an eine Adresse, die vermutlich tot ist, gegen das Nicht-Abschalten eines Mitglieds, dessen Anbieter einen schlechten Nachmittag hatte; BOUNCE_PROBES = no stellt das Verhalten von Upstream wieder her. Ein Proben-Token gilt zehn Tage und trägt keinen Precedence: bulk-Header. Eine Probe existiert, um zurückzukommen, und dieser Header lädt manche Systeme dazu ein, sie nicht zurückzuschicken.
85.6. Unerkannte Bounces¶
Ein Bounce, den nichts erkannt hat, wird in eine erklärende Benachrichtigung verpackt, mit dem Original wörtlich als message/rfc822 beigefügt, und an den gesendet, den forward_unrecognized_bounces_to der Liste benennt: administrators (der Standard), site_owner oder discard.
Das ist eine Funktion und kein Rückfall. Jeder Bounce, der durchfällt, hat ein Format, das der Korpus nicht hat, und wer ihn erhält, kann das Beispiel an die Pepsi-Betreuer senden, damit der Erkenner geschrieben werden kann. Unter jeder Einstellung, discard eingeschlossen, wird das Durchfallen in pepsi.event_log als list.bounce.unrecognized gezählt, denn seine Häufigkeit zeigt, ob ein Server überhaupt mehr Erkenner braucht.
85.7. Erkannte Bounce-Formate¶
Es gibt siebzehn Erkenner, die in fester Reihenfolge versucht werden; der erste Treffer gewinnt. Sie sind aus flufl.bounce (Apache-2.0, Copyright Barry Warsaw) portiert, und jeder ist gegen die Testdaten dieser Bibliothek geprüft: dsn, exim, sina, yahoo, yale, smtp32, postfix, qmail, groupwise, microsoft, caiwireless, exchange, netscape, aol, simplematch, simplewarning, llnl.
Genau einer davon, dsn (RFC 3464), ist ein Standard; die übrigen benennen einen Hersteller oder einen Betrieb. In der Praxis zählen sie hier weit weniger als bei upstream, denn Pepsi VERPt jede Kopie jeder Listennachricht; ein Bounce einer von Pepsi gesendeten Nachricht wird daher über den Umschlag zugeordnet, ohne dass davon irgendetwas herangezogen wird. Die Erkenner lesen einen Bounce, der auf anderem Weg zu einer Liste kam.
Eine Nachricht, die kein Erkenner erkennt, ist für diese Stage kein Bounce und wird weitergeleitet statt erraten. Diese Unterscheidung lohnt sich beim Lesen eines Protokolls: „Pepsi hat das nicht erkannt“ und „Pepsi hat entschieden, dass das kein Fehler war“ sind verschiedene Sätze.
85.8. Konfiguration¶
[stage-<name>]: PROGRAM = pepsi-stage-list-bounce, NEXT_STAGE (wohin ein weitergeleiteter Nicht-Bounce geht; nicht der Erzeuger von Zustellungsstatusbenachrichtigungen) und RESPONSE_STAGE, beide erforderlich. [pepsi-list] liefert VERP_SECRET (erforderlich; ohne es verweigert die Stage den Start), NOTICE_STAGE, BOUNCE_PROBES (Standard an) und BOUNCE_EVENT_RETENTION; die listenbezogenen bounce_*-Attribute liegen in der Datenbank. Siehe pepsi-list und Mailinglisten.
85.9. State¶
Eingaben:
state.list.id, geschrieben von pepsi-stage-list, und der Umschlag-rcpt_to(danach die HeaderTo,Delivered-To,Envelope-ToundApparently-To). Das VERP-Detail oder Proben-Token wird aus der Adresse selbst dekodiert und nur geglaubt, wenn ihr<list>-bounces-Teil der dieser Liste ist und, bei einem Mitglieds-Detail, ihr Authentifizierungscode sich verifizieren lässt.Ausgaben: Bounce-Ereignisse und der Zustellstatus des Mitglieds in der Datenbank; Benachrichtigungen und Proben, als neue Nachrichten eingespeist.
Übergänge: immer abschließen. Ein Bounce, der bewertet, ignoriert oder verworfen wird, ist verbraucht; einer, der an einen Menschen weitergeleitet wird, ebenfalls, denn die Weiterleitung ist eine neue, bei
NEXT_STAGEinjizierte Benachrichtigung.
85.10. Siehe auch¶
Mailinglisten, pepsi-stage-list, pepsi-stage-bounce, pepsi-failure-bouncer, pepsi-list, pepsi-stage-list-bounce(1).