12. SMTP-Protokollerweiterungen¶
Pepsi kündigt in seiner EHLO-Antwort diese standardisierten ESMTP-Diensterweiterungen an (pepsi-ingress; die maßgeblichen Standards stehen in RFC-Index): SIZE (RFC 1870), 8BITMIME (RFC 6152), SMTPUTF8 (RFC 6531), PIPELINING (RFC 2920), CHUNKING (RFC 3030, ohne BINARYMIME), DSN (RFC 3461), ENHANCEDSTATUSCODES (RFC 2034) und RRVS (RFC 7293) immer; STARTTLS (RFC 3207), solange die Sitzung eines starttls-Listeners noch im Klartext läuft; und REQUIRETLS (RFC 8689) sowie AUTH (RFC 4954) erst, wenn die Sitzung durch TLS geschützt ist. Der ausgehende Client beachtet dieselbe Menge beim nächsten Hop: Die Parameter DSN, 8BITMIME, SMTPUTF8, RRVS und REQUIRETLS werden nur an einen Hop gesendet, der sie ankündigt, und andernfalls werden Inhalte oder Anforderungen herabgestuft oder abgelehnt, wie es der jeweilige Standard vorschreibt (Unterstützte Funktionen).
Darüber hinaus definiert Pepsi zwei eigene Nachrichten-Header-Felder:
den
Pepsi-Origin:-Herkunftsnachweis-Header, der auf ausgehende Mail gestempelt wird; undden
Taler:-Zahlungs-Header, der einem Wallet eine Pay-to-Send-Zahlungsaufforderung ankündigt.
Keiner von beiden ist bei der IANA nach RFC 3864 registriert. Beide sind private Erweiterungen, die nur eine Pepsi-Installation (und, für den Zahlungs-Header, ein GNU-Taler-fähiges Wallet) interpretiert, und beide sind optionale Felder im Sinne von RFC 5322 §3.6.8: ein Feldname aus druckbarem US-ASCII, gefolgt von einem unstrukturierten Wert, den jeder konforme MTA unangetastet weiterleitet und jeder konforme Leser ignoriert, wenn er ihn nicht kennt.
Pepsi benennt seine Header-Felder nach ihrem Zweck. Die beiden obigen Protokollfelder wandern zwischen Installationen und tragen kein X--Präfix: RFC 6648 erklärt X- für veraltet, weil ein Feld, das sich durchsetzt, umbenannt werden muss, was jede Implementierung bricht, die es früh übernommen hat.
Die Felder, die eine Nachricht nur für ihren lokalen Empfänger annotieren oder eine Anfrage eines lokalen Mail-Clients tragen, teilen sich den Namensraum X-Pepsi-*, der nie eine andere Installation erreichen soll: X-Pepsi-Crypto, X-Pepsi-Detected-Languages, X-Pepsi-Sign und die übrigen. pepsi-stage-decrypt entfernt diesen gesamten Namensraum von eingehender Mail, ausgenommen das eigene X-Pepsi-Warning von Ingress, und Ingress entfernt ein eingehendes X-Pepsi-Warning, bevor es sein eigenes hinzufügt, sodass kein entfernter Absender ein lokales Urteil fälschen kann (siehe Injektion in Statuszeilen und Ausgabe von GnuPG täuscht Frontends; was jeder Indikator verspricht, steht in Was ein Sicherheitsindikator bedeutet). Dieselbe Regel ist der Grund, warum Pepsi-Origin: außerhalb davon bleiben muss: Ein Herkunftsnachweis in diesem Namensraum würde genau bei dem zurückkehrenden Bounce entfernt, bei dem er gebraucht wird. Die lokalen Felder sind bei der Stage dokumentiert, die sie schreibt oder liest, nicht hier.
12.1. Der Pepsi-Origin:-Herkunftsnachweis-Header¶
Wenn Pepsi eine ausgehende Nachricht nach außerhalb weiterleitet, stempelt es sie mit einem Pepsi-Origin:-Header, der kryptografisch beweist, dass diese Installation die Nachricht erzeugt hat, und festhält, welcher ihrer autorisierten Absender es war. Dadurch kann man einem zurückkehrenden Bounce vertrauen. Eine DSN, die Tage später zurückkommt, trägt die ursprüngliche Nachricht oder eine Kopie davon in ihrem Berichtstext, und damit auch den Pepsi-Origin:-Header. pepsi-stage-anti-spam kann diesen Header deshalb wiedergewinnen und bestätigen, dass der Bounce eine Antwort auf Mail ist, die Pepsi wirklich gesendet hat, und kein Backscatter oder gefälschter Bounce, der auf die Pay-to-Send-Schranke zielt.
12.1.1. Feldsyntax¶
Der Header-Wert ist eine Liste von key=value-Feldern, durch ; getrennt:
Pepsi-Origin: v=1; host=mail.example.org; sender=alice@example.org;
nonce=<base64url>; ts=<epoch-seconds>; mac=<base64url>
Pepsi-Origin: v=1; host=mail.example.org; sender=alice@example.org;
for=bob@example.com; nonce=<base64url>; ts=<epoch-seconds>; mac=<base64url>
Feld |
Bedeutung |
|---|---|
|
Formatversion; ein Verifizierer akzeptiert nur |
|
Der Hostname der erzeugenden Installation ( |
|
Das autorisierte Umschlagabsender-Konto, von dem die Nachricht stammt. |
|
Nur bei Mail, die Pepsi selbst eingespeist hat (siehe unten): die Umschlag-Empfänger der Nachricht, kleingeschrieben, sortiert und durch Kommas getrennt. |
|
Eine zufällige 128-Bit-Nonce, base64url-kodiert (RFC 4648, ohne Padding). |
|
Der Unix-Zeitstempel (Sekunden), zu dem der Header geprägt wurde. |
|
|
Der MAC deckt Version, Hostname, Absenderkonto, Nonce und Zeitstempel ab, wobei jedem Feld seine Big-Endian-u32-Länge vorangestellt und alles aneinandergehängt wird, sodass keine Feldgrenze verschoben werden kann. Ein Header mit for hängt zwei weitere Felder an, das Literal for und die Empfängerliste, sodass das Feld weder einem gewöhnlichen Header hinzugefügt noch aus einem Header, der es hat, entfernt oder darin verändert werden kann. Der Hostname wird sowohl im Klartext mitgeführt als auch in den MAC eingefaltet: Die Klartextkopie lässt einen Verifizierer einen für eine andere Pepsi-Installation geprägten Bounce günstig ablehnen, noch vor jeder Datenbankabfrage, während die Einbindung in den MAC bedeutet, dass ein abgefangener Header nicht gegen eine Schwester-Installation erneut eingespielt werden kann, die zufällig ein Geheimnis teilt. Weil nur Pepsi diese Header jemals erzeugt oder verifiziert, muss das Drahtformat mit nichts interoperieren.
12.1.2. Prägung und Verifikation¶
Stempeln. Welchen ausgehenden Pfad eine Nachricht auch nimmt, die Relay-Stage stellt den Header voran: pepsi-stage-relay-to-internet und pepsi-stage-relay-to-smarthost rufen beide die gemeinsame
pepsi-common::origin-Engine auf und halten die frisch geprägte Nonce in der Tabellepepsi.origin_noncemit einer zweiwöchigen Ablauffrist fest. Ist die Funktion aus, bleibt die Nachricht unverändert. Lässt sich eine Nonce nicht festhalten, versucht die Stage die Nachricht später erneut, statt einen Stempel zu senden, den sie später nicht anerkennen würde.Verifikation. pepsi-stage-anti-spam durchsucht bei einem zurückkehrenden Bounce die gesamte Nachricht (der Header liegt im DSN-Nachrichtentext, nicht im eigenen Header-Block des Bounces), entfaltet etwaige Fortsetzungszeilen und akzeptiert den ersten Header, dessen Version und Hostname passen und dessen MAC unter dem Geheimnis verifiziert. Erst wenn die günstige kryptografische Prüfung besteht, wird die (langsamere)
pepsi.origin_nonce-Abfrage herangezogen; ein Bounce verifiziert nur, wenn seine Nonce noch verfolgt wird. Ein Bounce verifiziert nicht, wenn sein Header fehlt, gefälscht oder abgelaufen ist, und kein Bounce verifiziert, wenn der Herkunftsnachweis nicht konfiguriert ist. Ein solcher Bounce wird zurBOUNCE_TARGET_STAGEder Stage geroutet, sofern eine solche verdrahtet ist (der Assistent verdrahtet die Senkediscard-rejected, sodass ein solcher Bounce verworfen wird; eine Quarantäne-Stage bewahrt ihn zur Prüfung auf), und andernfalls unverändert zuNEXT_STAGEweitergeleitet. Ein echter Bounce wird immer normal weitergeleitet. Ein Bounce wird nie an eine Zahlung gebunden.Mail, die Pepsi selbst eingespeist hat. Die Link- und PIN-Benachrichtigungen des Secure-Link-Portals sind Nachrichten, die die Installation in eigener Sache mit einem menschlichen Umschlag-Absender verfasst. Eine solche Nachricht wird beim Einspeisen mit der
for-Form gestempelt und an ihre Umschlag-Empfänger gebunden, und ihre Nonce wird festgehalten. Kommt eine solche Nachricht über den MX dieser Installation an ein geschütztes Postfach zurück, leitet pepsi-stage-anti-spam sie ohne Zahlungsschranke weiter, wenn ein Header im eigenen Header-Block der Nachricht verifiziert, einforträgt, das jeden Umschlag-Empfänger des Datensatzes nennt, und eine verfolgte Nonce hat. Die gewöhnliche Form, die jeder Empfänger unserer Mail besitzt, befreit nie; diefor-Form können nur ihre Empfänger wiederverwenden, und zwar bei Mail an sich selbst. Der Gegner, auf den dies antwortet, ist der entfernte Absender aus Ein entfernter Absender.
12.1.3. Konfiguration¶
Die Schlüsselverwaltung liegt im gemeinsamen Abschnitt [pepsi-origin] (SECRET / SECRET_FILE, plus das erforderliche [pepsi-ingress] HOSTNAME, das in jeden MAC eingebunden wird). Die Funktion ist standardmäßig aktiv: Wenn kein Geheimnis konfiguriert ist, richtet pepsi-setup beim ersten Lauf ein zufälliges ein. Das Geheimnis muss über die Zeit stabil bleiben (ein Tage später zurückgesendeter Bounce muss weiterhin verifizieren) und über alle Instanzen einer Installation hinweg identisch sein.
Um die Funktion abzuschalten, setzen Sie ENABLED = no in [pepsi-origin]. Ausgehende Mail ist dann ungestempelt, jeder Bounce ist nicht verifizierbar (geroutet gemäß BOUNCE_TARGET_STAGE der Anti-Spam-Stage, andernfalls weitergeleitet), und pepsi-setup erzeugt kein Geheimnis; ein vorhandenes secrets.d/pepsi-origin.secret bleibt bestehen, sodass ein erneutes Einschalten mit demselben Schlüssel fortfährt. Das Entfernen des Abschnitts ist kein Ausschalter: Der nächste pepsi-setup run fände kein Geheimnis und würde ein neues einrichten. Siehe pepsi-stage-anti-spam und pepsi.conf(5).
12.2. Der Taler:-Zahlungs-Header¶
Wenn pepsi-stage-anti-spam eine Nachricht zur Zahlung zurückhält, erzeugt es eine automatische Zahlungsaufforderungs-Antwort an den Absender (Auto-Submitted: auto-replied nach RFC 3834, leerer Umschlagabsender). Diese Antwort trägt die GNU-Taler-Zahlungs-URI
Taler: taler://pay/<backend>/<order-id>/
als Header-Feld und in ihrem Nachrichtentext als anklickbaren Link und eingebetteten cid:-PNG-QR-Code (RFC 2392 für die cid:-Referenz), zusammen mit einem Verweis auf https://wallet.taler.net/ für Absender ohne Wallet. Der Header wird neben der Kopie im Nachrichtentext hinzugefügt, nie an ihrer Stelle, sodass ein menschlicher Leser und ein Nicht-Taler-Client völlig unberührt bleiben.
Der Wert ist genau die URI, die die Stage prägt, mit order_id == token, sodass ein Wallet die Bestellung gegen das Händler-Backend genauso auflöst wie über den Link im Nachrichtentext. taler:// ist kein IANA-registriertes URI-Schema (RFC 7595 legt das Verfahren fest); es ist GNU Talers eigenes, und die Drahtform ist von jenem Projekt dokumentiert, nicht hier.
12.2.1. Warum ein Header und nicht nur der Nachrichtentext¶
Der Header ist es, der die Forderung maschinell erkennbar macht, und Pepsi ist selbst die Maschine, die ihn liest. pepsi-stage-auto-pay ist das sendeseitige Gegenstück und läuft auf dem eingehenden Pfad. Es erkennt eine zurückkehrende Zahlungsforderung an diesem Feld: Es faltet Fortsetzungszeilen auf, akzeptiert mehrere URIs in einem Feld und mehrere ``Taler:``-Felder (eine Nachricht an eine Liste kann mehr als eine Forderung nach sich ziehen) und ignoriert taler://-URIs jeder anderen Art, sodass nur echte Zahlungsforderungen je beglichen werden.
Erkennung allein ist keine Autorisierung. Die Stage bezahlt nur für Mail, die diese Installation nachweislich erzeugt hat. Das stellt sie mit dem oben beschriebenen Pepsi-Origin:-Header fest, den sie aus der zurückgekommenen Nachricht wiedergewinnt und gegen pepsi.origin_nonce prüft. Das Budget wird gegen diese Herkunfts-Nonce gebucht, sodass eine einzelne Ursprungsnachricht nicht zweimal belastet werden kann.
Die Antwort kopiert außerdem den Pepsi-Origin:-Header der ursprünglichen Nachricht wortgetreu, und das ist es, was die Zuordnung die Rundreise überstehen lässt.
12.2.2. Zusammenspiel mit DKIM und ARC¶
Die automatische Antwort wird bei BLOCK_RESPONSE_STAGE injiziert und wird daher auf dem Weg hinaus wie jede andere Nachricht DKIM-signiert. Ob das Taler:-Feld von dieser Signatur abgedeckt ist, folgt der gewöhnlichen h=-Konfiguration der Stage (SIGNED_HEADERS, siehe pepsi-stage-dkim-sign), deren Standard es nicht enthält; es wird nicht gesondert behandelt. Da die DKIM-Header-Auswahl von unten nach oben erfolgt (RFC 6376 §5.4.2), stört das Hinzufügen des Feldes keine bereits vorhandene Signatur.
12.3. Siehe auch¶
pepsi-stage-anti-spam, pepsi-stage-auto-pay, pepsi-stage-relay-to-internet, pepsi-stage-relay-to-smarthost, Unterstützte Funktionen, RFC-Index.