95.1.4. pepsi-stage-arc

ARC-verify, sign and seal in the Pepsi pipeline

Handbuchabschnitt:

1

95.1.4.1.1. Name

pepsi-stage-arc - die ARC-Verifizierungs- und Versiegelungs-Stage der Pepsi-Pipeline.

95.1.4.1.2. Übersicht

pepsi-stage-arc [GLOBAL-OPTIONS] worker

95.1.4.1.3. Beschreibung

pepsi-stage-arc ist ein Stage-Programm, das pepsi-dispatch(1) als persistenten Worker ausführt; der Worker liest Nachrichten-IDs von der Standardeingabe. Es implementiert ARC (RFC 8617): Es verifiziert jede vorhandene eingehende ARC-Kette und hält das Ergebnis im state.auth.arc des Datensatzes fest. Wenn eine ARC-Signieridentität konfiguriert ist, versiegelt es die Nachricht außerdem als unsere ADMD, indem es ein frisches ARC-Set voranstellt: ARC-Authentication-Results (AAR), ARC-Message-Signature (AMS) und ARC-Seal (AS). Die Versiegelung stellt nur Header-Zeilen voran, sodass bestehende Signaturen weiter unten in der Nachricht unberührt bleiben; die einzige Inhaltsänderung, die diese Stage vornimmt, ist die unten beschriebene MIME-Umschreibung. Der Datensatz schaltet dann zu seinem NEXT_STAGE weiter. Der Rest des state des Datensatzes, einschließlich etwaiger RFC-3461-state.dsn-Parameter, bleibt unberührt, damit spätere Stages ihn beachten können.

Das Signieren mit ARC ist eine Stage und nicht Teil von pepsi-ingress(1), sodass Ingress die ARC-Signierschlüssel nicht hält. Ingress verifiziert SPF, DKIM und DMARC, schreibt den eigenständigen Authentication-Results-Header und hält den gerenderten Ergebnistext unter state.origin.ar_results fest; diese Stage fügt nur das ARC-Set hinzu. Die AAR (die gemäß RFC 8617 die vollständige Bewertung des Empfängers widerspiegeln sollte) entsteht unverändert aus diesem gespeicherten Fragment. SPF, DKIM und DMARC werden hier daher nicht erneut verifiziert, und die Arbeit, die viele DNS-Abfragen braucht, geschieht genau einmal. Diese Stage verifiziert nur die eingehende ARC-Kette, die Ingress nicht bewertet. So berechnet sie den Wert der Kettenvalidierung (cv=) und hängt ihre eigene arc=-Zeile an die AAR an.

Eine Umschreibung erfolgt hier statt im Ingress. Eine Nachricht, deren MIME-Struktur eine Anomalie der weichen Klasse hat (pepsi-ingress(1), „Ambiguous MIME structure“), schreibt normalerweise der Ingress vor dem Speichern auf ihre RFC-Lesart um. Eine Nachricht, die mit einer ARC-Kette eintraf, wird dagegen wie empfangen gespeichert und mit state.mime_normalise markiert: Die Kette muss über die Bytes verifiziert werden, die ihre Versiegler signiert haben, während unsere Versiegelung das abdecken muss, was von hier an gespeichert wird. Diese Stage verifiziert die Kette über die Nachricht wie empfangen, schreibt sie um (pepsi_common::mime_anomaly) und versiegelt die umgeschriebene Nachricht, sodass cv= die Kette wie eingetroffen widerspiegelt und die ARC-Message-Signature die gespeicherten Bytes abdeckt. Bei einer solchen Nachricht werden sowohl die Spalte headers als auch die Spalte body umgeschrieben, state.mime_normalise wird auf false und state.mime_normalised auf pepsi-stage-arc gesetzt. Die Umschreibung wird auf jedem weiterschaltenden Pfad angewendet, versiegelt oder nicht; eine Pause wegen eines DNS-temperror lässt den Datensatz, wie er war.

95.1.4.1.4. Wer die Kette versiegelt hat: state.auth.arc_sealers

Neben dem Urteil hält die Stage das d= der ARC-Seal-Felder fest, die die Nachricht bei ihrer Ankunft trug. Sie speichert sie als JSON-Array unter state.auth.arc_sealers: kleingeschrieben, um einen etwaigen abschließenden Wurzelpunkt gekürzt, ohne Duplikate und nach Instanz geordnet, sodass die ADMD, die dem Urheber am nächsten ist, zuerst kommt. Unser eigenes ARC_DOMAIN erscheint nie: Die Liste wird aus der Nachricht gelesen, bevor das eigene Set dieser Stage gerendert wird, sodass ein Siegel, das wir hinzugefügt haben, keine Regel über Zwischenstationen erfüllen kann.

