35. pepsi-stage-arc

ARC-Verifikation, Signieren und Versiegeln — die Einstiegs-Stage auf dem eingehenden Pfad.

35.1. Rolle

pepsi-stage-arc implementiert ARC (RFC 8617). Es verifiziert jede vorhandene eingehende ARC-Kette und versiegelt, wenn ein ARC_DOMAIN und seine Schlüssel konfiguriert sind, die Nachricht als unsere ADMD, sodass das Authentifizierungsurteil von der Grenze Pepsis Weiterleitungs-Hop überdauert. Weil es nur für Mail gilt, die wir empfangen und weiterleiten, darf es niemals unsere eigenen Submissions (state.local_origin) berühren. Diese signiert stattdessen pepsi-stage-dkim-sign als Autor-Domain, und diese Stage überspringt jede solche Nachricht. Auf einem Host, der sowohl empfängt als auch einliefert, platzieren Sie sie nur auf dem eingehenden Zweig, nach der state.local_origin-Aufteilung (vor SRS); auf einem reinen Empfangs-Host ist sie die [stage-init]-Stage. Referenz: pepsi-stage-arc(1).

35.2. Funktionen

  • ARC-Verifikation jeder eingehenden Kette; das Urteil wird unter state.auth.arc festgehalten.

  • ARC-Versiegelung: stellt ein frisches ARC-Set voran — ARC-Authentication-Results (AAR), ARC-Message-Signature (AMS) und ARC-Seal (AS) — als die ARC_DOMAIN-Identität, signiert mit dem einzigen ARC_ALGORITHM (rsa oder ed25519; ARC erlaubt eine Signatur pro Hop).

  • AAR aus dem Urteil an der Grenze: Die AAR verwendet das Authentication-Results-Fragment wieder, das Ingress unter state.origin.ar_results gespeichert hat, sodass SPF/DKIM/DMARC genau einmal verifiziert werden, bei Ingress. Hier wird nur die eingehende ARC-Kette verifiziert, um den Kettenvalidierungswert (cv=) und die arc=-Zeile der AAR zu berechnen.

  • Nur-Voranstellen: Die Versiegelung wird oben hinzugefügt, sodass bestehende tiefere Signaturen und der Ingress-Received:-Header unberührt bleiben; nur die headers-Spalte wird umgeschrieben, nie der Nachrichtentext, außer bei der einen Umschreibung, die unten beschrieben ist.

  • Die aufgeschobene MIME-Umschreibung: Eine Nachricht, die der Ingress mit state.mime_normalise markiert hat (mehrdeutiges MIME, das mit einer ARC-Kette eingetroffen ist), wird hier auf ihre RFC-Lesart umgeschrieben. Das geschieht, nachdem die Kette über die Bytes wie empfangen verifiziert wurde, und vor der Versiegelung. So spiegelt cv= die Kette wie eingetroffen wider, und die Versiegelung deckt das Gespeicherte ab (Mehrdeutiges MIME wird an der Grenze geklärt). Die Umschreibung gilt auf jedem weiterschaltenden Pfad, versiegelt oder nicht.

  • Fail-open: Wenn der Ursprungskontext, die [pepsi]-Konfiguration oder die Schlüssel fehlen oder die Versiegelung fehlerhaft ist, wird die Nachricht unversiegelt mit einer Warnung weitergeschaltet (das Urteil wird dennoch festgehalten, wenn berechenbar). Nur ein Signier-Daemon, der nicht erreichbar ist, lässt sie warten und es erneut versuchen.

  • cv=fail für jede gebrochene Kette (RFC 8617 Abschnitt 5.2), einschließlich einer, die sich nicht parsen lässt oder deren Sätze mit rsa-sha1 signiert sind (RFC 8301), sodass eine gebrochene Kette nie zu einem frischen i=1; cv=none-Satz reingewaschen wird. Eine Kette, deren letzte Versiegelung bereits cv=fail sagt, erhält keinen weiteren Satz.

  • DNS-temperror wird abgewartet: Eine Kette, die nur deshalb nicht validiert werden konnte, weil eine Schlüsselabfrage fehlschlug, wird fünf Minuten pausiert und höchstens dreimal wiederholt (gezählt in state.arc_temperrors), bevor sie mit cv=fail versiegelt wird.

