83. pepsi-stage-list-deliver¶
Macht aus der Kopie einer Listennachricht die eigene Kopie eines Mitglieds.
83.1. Aufgabe¶
pepsi-stage-list-post hat bereits einen Datensatz pro Empfänger erzeugt; pepsi-stage-list-deliver ist das, was aus jedem davon die Kopie dieses Mitglieds macht und nicht bloß eine weitere Kopie derselben Nachricht. Ein Datensatz hinein, ein Datensatz hinaus. Die Stage vervollständigt List-Unsubscribe mit der Ein-Klick-https:-URI dieses Mitglieds neben der mailto:-Form und ergänzt List-Unsubscribe-Post: List-Unsubscribe=One-Click (RFC 8058). Wenn personalize der Liste individual oder full ist, versieht sie die Nachricht mit Kopf- und Fußzeile der Liste in der Sprache des Mitglieds. Nur bei full schreibt sie außerdem To: auf das Mitglied um: upstreams personalize_to tut bei individual nichts, und diese Stage ebenso wenig. Referenz: pepsi-stage-list-deliver(1).
Dieses Subsystem ist eine Neuimplementierung von GNU Mailman 3; siehe Mailinglisten, wo benannt ist, was von upstream übernommen wurde.
Warnung
Diese Stage muss vor dem Signieren laufen. Jeder Header, den sie anfasst, gehört in die DKIM-h=-Liste, und List-Unsubscribe ist genau der Header, den ein Mailbox-Anbieter prüft, wenn er entscheidet, ob er eine Abmelden-Schaltfläche anzeigt. Eine Pipeline, die zuerst signiert, erzeugt Post, die signiert und danach verändert wurde – und die überall an DKIM scheitert. NEXT_STAGE zeigt daher auf pepsi-stage-dkim-sign und nicht auf ein Relay, und pepsi-setup verweigert die umgekehrte Reihenfolge. Upstream sagt dasselbe in dem Kommentar, mit dem arc-sign aus der eigenen Pipeline entfernt wird.
83.2. Ein-Klick-Abmeldung¶
Das Token in der https:-URI ist ein geschlüsselter Hash über die Liste, die Adresse des Mitglieds und eine Seriennummer, die das Mitglied wechseln kann. Es wird nicht gespeichert: eine List-Unsubscribe-URI entsteht einmal pro Mitglied pro Nachricht, eine Tabelle davon würde also mit den Zustellungen und nicht mit den Mitgliedern wachsen. Daraus folgt Dreierlei.
Das Token reist nie zwischen Stages: Diese Stage hält das Geheimnis und berechnet das Token für jede Kopie.
Jede jemals für ein Abonnement ausgegebene URI zu widerrufen ist ein Erhöhen der
unsubscribe_serialdieses Mitglieds: eine Zähleränderung und kein Tabellendurchlauf.Es gibt nichts abzulaufen, denn ein Abonnement, das nicht mehr besteht, scheitert an der Mitgliedschaftsabfrage, was auch immer das Token sagt.
Das Geheimnis ist [pepsi-list] UNSUBSCRIBE_SECRET. Ohne Geheimnis oder ohne BASE_URL, aus der sich eine URI bauen ließe, steht die mailto:-Form allein da, wie bei upstream: eine nicht überprüfbare URI ist schlechter als keine. Das Geheimnis zu wechseln macht jede URI ungültig, die schon in jedem Postfach eines Abonnenten liegt.
83.3. Ausschmückung¶
Kopf- und Fußzeile sind die list:member:regular:header und list:member:regular:footer von Upstream: Eine list_template-Überschreibung für die Liste, ihre Domain oder den Standort gewinnt, und andernfalls wird das mitgelieferte list-member-regular-{header,footer}.<lang>.body in [pepsi] TEMPLATE_DIR verwendet, zuerst in der Sprache des Mitglieds und mit en als Rückfall. Die mitgelieferte Kopfzeile ist leer, und die mitgelieferte Fußzeile ist der „To unsubscribe …“-Anhang von Upstream; eine Überschreibung mit leerer URI bedeutet keine. Eine Digest-Ausgabe wird nie ausgeschmückt, da sie ihre eigene Kopf- und Fußzeile trägt.
Die Fußzeile wird an den ersten ``text/plain``-Teil außerhalb jedes multipart/signed- oder multipart/encrypted-Containers angehängt und an nichts anderes. Ein Anhängen innerhalb eines signierten Teils bricht die Signatur, ein Anhängen an ein PDF beschädigt es, daher wird eine Nachricht ohne einen solchen Teil unausgeschmückt zugestellt statt verstümmelt. Eine Kopie, deren Nachrichtentext sich nicht geändert hat (etwa nur die Abmelde-Header), teilt sich weiterhin den einen Nachrichtentext, den das Auffächern gespeichert hat.
avoid-duplicates markiert eine Kopie, wenn das Mitglied schon im To oder Cc der Nachricht selbst stand und seine Listenkopie dennoch behalten hat. Eine solche Kopie erhält X-Pepsi-List-Copy: yes, damit der Leser sieht, warum er zwei hat.
83.4. Zwei Invarianten¶
Geschwisterdatensätze beginnen hier und nie am Kopf der Pipeline. Ein Wiedereintritt bei init würde die ARC-Prüfung erneut ausführen und wieder in den Router führen, was bei einer Dachliste kombinatorisch explodiert.
Die persönlichen Einstellungen eines Mitglieds konfigurieren die Listenzustellung nicht um. Pepsi legt Überschreibungen aus pepsi.settings je Adresse automatisch darüber (siehe Konfiguration), und der einzige Empfänger eines Geschwisterdatensatzes ist ein Mitglied. Dessen Abwesenheits- oder Sprachüberschreibung hat an den Zielen dieser Stage nichts zu ändern: Ein daraus übernommenes NEXT_STAGE könnte die Kopie an der Signierung vorbeileiten. Daher werden NEXT_STAGE, die [pepsi-list]-Optionen und das TEMPLATE_DIR aus [pepsi] aus der serverweiten Konfiguration gelesen, die keine domain:- oder address:-Konfigurationsüberschreibung und kein pepsi.settings-Datensatz erreicht, und die Sprache des Mitglieds stammt aus dem Deskriptor, den das Fan-out geschrieben hat. Nichts wird aus der Überlagerung übernommen.
83.5. Konfiguration¶
[stage-<name>]: PROGRAM = pepsi-stage-list-deliver und NEXT_STAGE (erforderlich: das Signaturende; pepsi-setup verweigert ein Relay). Alles Weitere, was die Stage braucht, ist der Mitgliedsdeskriptor aus dem Fan-out und die Attribute der Liste selbst, dazu [pepsi-list] BASE_URL und UNSUBSCRIBE_SECRET aus dem Serverabschnitt.
83.6. State¶
Eingaben:
state.list(die Listen-ID, die Sprache des Mitglieds, seine Abmelde-Seriennummer und das Duplikat-Flag) sowie das einzigercpt_todes Datensatzes, das für die Adresse maßgeblich ist.Ausgaben: ein umgeschriebener Headerblock und Nachrichtentext. Kein
statewird geändert.Übergänge: weiterschalten zu
NEXT_STAGEoder eine Kopie beenden (löschen), deren Liste nach dem Auffächern gelöscht wurde, denn es gibt niemanden mehr, an den berichtet werden könnte.
83.7. Siehe auch¶
Mailinglisten, pepsi-stage-list-post, pepsi-stage-dkim-sign, pepsi-list, pepsi-stage-list-deliver(1).