Dies existiert, weil state.auth.arc die Frage nicht beantworten kann, die ein Empfänger tatsächlich hat. RFC 8617 §8.4 stellt ausdrücklich fest, dass eine gültige Kette keine Vertrauenswürdigkeit vermittelt: Sie belegt nur, dass die darin benannten ADMDs die Nachricht bearbeitet haben, und überlässt die Frage, ob diese ADMDs ehrlich sind, bewusst der lokalen Richtlinie. Ein Empfänger, der einem weiterleitenden Hop sein kaputtes SPF oder DKIM nachsehen will, muss daher die Hops benennen, die er akzeptiert, und er braucht eine Stelle, an der er die Hops lesen kann. Dieser Schlüssel ist diese Stelle; die sealer_domain-Datensätze von pepsi-stage-check-whitelist(1) sind die Richtlinie, die darauf aufbaut.

Für eine Kette, die validiert wurde, enthält das Array nur die Versiegler, deren eigene ARC-Message-Signature sich noch über die Nachricht wie eingetroffen verifizieren lässt. RFC 8617 Abschnitt 5.2 prüft nur die neueste AMS; die älteren Sets werden von den Siegeln an ihrem Platz gehalten, und ein Siegel signiert die ARC-Header-Felder, nicht die Nachricht. So kann jeder ein echtes Set von einem realen Beitrag von lists.example.org kopieren, es über eigenen Inhalt legen und das Ergebnis mit seinem eigenen Schlüssel versiegeln: Die Kette validiert und nennt lists.example.org, das diese Bytes nie gesehen hat. Die AMS jedes Versieglers zu prüfen ist das, was die Liste „hat diesen Inhalt signiert“ bedeuten lässt statt „erscheint in einer gültigen Kette“. Der Preis ist, dass ein späterer Hop, der die Nachricht umschreibt (eine Betreffmarkierung, eine Fußzeile), die früheren Versiegler aus der Liste fallen lässt, was richtig ist: Dieser Hop hätte alles umschreiben können.

Für eine Kette, die nicht validiert wurde, enthält das Array jeden behaupteten Versiegler. Ein unvalidiertes d= ist eine Behauptung, und ein Betreiber, der eine abgelehnte Nachricht untersucht, braucht die Aufzeichnung dessen, was behauptet wurde. Alles, was das Array auswertet, muss daher zuerst state.auth.arc = pass verlangen. check-whitelist tut das und verwirft andernfalls die ganze Liste, sodass eine Kette, die sich jedermann ausstellen kann, keinen vertrauenswürdigen Versiegler benennen kann.

95.1.4.1.5. Kettenvalidierung und cv=

RFC 8617 §5.2 definiert drei Ergebnisse der Kettenvalidierung, und das cv=-Tag des ARC-Seal, das diese Stage hinzufügt, meldet, welches davon auf die Nachricht in dem Zustand zutrifft, in dem sie eingetroffen ist:

cv=none

Es war keine ARC-Kette vorhanden: Diese ADMD ist die erste, die die Nachricht versiegelt.

cv=pass

Eine Kette war vorhanden, und jedes Set wurde erfolgreich validiert.

cv=fail

Eine Kette war vorhanden und ließ sich nicht validieren.

cv=none ist eine Aussage über die Herkunft und nicht ein Fehlen: Es teilt dem nächsten Empfänger mit, dass sich vorgelagert noch niemand für diese Nachricht verbürgt hat. Es über einer vorhandenen, aber beschädigten Kette auszugeben, würde diese Kette reinwaschen: Der nachgelagerte Validierer sähe ein scheinbar makelloses i=1-Set und keinerlei Hinweis darauf, dass irgendetwas manipuliert wurde.

Pepsi versiegelt daher jede eingehende Kette, die sich nicht validieren lässt, mit cv=fail, auch in den Fällen, in denen die Kette überhaupt nicht gelesen werden kann: ein ARC-Seal/ARC-Message-Signature/ARC-Authentication-Results-Header, der sich nicht parsen lässt, eine Kette, die länger ist als die 50 Sets, die RFC 8617 erlaubt, und eine Kette mit ungleichen Anzahlen der drei Header-Typen. Ein mit rsa-sha1 versiegeltes oder signiertes Set validiert ebenfalls nicht: RFC 8301 macht diesen Algorithmus für DKIM zu einem permerror, und ARC-Siegel und Nachrichtensignaturen verwenden die DKIM-Algorithmen. Das neue Set setzt die Instanznummerierung der Kette fort, statt sie wieder bei i=1 zu beginnen.

Die eine Ausnahme ist eine Kette, deren jüngstes ARC-Seal bereits cv=fail sagt. Nach RFC 8617 §5.1.1 lässt sich eine fehlgeschlagene Kette nicht reparieren und dieses Seal ist das letzte, sodass diese Stage gar kein Set hinzufügt und die Nachricht mit der Kette so weitergeleitet wird, wie sie ist.