35.3. Konfiguration

[stage-<name>]: PROGRAM = pepsi-stage-arc, NEXT_STAGE (erforderlich: Die Stage reicht die Nachricht immer weiter, sodass ein fehlendes jede Nachricht scheitern lässt), die DNS-Einstellungen DNS_SERVERS (leer = [pepsi] DNS_SERVERS, sonst der Systemresolver; einfache, tls://- oder https://-Einträge) / DNS_TIMEOUT sowie die gemeinsamen Signaturparameter HEADER_CANONICALIZATION / BODY_CANONICALIZATION (standardmäßig relaxed, oder simple), SIGNED_HEADERS (das From enthalten muss; der Standard deckt DKIM-Signature ab, wenn die Nachricht eine trägt) und SIGNATURE_EXPIRATION_DAYS (standardmäßig kein x=), angewandt auf die AMS (das ARC-Seal ist laut RFC 8617 stets relaxed über seine feste Header-Menge kanonisiert und trägt kein x=). Die Signieridentität und der Algorithmus stammen aus dem gemeinsamen [pepsi]-Abschnitt (ARC_DOMAIN, ARC_ALGORITHM). Siehe pepsi-stage-arc(1).

Die Versiegelung erfolgt mit dem Schlüssel für ARC_DOMAIN und ARC_ALGORITHM, den pepsi-dkim(1) hält und mit dem er signiert; die Stage baut die ARC-Message-Signature und das ARC-Seal und sendet den Header-Block an den Socket des Daemons. Ohne ARC_DOMAIN, oder wenn der Daemon nicht dafür signiert, wird die Nachricht unversiegelt weitergeschaltet; ist der Daemon nicht erreichbar, wird sie wiederholt. Eine kompromittierte Stage kann den Schlüssel nicht kopieren, aber Versiegelungen erstellen lassen, solange sie läuft, daher ist eine Versiegelung nur so stark wie die Rolle pepsi (Eine kompromittierte Komponente). Eine gültige Kette vermittelt für sich kein Vertrauen (RFC 8617 §8.4): Eine lokale Richtlinie, etwa die sealer_domain-Datensätze von pepsi-stage-check-whitelist, stützt sich auf state.auth.arc_sealers. Die Stage schützt den Ruf der Domain, nicht eine Vorliebe eines Benutzers; führen Sie sie nie in EDITABLE_STAGES auf (Adressbezogene Einstellungen sind eine Vertrauensgrenze).

35.4. State

  • Eingaben: state.local_origin: Wenn wahr, wird die Nachricht unberührt weitergeschaltet (kein ARC bei Mail, die wir erzeugen). Andernfalls state.origin mit der authserv_id (erforderlich, um die AAR-Identität zu reproduzieren; ohne sie schaltet die Stage unversiegelt weiter), ar_results (in der AAR wiederverwendet) und remote_ip (ohne sie trägt die AAR kein arc=-Ergebnis). state.mime_normalise: Wenn wahr, werden die MIME-Anomalien der weichen Klasse hier umgeschrieben.

  • Ausgaben: überschreibt state.auth.arc mit dem neu bewerteten Kettenurteil und hält die Siegler-Domains der Kette unter state.auth.arc_sealers fest (der Rest von state, einschließlich der übrigen state.auth-Geschwister und state.dsn, bleibt erhalten). Für eine Kette, die validiert wurde, führt arc_sealers nur die Siegler auf, deren eigene ARC-Message-Signature sich noch über die Nachricht verifizieren lässt (die Kettenvalidierung prüft nur die neueste, sodass ein aus einer anderen Nachricht kopierter Satz sonst einen Siegler nennen würde, der diese Bytes nie gesehen hat); für eine, die nicht validiert wurde, führt es jeden behaupteten Siegler auf, sodass jeder Leser zuerst state.auth.arc == "pass" verlangen muss. Während ein DNS-temperror abgewartet wird, zählt state.arc_temperrors die Pausen. Nach der aufgeschobenen MIME-Umschreibung ist state.mime_normalise false und state.mime_normalised pepsi-stage-arc.

35.5. Siehe auch

pepsi-ingress, pepsi-stage-dkim-sign, Unterstützte Funktionen, pepsi-stage-arc(1).