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.arcfestgehalten.ARC-Versiegelung: stellt ein frisches ARC-Set voran —
ARC-Authentication-Results(AAR),ARC-Message-Signature(AMS) undARC-Seal(AS) — als dieARC_DOMAIN-Identität, signiert mit dem einzigenARC_ALGORITHM(rsaodered25519; ARC erlaubt eine Signatur pro Hop).AAR aus dem Urteil an der Grenze: Die AAR verwendet das
Authentication-Results-Fragment wieder, das Ingress unterstate.origin.ar_resultsgespeichert hat, sodass SPF/DKIM/DMARC genau einmal verifiziert werden, bei Ingress. Hier wird nur die eingehende ARC-Kette verifiziert, um den Kettenvalidierungswert (cv=) und diearc=-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 dieheaders-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_normalisemarkiert 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 spiegeltcv=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-sha1signiert sind (RFC 8301), sodass eine gebrochene Kette nie zu einem frischeni=1; cv=none-Satz reingewaschen wird. Eine Kette, deren letzte Versiegelung bereitscv=failsagt, 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 mitcv=failversiegelt 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). Andernfallsstate.originmit derauthserv_id(erforderlich, um die AAR-Identität zu reproduzieren; ohne sie schaltet die Stage unversiegelt weiter),ar_results(in der AAR wiederverwendet) undremote_ip(ohne sie trägt die AAR keinarc=-Ergebnis).state.mime_normalise: Wenn wahr, werden die MIME-Anomalien der weichen Klasse hier umgeschrieben.Ausgaben: überschreibt
state.auth.arcmit dem neu bewerteten Kettenurteil und hält die Siegler-Domains der Kette unterstate.auth.arc_sealersfest (der Rest vonstate, einschließlich der übrigenstate.auth-Geschwister undstate.dsn, bleibt erhalten). Für eine Kette, die validiert wurde, führtarc_sealersnur 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 zuerststate.auth.arc == "pass"verlangen muss. Während ein DNS-temperrorabgewartet wird, zähltstate.arc_temperrorsdie Pausen. Nach der aufgeschobenen MIME-Umschreibung iststate.mime_normalisefalseundstate.mime_normalisedpepsi-stage-arc.
35.5. Siehe auch¶
pepsi-ingress, pepsi-stage-dkim-sign, Unterstützte Funktionen, pepsi-stage-arc(1).