Eine Kette, die nur deshalb nicht validiert werden konnte, weil eine Schlüsselabfrage fehlschlug (ein DNS-temperror), wird nicht sofort versiegelt: Dieses cv=fail wäre über eine Kette, die womöglich intakt ist, falsch, und ein Siegel lässt sich nicht zurücknehmen. Die Nachricht wird für fünf Minuten pausiert und erneut versucht, bis zu dreimal (etwa eine Viertelstunde, gezählt in state.arc_temperrors); schlagen die Abfragen dann immer noch fehl, wird sie wie jede andere nicht validierende Kette mit cv=fail versiegelt.

Die Versiegelung braucht etwas Kontext aus der SMTP-Sitzung: die authserv-id, das gerenderte Authentication-Results-Fragment und die IP-Adresse des Clients, der sich verbindet. Die Stage liest ihn aus den SMTP-Ursprungs-Metadaten, die der Ingress unter dem state.origin des Datensatzes festgehalten hat. So gibt der Ingress Informationen an diese Stage weiter.

Das ARC-Set wird mit dem Schlüssel der Domain [pepsi] ARC_DOMAIN für den einen Algorithmus signiert, den [pepsi] ARC_ALGORITHM nennt (ARC erlaubt eine Signatur pro Hop). Die Stage hält keinen Schlüssel: Der Signier-Daemon pepsi-dkim(1) tut das, unter seinem eigenen Konto. Die Stage baut die Felder ARC-Message-Signature und ARC-Seal und sendet jeden kanonisierten Header-Block an den Socket des Daemons ([pepsi-dkim] SOCKET), der nur für ARC_DOMAIN signiert. Eine kompromittierte Stage kann den Schlüssel daher nicht kopieren, aber jeder Prozess der Gruppe pepsi kann den Socket fragen, sodass ein Siegel nur so stark ist wie diese Rolle (siehe das Kapitel Threat model des Handbuchs). Die Stage schützt den Ruf der Domain, nicht eine Vorliebe eines Benutzers, führen Sie sie daher nicht in den EDITABLE_STAGES von pepsi-stage-edit-settings(1) auf.

ARC gilt nur für Mail, die wir empfangen und weiterleiten: Es bewahrt die Authentifizierung einer vorgelagerten ADMD über unseren Hop hinweg. Es darf daher niemals Mail berühren, die wir erzeugen, also unsere eigenen authentifizierten Einlieferungen (state.local_origin); diese authentifiziert stattdessen pepsi-stage-dkim-sign(1) als Autor-Domain. Eine solche Nachricht zu versiegeln würde nur die eigenen SPF/DKIM/DMARC-Urteile der Einlieferung (typischerweise ein SPF-fail für einen mobilen Client, der nicht in unserem SPF-Eintrag steht) im ARC-Set veröffentlichen. Die Stage überspringt daher jede state.local_origin-Nachricht, die sie erhält, und schaltet sie unversiegelt weiter; das macht die Stage überall dort sicher, wo sie platziert wird. Auf einem Host, der sowohl empfängt als auch einliefert, platzieren Sie sie nur auf dem eingehenden Zweig, nach der Aufteilung nach state.local_origin, damit sie nur empfangene Mail sieht, und vor der SRS-Umschreibung des Umschlags und jeder anderen Transformation. Auf einem reinen Empfangs-Host ist sie natürlicherweise die anfängliche Stage ([stage-init]).

Die Versiegelung ist fail-open, wo es nichts gibt, womit versiegelt werden kann: Wenn der Ursprungskontext fehlt, die [pepsi]-Konfiguration nicht gelesen werden kann, kein ARC_DOMAIN gesetzt ist, pepsi-dkim(1) nicht dafür signiert oder keinen Schlüssel für ARC_ALGORITHM hält oder der Resolver nicht eingerichtet werden kann, wird die Nachricht unversiegelt mit einer Warnung weitergeschaltet, statt aufgehalten zu werden (das ARC-Urteil wird dennoch festgehalten, wann immer es berechnet werden konnte). Ein Signier-Daemon, der nicht erreichbar ist, ist etwas anderes: Das ist der Fehler des Hosts, und die Nachricht wird wie jeder Stage-Fehler bis zum MAX_LIFETIME der Stage pausiert und wiederholt, nie deswegen unversiegelt weitergeschaltet. Der eigene Abschnitt der Stage ist die andere Ausnahme: Er wird beim Start des Workers geprüft, und ein Abschnitt, der sich nicht parsen lässt, lässt den Worker den Start verweigern (Exit 78). Der Dispatcher hält dann die Warteschlange zurück, bis der Abschnitt korrigiert ist, statt jede Nachricht unversiegelt durchzulassen.

