84. pepsi-stage-list-command¶
Abonnieren, abmelden und bestätigen per E-Mail; Weiterleitung von `-owner`-Post.
84.1. Aufgabe¶
pepsi-stage-list-command behandelt alles, was eine Mailingliste per Post tut, außer einer Listennachricht: die sieben E-Mail-Befehle, beide Abonnementabläufe und die -owner-Weiterleitung. Referenz: pepsi-stage-list-command(1).
Ein Satz bestimmt die ganze Stage:
Der einzige Weg, auf dem eine Adresse hinzugefügt wird, ohne dass diese Adresse belegt hat, dass sie dort sein will, ist ein ausdrückliches pre_verified und pre_confirmed von einem authentifizierten REST-Client oder von der Kommandozeile.
Nichts in dieser Stage kann eines der beiden Flags setzen. Eine Nachricht ist kein authentifizierter Client, ein join bittet daher stets die genannte Adresse um Bestätigung oder verweigert.
Dieses Subsystem ist eine Neuimplementierung von GNU Mailman 3; siehe Mailinglisten, wo benannt ist, was von upstream übernommen wurde.
84.2. Adressen¶
Es gibt sieben Adressen, und die ersten fünf werden überhaupt nicht geparst: -join/-subscribe werden zu einem synthetischen join (Betreff und Nachrichtentext werden nie gelesen, und es wird keine Ergebnismail gesendet), -leave/-unsubscribe ebenso zu einem synthetischen leave, und -confirm+<token> wird zu einem synthetischen confirm, dessen Token aus der Adresse und niemals aus der Nachricht stammt. -request ist die eine, deren Betreff und Nachrichtentext geparst werden. -owner ist überhaupt kein Befehl: Post daran wird an alle Verwalter und Moderatoren weitergeleitet und erreicht den Parser nie. Das ist das Verhalten von upstream, und es kommt darauf an, denn eine Nachricht an die Verwalter, deren Betreff zufällig unsubscribe lautet, muss einen Menschen erreichen und darf keinen Befehl ausführen.
84.3. Befehle¶
confirm, echo, end (Alias stop), help, join (Alias subscribe), leave (Alias unsubscribe) und who. Drei davon tragen eine Sicherheitsentscheidung und keine Formatierungsfrage.
``confirm`` beendet die Verarbeitung immer, sodass ein Token, das ein zitierendes Mailprogramm weiter unten in derselben Nachricht wiederholt, nie ein zweites Mal ausgeführt wird. Ein Token, das nicht passt, erhält dieselbe Antwort wie ein abgelaufenes, denn eine Antwort, die beide unterscheidet, würde verraten, welche Token es gibt.
``leave`` nimmt überhaupt keine Argumente.
join address=kostet die genannte Adresse eine Bestätigungsnachricht und meldet niemanden an; ein entsprechendesleave address=würde es einem gefälschtenFrom:erlauben, einen Fremden kurzerhand abzumelden. Die eigene Adresse des Absenders muss zusätzlich verifiziert sein. „Der Absender“ ist die erste Adresse inFrom:, mit Rückfall auf den Umschlagabsender nur, wennFrom:keine nennt, und es ist durchgehend eine Adresse: Diejenige, deren Verifizierung geprüft wird, ist diejenige, die entfernt wird (und diejenige, die ein bloßesjoinanmeldet), nie ein davon abweichender Umschlagabsender.``who`` hängt an
member_roster_visibility, und eine unbefugte Anfrage wird verweigert und nicht mit einer leeren Liste beantwortet. Eine leere Antwort ist von einer Liste ohne Mitglieder nicht zu unterscheiden, und das würde einem Adresssammler sagen, dass die Adresse einen weiteren Versuch wert ist.
Wer an diese Adressen schreibt, ist ein entfernter Absender, und ein gefälschtes From: kostet nichts. Beteiligte und wie weit jedem vertraut wird behandelt Listenmitglieder, Besitzer und Moderatoren jenseits ihrer eigenen Listen als feindlich, und diese drei Regeln halten eine Befehlsnachricht innerhalb dieser Grenze.
84.4. Parsen¶
Die Stage bildet die Kulanzregeln von upstream nach, weil es zwanzig Jahre Anleitungen der Form „senden Sie das Wort HELP an …“ gibt. Ein Adressbefehl gewinnt unbedingt. Der Subject: ist die erste Befehlszeile, nach RFC 2047 dekodiert und dann auf ASCII gezwungen. Der Nachrichtentext trägt nur den ersten ``text/plain``-Teil bei und davon nur die ersten MAX_COMMAND_LINES Zeilen. Eine Nachricht ohne Klartextteil trägt nichts bei, denn Befehle aus HTML auszuführen ist eine Stelle, an der Hilfsbereitschaft eine Sicherheitsentscheidung ist. Es gibt überhaupt keine Behandlung von Zitaten, Signaturen oder --; jedes Token wird kleingeschrieben; leere Zeilen werden übersprungen. Ein unbekanntes erstes Wort wird nach dem Weglassen von genau einem Wort erneut versucht, und das ist der ganze Re:-Mechanismus und absichtlich kein allgemeiner Präfixentferner (Fwd: help me würde sonst help ausführen). Ein Befehl, der beendet, schließt den Durchlauf ab, und der Rest wird als unverarbeitet gemeldet. Vor alldem wird eine Nachricht mit Precedence: bulk|junk|list ohne X-Ack: yes stillschweigend verworfen.
Zwei davon sehen wie Fehler aus und sind keine: Der erneute Versuch lässt ein Wort weg und nicht mehr, und die Obergrenze zählt Zeilen und nicht Befehle. Eine Nachricht aus elf leeren Zeilen, gefolgt von help, führt also nichts aus und meldet das help als übergangen. MAX_COMMAND_LINES zu erhöhen ist die Lösung für „mein Mailprogramm hat einen Headerblock vor meinen Befehl gesetzt“ und nicht Zitaterkennung.
84.5. Die Antwort¶
Die Stage antwortet mit einer Ergebnismail in der Gestalt von upstream: eine Vorrede, die Angaben zur ursprünglichen Nachricht, die Ergebnisse, die unverarbeiteten und übergangenen Zeilen und „- Done.“
Die ursprüngliche Nachricht wird nie beigefügt. Das From: einer Befehlsnachricht ist fälschbar, eine Ergebnismail geht also an eine Adresse, die möglicherweise nichts gesendet hat; das Original beizufügen würde diese Stage zu einem Backscatter-Verstärker machen. Für einen Absender, der weder SPF noch DMARC bestanden hat, zitieren die Ergebnisse auch nichts, was der Absender geschrieben hat: keine Details des Originals, Zählungen statt der unverarbeiteten und ignorierten Zeilen und kein echo seiner Argumente (Benachrichtigungsabläufe von Anbietern senden vom Angreifer kontrollierte Mail).
84.6. Bestätigungstoken¶
Ein Token sind 256 Bit Zufall in Base32. Es ist gleichzeitig die Subadresse -confirm+<token> und das letzte Pfadsegment der Bestätigungs-URL; wer eines errät, kann also das Abonnement eines anderen abschließen.
Seine Lebensdauer richtet sich danach, auf wen gewartet wird: ein Token, das einem Moderator gehört, lebt 180 Tage, alles andere drei. Ein Moderator kann im Urlaub sein, und eine Abonnementanfrage, die nach drei Tagen verfällt, wäre stillschweigend verloren statt entschieden. Abgelaufene Token räumt pepsi-list tasks --once weg, was ein systemd-Timer ausführt; siehe pepsi-list. Wird ein Token gelöscht, geht der zugehörige Ablaufzustand mit verloren, sodass eine wiederholte Bestätigung nichts mehr findet.
84.7. Konfiguration¶
[stage-<name>]: PROGRAM = pepsi-stage-list-command, RESPONSE_STAGE (erforderlich: das Signaturende und nicht die Listenzustellstage, die nur die Kopie eines Mitglieds aus dem Fan-out annimmt und eine Benachrichtigung verlieren würde), NEXT_STAGE (erforderlich: wohin -owner-Post nach der Umadressierung geht; nie der Listenrouter), MAX_COMMAND_LINES (Standardwert 10; 0 wird abgelehnt) und REQUIRE_AUTHENTICATED (Standard aus; wenn eingeschaltet, gehen die Ergebnismail und die Autoresponder-Benachrichtigungen nur an einen Absender, der SPF oder DMARC bestanden hat). Das optionale BOUNCE_STAGE ist der Ort, an dem eine Nachricht für eine zwischenzeitlich gelöschte Liste in eine DSN verwandelt wird; ohne es wird eine solche Nachricht als fehlgeschlagen markiert. pepsi-setup prüft beide Ziele sowie, dass die englische Fassung jeder der 28 Vorlagen für Listenbenachrichtigungen installiert ist, da jede Sprache auf sie zurückfällt.
84.8. State¶
Eingaben:
state.list, geschrieben von pepsi-stage-list: die Listen-ID, die von der Adresse benannte Rolle und ein etwaiges-confirm-Token.Ausgaben: eingespeiste Antwort- und Benachrichtigungsnachrichten; die Befehlsnachricht selbst wird verbraucht.
Übergänge: Abschließen (eine Befehlsnachricht wird beantwortet, nicht weitergeleitet) oder Weiterschalten für die
-owner-Weiterleitung.
84.9. Siehe auch¶
Mailinglisten, pepsi-stage-list, pepsi-stage-list-post, pepsi-list, pepsi-stage-list-command(1).