95.1.4.1.6. Konfiguration

Die Stage wird über ihren eigenen [stage-<name>]-Abschnitt verdrahtet und konfiguriert (PROGRAM = pepsi-stage-arc, ein erforderliches NEXT_STAGE). Ihre Optionen sind die DNS-Einstellungen (DNS_SERVERS, DNS_TIMEOUT) und die Signaturparameter des ARC-Sets: HEADER_CANONICALIZATION, BODY_CANONICALIZATION, SIGNATURE_EXPIRATION_DAYS und SIGNED_HEADERS; der Standardwert von SIGNED_HEADERS fügt DKIM-Signature zur Menge der DKIM-Stage hinzu und lässt das List-Unsubscribe-Paar weg. pepsi.conf(5) dokumentiert sie zusammen mit der gemeinsamen [pepsi]-Signieridentität (ARC_DOMAIN, ARC_ALGORITHM). Der Schlüssel und sein Selektor gehören pepsi-dkim(1).

95.1.4.1.7. State

Eingaben: state.local_origin: Wenn es wahr ist, ist die Nachricht eine unserer eigenen Einlieferungen und wird unberührt weitergeschaltet (kein ARC). Andernfalls state.origin, die SMTP-Ursprungs-Metadaten, die der Ingress festgehalten hat. Die authserv_id ist erforderlich, um die AAR-Identität zu reproduzieren (ohne sie schaltet die Stage unversiegelt weiter, fail-open); ar_results trägt das vom Ingress gerenderte Authentication-Results-Fragment, in der AAR wörtlich wiederverwendet, sodass SPF/DKIM/DMARC nicht erneut geprüft werden müssen; remote_ip wird für das eigene arc=-Ergebnis der AAR gebraucht, das weggelassen wird, wenn es fehlt (lokale Injektion). helo wird gelesen, ändert das Set aber nicht.

Ausgaben: Die Stage überschreibt state.auth.arc mit dem neu bewerteten Kettenurteil (sie ersetzt das none, das Ingress dort einträgt), schreibt state.auth.arc_sealers (siehe oben) und stellt das ARC-Set der headers-Spalte voran; der Rest von state, einschließlich der anderen state.auth-Urteile und state.dsn, bleibt unverändert erhalten. Während sie einen DNS-temperror abwartet, zählt sie die Versuche in state.arc_temperrors. Das State-Layout wird in pepsi.state(7) beschrieben.

Übergänge: schaltet zu NEXT_STAGE weiter: nach dem Voranstellen des ARC-Sets, nach dem bloßen Festhalten des Urteils in state.auth.arc, wenn keine Signieridentität konfiguriert ist, oder sofort (unberührt) bei einer state.local_origin-Nachricht, die nie ARC-verarbeitet wird. Das einzige andere Ergebnis ist eine Pause von fünf Minuten, höchstens dreimal, für eine eingehende Kette, deren Validierung auf einen DNS-temperror stieß (siehe oben). Es gibt keine Verzweigung; die Stage schlägt nie fehl, leitet nie um und schließt nie ab.

95.1.4.1.8. Befehle

Als Worker ausgeführt, verifiziert und versiegelt das Programm jede Nachricht und schaltet sie weiter.

95.1.4.1.9. Globale Optionen

-c FILE, –config FILE

Liest die Konfiguration aus FILE statt aus dem Standard-Suchpfad.

-L LOGLEVEL, –log LOGLEVEL

Setzt die Log-Ausführlichkeit (error, warn, info, debug, trace; Standardwert [pepsi] LOG, sonst info).

-h, –help

Gibt eine Verwendungsübersicht aus und beendet sich.

-V, –version

Gibt die Version aus und beendet sich.

95.1.4.1.10. Exit-Status

Das Ergebnis jeder Nachricht wird pepsi-dispatch(1) in der Statuszeile des Workers gemeldet, nicht als Exit-Status.

0

Der Worker lief, bis seine Standardeingabe geschlossen wurde.

1

Ein fataler Fehler ist aufgetreten (unlesbare Konfiguration, die Datenbank konnte nicht geöffnet werden, oder die Standardein- bzw. -ausgabe schlug fehl). Der Grund wird in das Protokoll geschrieben.

78

Der Worker hat den Start verweigert: Sein Abschnitt lässt sich nicht parsen. Der Dispatcher reiht erneut ein, was er übergeben hatte, und versucht die Stage später wieder.

95.1.4.1.11. Siehe auch

pepsi-config(1), pepsi-ingress(1), pepsi-stage-srs(1), pepsi-stage-dkim-sign(1), pepsi-dispatch(1), pepsi.conf(5), pepsi.state(7), pepsi-setup(1), pepsi-dkim(1)

95.1.4.1.12. Fehler

Melden Sie Fehler an den Pepsi-Issue-Tracker.