95.1.7. pepsi-stage-decrypt¶
decrypt mail addressed to our users and verify what signed it
- Handbuchabschnitt:
1
95.1.7.1.1. Name¶
pepsi-stage-decrypt - die eingehende Stage der Pepsi-Pipeline für Ende-zu-Ende-Entschlüsselung und Signaturverifikation.
95.1.7.1.2. Übersicht¶
pepsi-stage-decrypt [GLOBAL-OPTIONS] worker
95.1.7.1.3. Beschreibung¶
pepsi-stage-decrypt ist ein Stage-Programm, das von pepsi-dispatch(1) als persistenter Worker ausgeführt wird, der Nachrichten-IDs von der Standardeingabe liest. Für eine Nachricht an einen Empfänger, den dieser Host bedient, öffnet es jedes Chiffrat, das die Nachricht trägt, verifiziert jede Signatur, die sie trägt, gegen eine echte Vertrauenskette, hält das Urteil fest und entfernt jeden Sicherheitsindikator, den der Absender gefälscht hat. Es liest die Zertifikate, die die Nachricht mitführt, um diese Signatur zu prüfen, speichert aber keines davon: Die Schlüssel von Korrespondenten zu lernen ist Sache von pepsi-stage-autocrypt-learn(1), und das ist eine eigene Stage, weil sie nach dem Spam-Urteil laufen muss, das es hier noch nicht gibt.
Dies auf dem Server zu tun ist das, was ein Client-Plugin überflüssig macht: Der Benutzer liest gewöhnliche Mail in seinem üblichen Client. Der Handel ist nur deshalb tragfähig, weil die Nachricht gleich aufhört, ein SMTP-Objekt zu sein, und zu einer Datei in einem Postfach wird — siehe Lokalität. Diese Datei ist Klartext, es sei denn, der Empfänger hat seinen eigenen Mail-Client-Schlüssel registriert und pepsi-stage-reencrypt(1) steht vor der lokalen Zustellung und versiegelt, was diese Stage geöffnet hat, für diesen Schlüssel, sobald die späteren Stages es gelesen haben.
Die Verifikationshälfte ist bei einer Unterscheidung bewusst streng. Eine kryptographisch einwandfreie Signatur sagt Ihnen, dass die Nachricht von irgendeinem Schlüssel signiert wurde; ob dieser Schlüssel dem Absender gehört, ist eine gesonderte Frage. Die beiden werden nie als dasselbe gemeldet (Urteile).
95.1.7.1.4. Lokalität¶
Die Stage läuft nur für Empfänger, die dieser Host bedient, und bei einer Nachricht, die er nicht bedient, versucht sie es gar nicht erst — ein fehlgeschlagener Entschlüsselungsversuch sollte das Urteil nicht färben, und für eine solche Nachricht gibt es ohnehin keinen Schlüssel.
Der Grund ist, dass das Entschlüsseln den Nachrichtentext umschreibt. Die DKIM-Signatur des Absenders verifiziert dann nicht mehr, und ein vor dem Entschlüsseln erstelltes ARC-Siegel (siehe Platzierung) deckt die verschlüsselte Form ab. Bei einer Nachricht, die gleich lokal zugestellt wird, ist das harmlos. Bei einer weitergeleiteten Nachricht ist es das nicht: Sie käme mit kaputter Signatur beim nächsten Hop an, was ein stärkeres negatives Signal ist als gar keine Signatur.
Die Lokalität ist derselbe Test, den die Zustell-Stages verwenden — LOCAL_DOMAINS, TARGETS und RECIPIENT_DELIMITER — mit einem Unterschied. Standardmäßig muss nur die Domain passen, denn diese Stage muss nicht wissen, in wessen Postfach zu schreiben ist; eine gehostete Domain, deren Benutzer Krypto-Identitäten, aber keine Shell-Konten haben, ist eine gewöhnliche Installation. Setzen Sie REQUIRE_ACCOUNT = yes, um zusätzlich einen passwd-Eintrag in TARGETS zu verlangen.
Eine Nachricht mit sowohl lokalen als auch fremden Empfängern wird aufgeteilt: Die fremden Empfänger werden auf einen Geschwisterdatensatz bei NEXT_STAGE abgezogen, der die Nachricht genau so trägt, wie sie ankam, und dieser Datensatz behält die lokalen. Der DSN-Zustand je Empfänger wird im Gleichschritt von demselben Code zerteilt, den jede andere Empfängeraufteilung verwendet.
Eine Nachricht, die Chiffrat für mehrere lokale Empfänger trägt, wird auf einen Empfänger pro Datensatz aufgeteilt, bevor irgendein Schlüssel geladen wird, und jede Kopie wird nur mit den Schlüsseln ihres eigenen Empfängers geöffnet. Ein Datensatz wird einmal geöffnet, und sein Klartext geht an jeden Empfänger, den er trägt. Würde er mit den Schlüsseln all dieser Empfänger geöffnet, könnte jeder ein auf dem Weg zu Bob abgefangenes Chiffrat nehmen, es an Bob und an sich selbst (oder an einen zweiten lokalen Benutzer) schicken und es entschlüsseln und dem anderen Empfänger zustellen lassen. Ein Empfänger, dessen eigene Schlüssel das Chiffrat nicht öffnen können, erhält es als Entschlüsselungsfehler (ON_DECRYPT_FAILURE).
95.1.7.1.5. Platzierung¶
Die empfohlene eingehende Kette ist:
init = arc -> decrypt -> aliases -> (anti-spam / language / …) -> local delivery
ARC läuft zuerst. Ein ARC-Set versiegelt die Nachricht so, wie sie ankam; zuerst zu entschlüsseln ließe das versiegelte AMS Bytes beschreiben, die sonst niemand je gesehen hat, sodass das Siegel eine Aussage über eine Nachricht wäre, die es nie gab. pepsi-setup(1) warnt, wenn es eine ARC-Stage findet, die von einer Decrypt-Stage aus erreichbar ist.
Die Inhaltsprüfung läuft danach. Spracherkennung, die Pay-to-Send-Schranke und die Prüfung des From:-Headers gegen die weiße Liste lesen alle den Nachrichtentext, und alle brauchen Klartext.
Die Platzierung ist auch eine Leistungsfrage. Die Stage deklariert Load::Full, weil sich den Umschlagspalten nicht ansehen lässt, ob eine Nachricht geschützt ist, und Load je Stage festliegt. Jede Nachricht, die durch sie hindurchgeht, lädt daher ihren gesamten Nachrichtentext aus der Datenbank, selbst eine, die sich als gewöhnliche unverschlüsselte Mail herausstellt. Auf einem eingehenden Pfad, der in lokaler Zustellung endet, ist das vertretbar; es ist keine Stage, die man vor Massen-Relay-Verkehr stellt.
95.1.7.1.6. Urteile¶
state.crypto.in.signature.status ist eines von:
noneDie Nachricht trägt keine Signatur.
validKryptographisch einwandfrei und der Schlüssel war verankert: eine X.509-Kette zu einem konfigurierten
ca_trust-Anker oder ein OpenPGP-Schlüssel, der per WKD oder per DANE mit einer DNSSEC-validierten Antwort gefunden wurde, einer, den der Betreiber hinzugefügt hat (pepsi-keys(1) oder die API), oder unsere eigene Identität für den Absender — und der Signierer ist an dieFrom:-Zeile gebunden, wie der Leser sie sieht (Wofür valid vergeben wird).partialWäre
valid, aber dem Leser wird neben dem signierten Text Text gezeigt, den die Signatur nicht abdeckt. Das ist der inline klarsignierte Block, der so zugestellt wird, wie er ankam: eine Armor-Header-Zeile außerHash:zwischen der MarkierungBEGIN PGP SIGNED MESSAGEund dem Text (der Armor-Leser akzeptiert dort jedeKey: value-Zeile und hasht keine davon) oder ein Block, der der Inhalt einestext/html-Teils ist, den ein Client als Markup darstellt, in dem eine solche Zeile den signierten Text verbergen kann. Der Block bleibt, wie er kam, sodass der eigene Client des Lesers ihn erneut verifizieren kann; diese Stage schreibt keine Markierung und setztstate.signature_verifiednicht.X-Pepsi-Cryptosagt, welcher Fall vorliegt (unsigned-surface=armor-headersoderhtml).valid-untrustedKryptographisch einwandfrei, aber der Schlüssel ließ sich an nichts binden: ein erstmals gesehener Schlüssel, aus der Nachricht selbst, aus einem
Autocrypt-Header oder per Gossip gelernt, von einem Keyserver (VKS, LDAP) oder aus DANE ohne DNSSEC-Validierung abgerufen, oder ein Zertifikat einer CA, für die diese Installation keinen Anker hält. Der größte Teil des signierten Mailverkehrs der Welt ist in diesem Zustand. Ebenso eine verankerte Signatur, der eine der eigenen Regeln dieser Stagevalidvorenthalten hat — eine Signatur nur über Chiffrat, ein geschütztesFrom:oder Antwortlenkungsfeld, das abweicht, ein Zertifikat, das kein Postfach nennt, ein Anzeigename, der eine andere Adresse zeigt, einFrom:mit mehreren Postfächern, eine Signierer-Domain, die wie eine bekannte aussieht, eine lange vor dem Eintreffen der Nachricht erstellte Signatur;withheld=inX-Pepsi-Cryptoundsignature.withheldim State sagen, welche.Das wird nie als ``valid`` gemeldet. Es ist die Unterscheidung, für die diese Stage existiert, und ein Sicherheitsindikator, der die beiden vermengt, ist schlimmer als keiner.
invalidDie Signatur verifiziert nicht über die Bytes, die sie abdeckt, oder das Zertifikat des Signierers ist abgelaufen, widerrufen oder an eine andere Adresse als das
From:der Nachricht gebunden. Ein S/MIME-Zertifikat wird zu dem Zeitpunkt beurteilt, zu dem die Stage läuft, nie zursigningTime, die die Signatur angibt, und ein Postfachname, der kein bloßeslocal@domainist, passt zu keinerFrom:-Adresse. Eine OpenPGP-Signatur innerhalb des Chiffrats, die ihre vorgesehenen Empfänger nennt (der Intended Recipient Fingerprint nach RFC 9580), ohne das Zertifikat zu nennen, das die Nachricht geöffnet hat, ist ebenfallsinvalid, mit dem Schichturteilwrong-recipient: Sie wurde für jemand anderen signiert, der sie erneut an uns verschlüsselt hat. Eine S/MIME-Signatur innerhalb des Chiffrats unterliegt derselben Regel über das private signierte Attribut, das Pepsi schreibt, wenn es signiert und verschlüsselt (siehe pepsi-stage-encrypt(1)), und das den SHA-256 jedes Empfängerzertifikats nennt. Eine Signatur, die keine Empfänger nennt, ist nicht betroffen; kein anderer S/MIME-Client schreibt das Attribut.unverifiableFür den behaupteten Signierenden war kein Schlüssel oder Zertifikat verfügbar, sodass sich weder das eine noch das andere feststellen ließ. Dies ist das Urteil, das die Stage auf einen Schlüssel warten lässt (Schlüsselentdeckung).
Eine Nachricht mit mehreren Signaturschichten nimmt das schlechteste der Urteile jener Schichten, die für sie sprechen. Eine kaputte Signatur macht die Nachricht invalid, wie gut die anderen auch sind. Eine Schicht, die nur Chiffrat abdeckt, gehört nur dann dazu, wenn nichts den Klartext abdeckt (siehe unten): Eine solche Schicht kann die Nachricht nie valid machen, und sobald irgendeine Schicht den Klartext abdeckt, wird sie gänzlich außer Acht gelassen, wie schlecht sie auch sein mag.
Nur valid setzt state.signature_verified, das Flag, das pepsi-stage-check-whitelist(1) als Schranke für einen Eintrag der weißen Liste verwendet.
95.1.7.1.6.1. Wofür valid vergeben wird¶
Der Verifizierer bindet den Schlüssel des Signierers an das erste Postfach von From: (eine OpenPGP-User-ID, ein S/MIME-rfc822Name oder SmtpUTF8Mailbox nach RFC 9598 oder die emailAddress des Subjekts), und ein Schlüssel, der andere Adressen nennt, ist invalid (identity-mismatch). Die Markierung [verified] verspricht mehr: dass der Signierer der Absender ist, wie der Leser die From:-Zeile sieht. Daher wird eine Signatur, die verifiziert hat, als valid-untrusted statt valid gemeldet, wenn:
der Anzeigename eine andere Adresse zeigt —
From: "Alice <alice@victim.example>" <x@attacker.example>, signiert mit dem eigenen verankerten Schlüssel des Angreifers. Beurteilt anhand des Feldes selbst und dessen, was pepsi-ingress(1) festgehalten hat (state.auth.display_name_mismatch), Grunddisplay-name;das
From:mehr als ein Postfach nennt — nur das erste wird gebunden, und ein Client, der ein anderes zeigt, zeigt einen Absender, für den nichts bürgt; Grundmultiple-from;das Zertifikat kein Postfach nennt und zu einem
ca_trust-Anker führt — es widerspricht keinemFrom:, daher kann die Bindung es nicht scheitern lassen, aber es bürgt auch für keine Adresse und wäre sonst für jeden Absendervalid. Grundno-identity. Ein Betreiber, der weiß, dass das eigene Ausstellungsverfahren einer CA jedes Blattzertifikat an das Postfach seines Inhabers bindet, nimmt diesen Anker ausdrücklich auf (pepsi-keys(1)ca add --accept-nameless,ca accept-nameless); ein Schlüssel, der durch Nachschlagen der Adresse gefunden wurde (WKD, DANE, ein Pin, unsere eigene Identität), ist durch das Nachschlagen gebunden und nicht betroffen;die Domain des Signierers wie eine bediente oder bekannte Domain aussieht — ihr Skelett (zerlegt, Diakritika entfernt, Doppelgänger über die Confusables-Daten von UTS #39 gefaltet, dieselbe Faltung, die die Betreffmarkierungs-Entfernung verwendet) gleicht dem einer Domain in
LOCAL_DOMAINS, einer Adresse im Schlüsselspeicher (crypto_identity,peer_key) oder einesfrom-Whitelist-Datensatzes, während die Domain selbst abweicht. Grundlookalike-domain, und das A-Label der Domain wird inX-Pepsi-Cryptogeschrieben (signer-domain=), wo ein Leser sehen kann, was die dargestellte Form verbirgt. Die bekannten Domains werden nur für eine Nachricht aus der Datenbank gelesen, die sonstvalidwäre, und fürTRUST_ANCHOR_TTLzwischengespeichert; der Preis ist eine legitime internationalisierte Domain, deren Skelett zufällig dem einer bekannten ASCII-Domain gleicht, die zugestellt und verifiziert, aber nicht markiert wird;ein geschütztes
From:oder Antwortlenkungsfeld (Reply-To:,Mail-Reply-To:,Mail-Followup-To:) abweicht oder das geschützteSubject:einen gefälschten Indikator trägt (Geschützte Header), Gründeprotected-from,reply-toundprotected-subject;die Signatur lange vor dem Eintreffen der Nachricht erstellt wurde: Ihre Erstellungszeit (die Erstellungszeit der OpenPGP-Signatur, das S/MIME-Attribut
signingTime) liegt mehr alsMAX_SIGNATURE_AGE_DAYS(Standardwert 7) vor der Ankunftszeit des Datensatzes, Grundold-signature, oder mehr als einen Tag danach, Grundfuture-signature. Eine abgefangene signierte Nachricht, die unter einem frischen äußerenSubject:oderDate:wiedereingespielt wird, ist die Form, die dies erfasst: Die Signatur ist echt, aber sie sagt nicht, dass ihr Signierer diese Nachricht zu dieser Zeit gesendet hat. Die Ankunftszeit ist die, die dieser Host festgehalten hat, nie das FeldDate:, das der Wiedereinspielende schreibt. Eine Signatur ohne Erstellungszeit (CMS ohnesigningTime) wird nicht beurteilt, und0schaltet die Prüfung ab. Legitim verspätet zugestellte Mail (eine Moderationswarteschlange einer Liste, eine unverändert weitergeleitete Nachricht) verliert nur die Markierung.X-Pepsi-Cryptozeigt jede festgehaltene Erstellungszeit (signed-at=);die Signatur nur Chiffrat abdeckt (nächster Abschnitt), Grund
ciphertext-cover.
Eine valid-Signatur hält die Adresse fest, an die sie gebunden ist (bound-to, signature.bound_to), und diese nennt die Markierung.
95.1.7.1.6.2. Eine Signatur, die Chiffrat abdeckt¶
In signed(encrypted(body)) wird die Signatur über das Chiffrat berechnet, nicht über irgendetwas, das ein Leser je zu sehen bekommt. Das beweist, dass der Signierende den Blob übertragen hat; es beweist nicht, dass er ihn geschrieben hat, und es beweist nicht, dass er ihn lesen kann — jeder, der eine verschlüsselte Nachricht erlangt, kann sie in seine eigene Signatur wickeln und weiterleiten. Eine solche Schicht wird mit "covers_ciphertext": true in state.crypto.in.layers festgehalten und darf, was auch immer ihr eigenes Urteil ist, die Nachricht nie ``valid`` machen: Eine gute wird als valid-untrusted gemeldet, erhält also keine [verified]-Markierung und setzt state.signature_verified nicht. Eine schlechte wird als invalid gemeldet und unter ON_BAD_SIGNATURE geroutet — nur dann, wenn sie alles ist, was da ist, also wenn keine Schicht den Klartext abdeckt.
Sobald irgendeine Schicht den Klartext doch abdeckt, werden die chiffratabdeckenden vollständig beiseitegelegt, was auch immer ihr eigenes Urteil ist. Eine Schicht, die kein Urteil gewähren kann, darf keines zerstören können: Jeder, der den verschlüsselten Blob erlangt, kann ihn neu einwickeln, und wenn eine beschädigte Hülle invalid erzwänge, wäre es für einen Angreifer strikt nützlicher, die Hülle zu beschädigen, als sie zu entfernen (was ein gewöhnliches encrypted(signed(body)) zurücklässt, das weiterhin verifiziert). Die äußere Signatur eines Dreifachumschlags ist ohnehin ein Artefakt von Hop zu Hop (in RFC 8551 §3.7 bringt ein Mailinglisten-Agent sie an), ihr Fehlschlag sagt also nichts über den Autor. Die Manipulation geht nicht verloren: Sie bleibt in state.crypto.in.layers und in X-Pepsi-Crypto sichtbar, als Beobachtung und nicht als Routing-Eingabe. Dieselbe Überlegung deckt den häufigeren Fall einer äußeren Signatur ab, die bloß unverifiable ist (kein Schlüssel für den Weiterleiter), sodass der Dreifachumschlag unten nicht für einen Signierenden bestraft wird, den wir zufällig nicht kennen.
In signed(encrypted(signed(body))) — dem Dreifachumschlag, den RFC 8551 §3.7 empfiehlt — ist also die innere Signatur diejenige, die für den Inhalt spricht, und sie ist die, die diese Stage meldet. Diese Form wird daher als valid gemeldet, wo eine einzelne äußere Signatur es nicht wird.
Wann immer es ein Signatururteil gibt, hält state.crypto.in.signature auch covers_plaintext fest: true, wenn das Urteil von einer Signatur über den Klartext erteilt wurde, false, wenn es von einer um Chiffrat gelegten Schicht stammt. pepsi-stage-autocrypt-learn(1) akzeptiert nur die erste Art als Nachweis, dass ein Korrespondent einen unserer Schlüssel besitzt.
95.1.7.1.6.3. Geschützte Header¶
Ein Signierer kann From:, To:, Reply-To:, Mail-Reply-To:, Mail-Followup-To: und Subject: abdecken, indem er sie innerhalb der Entität platziert, die er signiert: die Form der injizierten Header nach RFC 9788 (die protected-headers="v1"-Form, die pepsi-stage-encrypt(1) unter PROTECT_HEADERS schreibt) oder ein signiertes message/rfc822, dessen eingebetteter Header-Block sie trägt. Dem Leser werden die äußeren Felder gezeigt, die keine Signatur abdeckt, daher vergleicht die Stage beide für jede Signatur über den Klartext:
Ein geschütztes
From:, dessen Adresse von der des äußerenFrom:abweicht (verglichen als addr-specs des ersten Postfachs, ohne Beachtung der Groß-/Kleinschreibung, Anzeigenamen und Kommentare ignoriert), enthältvalidvor: Die Signatur wird alsvalid-untrustedgemeldet (withheld=protected-from), erhält keine[verified]-Markierung und setztstate.signature_verifiednicht. Der Signierer hat für eine Nachricht von jemand anderem gebürgt; eine signierte Nachricht, die unter einem neuen äußerenFrom:erneut gesendet wird (heimliches Weiterleiten), ist die Form, die dies erfasst. Ein geschützter Block mit zweiFrom:-Feldern, die sich widersprechen, oder einer ohne lesbare Adresse zählt als Abweichung. Nur das positive Urteil wird vorenthalten;invalidundunverifiablebleiben unverändert. Mailinglisten-Software, die das äußereFrom:signierter Mail umschreibt, kostet solche Mail daher ihrvalid, nie mehr.Ein Antwortlenkungsfeld —
Reply-To:,Mail-Reply-To:oderMail-Followup-To:—, das abweicht, enthältvalidauf dieselbe Weise vor (withheld=reply-to). Das sind die Felder, die ein Angriff zur Umleitung von Antworten ändert oder hinzufügt, daher zählt auch ein äußeres, das der Signierer nicht geschützt hat, als Abweichung, ebenso ein signiertes, das entfernt wurde. Jedes wird als Menge von addr-specs verglichen und unter seinem eigenen Namen gemeldet (protected-mismatch=). Die eine Ausnahme ist ein Feld, das eine Mailingliste hinzugefügt hat — der äußere Block trägt einList-Id:, und der Signierer hat keines der drei geschützt: Die Signatur bleibtvalid, und die Markierung lautet[verified (except reply-to): …](TAG_VERIFIED_EXCEPT_REPLY_TO,reply-to=unsignedinX-Pepsi-Crypto), sodass die Kernaussage erhalten bleibt und das Umschreiben von Reply-To weiter funktioniert, um den Preis einer weiteren zu verstehenden Markierung, nur für Listenbenutzer. Der Preis der Regel ist ein Client, der einige Header schützt, aber nicht diese Felder, bei einer Nachricht, deren Absender eines gesetzt hat: Solche Mail verliertvalid, nie mehr.Sender:wird nicht verglichen: Listen und Beauftragte setzen es legitim, und Antworten gehen nicht dorthin.Ein
Subject:, das nur durch vorn eingefügte eingeklammerte Segmente abweicht — eine Listenmarkierung, eine[external]-Markierung, die eigenen Markierungen dieser Stage bei einer Nachricht, die schon einmal die Runde gemacht hat —, ist keine Abweichung. Beide Betreffs werden zuerst auf das reduziert, was ein Leser sieht (RFC 2047 dekodiert, Leerraum zusammengefasst, die eigenen Markierungen dieser Stage und jeder gefälschte Indikator vorn entfernt); der äußere wird dann akzeptiert, wenn, nachdem seine führenden[…]-Segmente undRe:-artigen Präfixe beiseitegelassen wurden, der Rest der signierte Betreff ist, die Antwortpräfixe in der Reihenfolge übereinstimmen und jedes eingeklammerte Segment, das der Signierer geschrieben hat, noch in der Reihenfolge vorhanden ist — die äußere Seite darf mehr haben, vor oder nach einemRe:. Eine größere Abweichung wird gemeldet, und wenn die Signatur sonstvalidist, wird der signierte Betreff anstelle des äußeren gezeigt (subject=protectedinX-Pepsi-Crypto,state.crypto.in.subject_promoted), sodass die Nachricht[verified]unter dem Betreff behält, den ihr Signierer geschrieben hat. Eine ohne Klammern geschriebene Markierung wieEXTERNAL:wird dadurch entfernt; ebenso alles andere, was unterwegs hinzugefügt wurde. Header-Schutz ersetzt das äußereSubject:absichtlich, daher ist ein äußeres...oder[...]keine Abweichung, und nichts wird darüber gestellt.Ein geschütztes
Subject:, das einen gefälschten Indikator trägt, enthältvalidvor (withheld=protected-subject). Die Bereinigung der Betreffmarkierungen (Betreffmarkierungen) wird über den geschützten Betreff wie über den äußeren ausgeführt; der äußere wird bereinigt, aber der geschützte kann es nicht werden, ohne die Signatur zu brechen, und ein Client, der geschützte Header zeigt, zeigt ihn. Wenn die Bereinigung ihn ändern würde (eine Sicherheitsmarkierung oder ein Doppelgänger davon vorn, ein Indikatorsymbol, ein Bidi-Steuerzeichen), wird die Signatur alsvalid-untrustedgemeldet. Eine Pepsi-Installation sendet ihre eigenen Markierungen nie weiter: Eine Antwort, die[verified: …]zitiert, verlässt pepsi-stage-encrypt(1) ohne sie, sodass eine solche Antwortvalidbehält.Abweichungen bei
To:werden nur gemeldet. Weiterleiter und Listen ändern es legitim. Verglichen als Menge von addr-specs.
Eine Signatur, deren abgedeckte Entität keines dieser sechs Felder trägt, wird überhaupt nicht verglichen; das Zertifikat des Signierers wird weiterhin an das äußere From: gebunden, wie unter invalid beschrieben. Eine Schicht, die Chiffrat abdeckt, hat keinen Klartext-Header-Block und wird nie verglichen. Die abweichenden Feldnamen werden als state.crypto.in.protected_mismatch und in X-Pepsi-Crypto als protected-mismatch festgehalten (from, to, reply-to, mail-reply-to, mail-followup-to, subject). Abgesehen von der obigen Betreffübernahme werden die geschützten Kopien nie in den zugestellten Header-Block übernommen.
95.1.7.1.7. Fehlerbehandlung¶
Beide Fehlerpfade stellen standardmäßig zu, im Einklang mit Pepsis bewusster fail-open-Haltung bei eingehendem SPF, DKIM und DMARC:
ON_DECRYPT_FAILURE = passthroughDie weiterhin verschlüsselte Nachricht wird zugestellt. Der Benutzer hält den Schlüssel womöglich in seinem eigenen Client, und für Mail, die wir bloß nicht öffnen konnten, einen Bounce zu erzeugen, hilft niemandem.
quarantineundbounce-if-unproblematicstehen zur Verfügung. Der Wertbounceist ein Alias für das längere, aber eindeutigebounce-if-unproblematic: Der Bounce wird nur bei Nachrichten gesendet, bei denen das CBC-Orakel nicht greift, weil die Nachricht nicht mit CBC verschlüsselt ist. Der Worker und pepsi-setup(1) warnen, wenn die kurze Schreibweise verwendet wird.ON_BAD_SIGNATURE = recordEine schlechte Signatur ist ein festgehaltenes Urteil, nie ein Zustellfehler. Mailinglisten, die Nachrichtentexte umschreiben, Weiterleiter und Clients mit kaputter Kanonisierung erzeugen alle schlechte Signaturen an völlig legitimer Mail; sie unter Quarantäne zu stellen kostete weit mehr, als es fängt.
quarantineundbouncestehen zur Verfügung;bounceverwirft eine Nachricht, deren Signatur aus einem Chiffrat ohne Integritätsschutz stammt, statt einen Bounce zu erzeugen (siehe unten).
Beachten Sie, dass für diesen Zweck nur invalid eine „schlechte Signatur“ ist. valid-untrusted und unverifiable sind der Normalzustand von Mail eines Korrespondenten, von dem hier niemand je gehört hat, und diese irgendwohin zu routen routete den größten Teil des Internets.
Die Entschlüsselungsrichtlinie wird zuerst herangezogen: Eine Nachricht, die nicht geöffnet werden konnte, hat kein Signatururteil, auf das zu reagieren sich lohnt.
95.1.7.1.7.1. Korrespondenten, die üblicherweise signieren¶
Eine Signatur schützt nur dann vor einem gefälschten From:, wenn ihr Fehlen bemerkt wird. Immer wenn eine Signatur valid erhält – ein verankerter, an die From:-Adresse gebundener Schlüssel –, hält die Stage die Adresse, den Signaturschlüssel und die Zeit in pepsi.signed_sender fest. Nur valid schreibt dorthin, sodass niemand den Eintrag für eine Adresse anlegen oder auffrischen kann, deren verankerten Schlüssel er nicht hält.
Eine spätere Nachricht von dieser Adresse, die keine valid-Signatur trägt (unsigniert, unverifiable, valid-untrusted oder partial), innerhalb von MISSING_SIGNATURE_WINDOW_DAYS (Standardwert 90) nach der letzten gültigen, wird gemäß ON_MISSING_SIGNATURE behandelt:
record(Standardwert)X-Pepsi-Cryptoerhältusually-signed=<date of the last valid signature>, undstate.crypto.in.usually_signedhält es fest, für Sieve-Regeln und die Client-Erweiterungen; sonst ändert sich nichts. Ein Korrespondent, der von einem Telefon oder einem neuen Client schreibt, erzeugt genau diese Form, weshalb nichts Stärkeres der Standardwert ist.tagStellt zusätzlich
TAG_MISSING_SIGNATURE(Standardwert[unsigned, usually signed]) demSubjectvoran.quarantineLeitet die Nachricht zu
QUARANTINE_STAGE.
Eine invalid-Signatur fällt unter ON_BAD_SIGNATURE, und eine Nachricht, die diese Stage nicht geöffnet hat (ein Entschlüsselungsfehler, Mail für den eigenen Client-Schlüssel des Benutzers, ein unter UNAUTHENTICATED_PLAINTEXT zurückgehaltener Klartext), wird nicht beurteilt, da ihre Signatur nicht gesehen werden konnte. MISSING_SIGNATURE_WINDOW_DAYS = 0 schaltet die Prüfung ab; gültige Signaturen werden weiterhin festgehalten. Ein Datenbankfehler beim Lesen oder Schreiben des Eintrags wird protokolliert und wie kein Eintrag behandelt. Telemetrie decrypt-missing-signature.
95.1.7.1.7.2. Einem Absender mitteilen, dass die Entschlüsselung fehlschlug¶
Ein Bounce für jede fehlgeschlagene Entschlüsselung würde dem, der die Nachricht gesendet hat, sagen, ob sie geöffnet werden konnte. Für ein Chiffrat ohne Integritätsschutz, ein S/MIME-EnvelopedData mit AES-CBC oder 3DES, ist das ein Entschlüsselungsorakel. Ein Angreifer, der eine an einen unserer Benutzer verschlüsselte Nachricht abgefangen hat, sendet veränderte Kopien unter seinem eigenen Umschlagabsender erneut; ob eine Kopie einen Bounce erzeugt, sagt, ob ihr verändertes CBC-Padding gültig war, und etwa 2.000 Kopien entschlüsseln einen 16-Byte-Block (ein Padding-Orakel-Angriff). AES-GCM-Mail, die ohne Schlüsselableitung nach RFC 9709 gesendet wurde, kann unter demselben Schlüsseltransport als CBC neu verpackt werden, sodass das Orakel auch sie erreichen würde. Keine Einstellung der Stage gibt diese Antwort.
ON_DECRYPT_FAILURE = bounce-if-unproblematic behält den Bounce dort, wo er nichts preisgibt. Es erzeugt für eine Nachricht nur dann einen Bounce, wenn das fehlgeschlagene Chiffrat integritätsgeschützt ist — jeder OpenPGP-Container, den Pepsi akzeptiert, und S/MIME-AuthEnvelopedData —, weil dann jedes veränderte Chiffrat gleich fehlschlägt und der Absender nur erfährt, dass er es verändert hat. Der Container wird aus dem DER des Chiffrats gelesen, nie aus der Bezeichnung smime-type, die der Absender schreibt. Die Diagnose der DSN sagt nur, dass die Nachricht nicht entschlüsselt werden konnte; die Fehlerklasse (no-decryption-key, decryption-failed, malformed) geht für den Betreiber ins Log und in X-Pepsi-Crypto, nie in die DSN, da die Klasse, in die ein verändertes Chiffrat fällt, selbst ein Format-Orakel wäre. Jede andere fehlgeschlagene Nachricht (CBC, 3DES oder ein Container, den niemand identifizieren konnte) wird verworfen und protokolliert: Eine DSN oder ihr Ausbleiben wäre das Orakel. Das Verwerfen kostet den Absender einer legitimen CBC-Nachricht die Mitteilung, dass sie nicht gelesen wurde; mit passthrough wäre diese Nachricht stattdessen verschlüsselt zugestellt worden, weshalb passthrough der Standardwert bleibt.
ON_BAD_SIGNATURE = bounce wird ebenso behandelt. Ein CBC-Gadget kann einen verstümmelten Klartext signiert aussehen lassen, daher hängt bei Inhalt, der aus einem EnvelopedData-Container stammt, eine schlechte Signatur, und mit ihr der Bounce, vom Padding ab. Eine solche Nachricht wird stattdessen verworfen und protokolliert (Telemetrie decrypt-dropped); eine schlechte Signatur aus einem authentifizierten Container oder an einer nicht verschlüsselten Nachricht erzeugt weiterhin einen Bounce. pepsi-stage-reencrypt(1) wendet dieselbe Regel auf ON_NO_CLIENT_KEY = bounce an, dessen Bounce nur für eine Nachricht gesendet würde, die sich öffnen ließ.
Aus demselben Grund startet die Stage keine Schlüsselentdeckung für eine Signatur innerhalb von Inhalt, der aus einem Chiffrat ohne Integritätsschutz stammt (siehe Schlüsselentdeckung).
Ein Empfängerschlüssel, den dieser Host besitzt, aber nicht öffnen kann — ein Schlüsselverschlüsselungsschlüssel, der nicht zum gespeicherten Blob passt, ein verschwundenes secrets.d-Fragment, eine entzogene Datenbankberechtigung —, endet ebenfalls als decrypt-failure=no-decryption-key und nimmt die ON_DECRYPT_FAILURE-Route, genau wie eine Nachricht, die an einen Schlüssel adressiert ist, den wir nie hatten. Das ist Absicht (eine kaputte Identität darf nicht verhindern, dass die anderen versucht werden), aber es ist eine kaputte Installation und nicht das Werk des Absenders, daher wird jede solche Identität auf Stufe error mit der Adresse und dem Grund protokolliert. Dasselbe gilt für Empfänger, die Entschlüsselungsidentitäten auf einem Host besitzen, auf dem überhaupt kein [pepsi-crypto] KEY_WRAP_SECRET konfiguriert ist.
95.1.7.1.8. Fehler dieses Hosts¶
Alles andere, was auf diesem Host schiefgeht, wird erneut versucht statt fehlschlagen gelassen (siehe pepsi-dispatch(1)): Wenn die Datenbank nicht antworten kann, wird die Nachricht pausiert und bis zur MAX_LIFETIME der Stage erneut versucht. Das gilt auch für die Abfrage der eigenen MUA-Schlüssel der Empfänger, die nie als „kein solcher Schlüssel“ gelesen wird, da das Mail öffnen würde, die für den eigenen Client des Benutzers bestimmt ist. Der Abschnitt der Stage, die [pepsi]-Krypto-Richtlinie, [pepsi-keydiscovery] und, wenn ein Schlüsselverschlüsselungsschlüssel konfiguriert ist, der daraus gebaute Schlüsselbund werden beim Start des Workers geprüft: Funktioniert einer davon nicht, verweigert der Worker den Start (Exit 78), sodass der Dispatcher die Warteschlange zurückhält, statt jede Nachricht am selben Fehler scheitern zu lassen. Eine Nachricht, die die Kryptografie zum Absturz bringt (eine Panic beim Parsen), wird sofort fehlschlagen gelassen: Sie ist das Werk der Nachricht und würde nur erneut abstürzen.
95.1.7.1.9. Isolieren geschützter Inhalte¶
Bevor sie einen Schlüssel nachschlägt oder etwas öffnet, reduziert die Stage eine Nachricht für einen lokalen Empfänger auf ihren geschützten Inhalt. Zwei Regeln gelten, jede mit eigenem Schalter:
ISOLATE_ENCRYPTED = yes(der Standardwert)Wenn die Nachricht eine verschlüsselte Einheit – ein PGP/MIME-
multipart/encrypted, einenapplication/pkcs7-mime-Teil, der Chiffrat ist oder sein kann, oder einen inline-----BEGIN PGP MESSAGE------Block – neben beliebigem anderem Inhalt trägt, wird die erste verschlüsselte Einheit zur Nachricht, und alles andere wird in inerte Anhänge verschoben. Die behaltene Einheit wird zum Inhalt unter den ursprünglichen Header-Feldern der Nachricht; ein Inline-Block wird zu einemtext/plain-Teil, der nur das Armor enthält, und der Text, der ihn umgab, wird zu einem eigenen Anhang. Jeder verschobene Teil wird umgeschrieben zuapplication/octet-streammitContent-Disposition: attachment, einem bereinigten Dateinamen (dem des Absenders oderpart-N.html,message-N.eml,encrypted-N.ascund dergleichen), einerContent-Description, die sagt, dass Pepsi ihn verschoben hat und dass der Schutz der Nachricht ihn nicht abdeckt, und ohneContent-ID,Content-LocationoderContent-Base, sodass der Inhalt ihn nicht per Verweis zurückholen kann. Ein Teil, der bereits ein solcher Anhang ist, wird Byte für Byte behalten. Wir tun dies, um EFAIL-Direktexfiltration zu vermeiden: Ein Angreifer, der ein Chiffrat abgefangen hat, verpackt es zwischen zwei HTML-Teile, die eine Bild-URL öffnen und schließen, und ein Mail-Client, der den entschlüsselten Teil zusammen mit seinen Nachbarn darstellt, sendet den Klartext an den Server des Angreifers. Kein Client stellt einenapplication/octet-stream-Anhang inline dar, daher bleibt nichts, in das der Klartext eingefügt werden könnte, während ein echter Anhang weiterhin ankommt. Der eigenen Bezeichnung eines Absenders wird dafür nicht vertraut: Verbreitete Clients zeigen einentext/*-Teil inline, selbst wenn er als Anhang markiert ist, daher wird jeder verschobene Teil umgeschrieben (RFC 9787 Abschnitt 6.2.2 verlangt ebenso, dass ein entschlüsselter Teil, der in anderem Inhalt gefunden wird, von allem anderen getrennt gehalten wird). Weitere Chiffrate werden ebenfalls verschoben, da ein Angreifer die beiden HTML-Hälften an den öffentlichen Schlüssel des Empfängers verschlüsseln kann; ein Chiffrat, das als inerter Anhang ankam, wird nie zur Nachricht. Da die Reduktion vor der Entschlüsselung geschieht, schützt sie auch Mail, die die Stage nicht öffnet – eine Nachricht, für die sie keinen Schlüssel hält, oder eine, die an den eigenen MUA-Schlüssel des Benutzers verschlüsselt ist (Mail für den eigenen Schlüssel des Benutzers) –, deren Entschlüsselung dann ein Client vornimmt, der selbst verwundbar sein kann. Was zugestellt wird, ist unter Verschobene Teile dargelegt.ISOLATE_SIGNED = yes(der Standardwert)Wenn die Nachricht kein Chiffrat trägt, aber signierten Inhalt — ein
multipart/signed, ein opakes S/MIME-SignedDataoder einen inline klarsignierten Block — neben unsigniertem Inhalt, wird der unsignierte Inhalt verworfen (mehrere signierte Einheiten werden zusammen in einemmultipart/mixedbehalten). Wir tun dies, damit ein Signatururteil und die Markierung[verified]für alles sprechen, was der Benutzer sieht: Eine gültige Signatur an einem Teil darf ihr Urteil nicht einem Text leihen, den ein Fremder davor oder dahinter gesetzt hat.
Ein Signatur-Container, dessen einziger Inhalt das Chiffrat ist (signed(encrypted(body)), die dreifache Verpackung nach RFC 8551), ist Struktur, kein anderer Inhalt, und bleibt unangetastet. Eine angehängte Nachricht (message/rfc822, message/global) ist eine andere Nachricht, die ein Client für sich öffnet – und entschlüsselt. Daher wird unter ISOLATE_ENCRYPTED jede angehängte Nachricht, die eine verschlüsselte Einheit neben anderem Inhalt trägt, zuerst nach derselben Regel reduziert: Ihre erste verschlüsselte Einheit bleibt, alles andere wird zu inerten Anhängen in ihr, und sie bleibt eine angehängte Nachricht. Dies wird über drei Ebenen angehängter Nachrichten verfolgt; eine tiefer verschachtelte, die noch Chiffrat trägt, wird als Ganzes zu einem inerten .eml-Anhang. Die reduzierte angehängte Nachricht geht dann dorthin, wohin jeder andere Teil geht: Neben einem Chiffrat auf oberster Ebene wird sie in einen .eml-Anhang verschoben, der die reduzierte Form enthält, und unter ISOLATE_SIGNED wird sie verworfen. Eine Signatur über einen Container, der eine solche angehängte Nachricht enthält, verifiziert nicht, da dem Leser nicht gegeben wird, was signiert wurde. Die behaltene Entität behält ansonsten ihre eigenen Bytes, sodass eine Signatur darüber weiterhin verifiziert.
Beide Regeln werden erneut auf jeden Klartext angewendet, den die Stage gewinnt, sodass ein Chiffrat, das neben Angreiferteilen innerhalb eines anderen Chiffrats verschachtelt ist, oder ein teilweise signierter Klartext auf dieselbe Weise reduziert wird, bevor die nächste Schicht geöffnet wird, und die aus dem Klartext verschobenen Teile sich den anderen anschließen. Eine Reduktion wird als state.crypto.in.isolated (encrypted, signed) und als isolated= in X-Pepsi-Crypto festgehalten; wie viele verschobene Teile zugestellt und wie viele verworfen wurden, als demoted/dropped an beiden Stellen, und wie viele angehängte Nachrichten reduziert wurden, als nested.
95.1.7.1.9.1. Verschobene Teile¶
Was der Empfänger erhält, hängt davon ab, ob die Stage das behaltene Chiffrat öffnet, und davon, ob dieser Klartext signiert ist:
Geöffnet, unsigniert. Der Klartext ist der Inhalt, und jeder verschobene Teil folgt ihm als Anhang. Ein verschobenes Chiffrat wird mit denselben Schlüsseln geöffnet (bis zu 16 je Nachricht) und als sein Klartext zugestellt, wiederum als inerte Anhänge: Ein einteiliger Klartext behält den Dateinamen des Chiffrats ohne dessen Endung
.pgp,.gpg,.ascoder.p7m(report.pdf.pgpkommt alsreport.pdfan), ein mehrteiliger wird zu einem Anhang je Teil. Eines, das sich nicht öffnen lässt, wird als Chiffrat-Anhang zugestellt.Geöffnet, signiert. Die Signatur darf nicht scheinbar für das bürgen, was jemand anderes neben die Nachricht gelegt hat, daher werden verschobene Klartextteile verworfen, und ein verschobenes Chiffrat wird nur behalten, wenn sein eigener Klartext eine
valid- odervalid-untrusted-Signatur mit demselben Schlüssel wie die der Nachricht trägt. Das ist das verschlüsselte Gegenstück zuISOLATE_SIGNED: Unsignierter Inhalt wird nur dort verworfen, wo signierter und unsignierter Inhalt gemischt sind.Nicht geöffnet (kein Schlüssel, ein Fehlschlag oder der eigene MUA-Schlüssel des Benutzers). Ein PGP/MIME- oder S/MIME-Container wird allein zugestellt, an der Wurzel der Nachricht, wo Clients nach ihm suchen (Thunderbird öffnet S/MIME nur dort), und die verschobenen Teile werden verworfen. Die echten Anhänge eines Absenders liegen innerhalb eines solchen Containers, daher geht nur verloren, was um ihn herum hinzugefügt wurde, etwa eine Mailinglisten-Fußzeile. Ein Inline-Block behält die verschobenen Teile als Anhänge, denn so trägt Inline-PGP Dateien.
Eine Nachricht, deren Signiererschlüssel gerade nachgeschlagen wird (siehe Schlüsselentdeckung), wird nicht als Klartext festgeschrieben, solange sie verschobene Teile hat, da vom Urteil abhängt, welche davon bleiben dürfen; sie wird erneut entschlüsselt, wenn sie fortgesetzt wird.
Die Regeln kosten in zwei Fällen weiterhin Inhalt, weshalb jede abgeschaltet werden kann: Eine Mailinglisten-Fußzeile, die außerhalb einer Signatur angehängt wird oder um einen Container herum, den dieser Host nicht öffnet, geht verloren; und eine Klartextnotiz neben einer separat verschlüsselten Datei wird nur behalten, wenn die Notiz unsigniert ist. Mail für Empfänger, die dieser Host nicht bedient, wird nie reduziert (sie wird so weitergeleitet, wie sie ankam, siehe Lokalität).
95.1.7.1.10. Mail für den eigenen Schlüssel des Benutzers¶
Ein Benutzer kann seinen eigenen Schlüssel registrieren, dessen privater Teil nur in seinem Mail-Client liegt (ein MUA-Schlüssel, crypto_identity.custody = client; siehe pepsi-stage-encrypt(1) und pepsi-keys(1)). Mail, die an einen solchen Schlüssel verschlüsselt ist, ist für den Mail-Client bestimmt, und die Stage erkennt sie, bevor sie versucht, irgendetwas zu öffnen: Sie liest die Empfängerkennungen des Chiffrats (OpenPGP-PKESK-Schlüssel-IDs, S/MIME-RecipientIdentifiers), ohne zu entschlüsseln, und gleicht sie mit den nicht widerrufenen Client-Schlüsseln der Empfänger ab. Eine Platzhalter-Schlüssel-ID („verborgener Empfänger“) passt auf nichts und nimmt den gewöhnlichen Pfad.
Bei einem Treffer wird die Nachricht ungeöffnet weitergereicht, selbst wenn auch einer unserer eigenen MTA-Schlüssel unter ihren Empfängern ist: Der Benutzer hat seinen eigenen Schlüssel registriert, um Ende-zu-Ende-Schutz zu erhalten, und eine Kopie auf dem Server zu öffnen und den Klartext im Postfach abzulegen, würde dies stillschweigend zunichtemachen. Die Stage hält state.crypto.in.decryption = for-client, for_client = true und client_fingerprint fest, setzt state.encrypted und fügt for-client=yes zu X-Pepsi-Crypto hinzu. Dies ist kein Entschlüsselungsfehler, daher wird ON_DECRYPT_FAILURE nicht herangezogen, und die Nachricht schaltet wie jede andere zu NEXT_STAGE weiter: Die Spam-Prüfungen und der Rest der Pipeline entscheiden weiterhin über ihr Schicksal. Eine Nachricht mit mehreren lokalen Empfängern wurde bereits auf einen Datensatz je Empfänger aufgeteilt (siehe oben), daher sagt der Client-Schlüssel eines Empfängers nichts über die Kopie eines anderen aus.
Die Folge ist, dass serverseitige Funktionen nicht in solche Mail hineinsehen können. Inhaltslesende Stages (etwa die Spracherkennung) sehen Chiffrat und fallen zurück, wie sie es bei jeder nicht entschlüsselbaren Nachricht tun, und es wurde nichts verifiziert, sodass state.signature_verified nie gesetzt wird und ein Whitelist-Eintrag mit signature_required nicht auf sie passt.
95.1.7.1.11. Fälschungsabwehr¶
Jedes X-Pepsi-*-Header-Feld wird aus jeder Nachricht entfernt, die diese Stage sieht — auch aus einer, die sie nicht anfassen wird, und auch aus einer, für die die Stage deaktiviert ist. Erst dann wird unser eigenes hinzugefügt. Die eine Ausnahme ist X-Pepsi-Warning im äußeren Header-Block: pepsi-ingress(1) schreibt es erst, nachdem es jede Kopie entfernt hat, die ein Absender geschrieben hat, daher wird es für den Leser behalten (eine Kopie innerhalb entschlüsselten Inhalts wird mit dem Rest entfernt).
X-Pepsi-Crypto ist ein privater Header, also definitionsgemäß fälschbar; die bedingungslose Entfernung ist die gesamte Grundlage dafür, dass ein Client ihm glauben darf. Der Pepsi-Origin-Herkunftsnachweis-Header liegt bewusst nicht im Namensraum und überlebt.
Dasselbe Argument gilt für das Subject. Mit STRIP_SUBJECT_TAGS = yes (dem Standardwert) wird alles, was als Sicherheitsindikator angezeigt würde, vom Anfang eines eingehenden Betreffs entfernt, bevor unseres vorangestellt wird; andernfalls schreibt ein externer Absender [verified] einfach selbst. Der Betreff wird danach beurteilt, was ein Mail-Client anzeigt, nicht nach seinen Bytes:
RFC-2047-Encoded-Words werden zuerst dekodiert, sodass
=?UTF-8?B?W3ZlcmlmaWVkXQ==?=als[verified]zählt;Text wird anhand seines Skeletts verglichen: kompatibilitätszerlegt (Klammern voller Breite werden zu ASCII), ohne Akzente, jedes Zeichen auf seinen Prototyp aus den vollständigen Confusables-Daten des Unicode Technical Standard #39 gefaltet (Doppelgänger aus Kyrillisch, Griechisch, Armenisch, Cherokee und jeder anderen Schrift;
mwird alsrngelesen), Kapitälchen und Ziffernersetzungen auf den Buchstaben gefaltet, den sie nachahmen, und in Kleinbuchstaben;entfernt werden das eigene Markierungsvokabular dieser Stage (jede
TAG_*-Option, die eingebauten[decrypted],[verified],[decrypted, unauthenticated],[unverified signer],[bad signature]und[verified (except reply-to)], die Adressform[verified: …]als Ganzes, wie lang ihre Adresse auch ist, undSTRIP_SUBJECT_KEYWORDS), abgeglichen nach Skelett; jede eingeklammerte Gruppe, in ASCII- oder Unicode-Klammern, die ein Wort enthält, das ein Sicherheitswort ist oder einen Buchstaben davon entfernt (verified,decrypted,encrypted,signed,signature,secure,trusted,authenticund ihre nahen Formen), oder ein Wort unserer eigenen Markierungen; eine führendeVerified:-artige Behauptung; Häkchen-, Vorhängeschloss-, Schlüssel- und Schildsymbole; und unsichtbare Zeichen (Zeichen mit Nullbreite, Byte-Order-Marks, weiche Trennstriche);bidirektionale Einbettungs-, Überschreibungs- und Isolationssteuerzeichen werden aus dem ganzen Betreff entfernt, da sie Text an beliebiger Stelle der Zeile als Markierung an ihrem Anfang darstellen lassen können.
Markierungen werden vom Anfang des Betreffs entfernt, hinter Re:/Fwd:-Präfixen und hinter fremden eingeklammerten Gruppen wie einer Mailinglisten-Markierung; ein Betreff, der [verified] mitten im Satz erwähnt, behält es. Die Regel irrt zugunsten des Entfernens: Ein legitimer Betreff, der mit [Signed contract] beginnt, verliert dieses Präfix. Dieselbe Bereinigung wird auf den Betreff des eigenen Header-Blocks einer entschlüsselten Nachricht angewendet (ein geschützter Betreff ersetzt den äußeren) und auf Mail, die für den eigenen Schlüssel des Benutzers ungeöffnet durchgereicht wird. Ein Betreff, der keine Änderung braucht, bleibt Byte für Byte erhalten.
95.1.7.1.13. Der Ergebnis-Header¶
Mit ADD_RESULT_HEADER = yes (dem Standardwert) erhält eine Nachricht, die irgendeinen Schutz trug, ein Header-Feld, ganz oben vorangestellt, sodass es keine bestehende Signatur stört:
X-Pepsi-Crypto: encrypted=yes; decrypted=yes; protocol=openpgp;
signature=valid; signer=alice@example.net;
fingerprint=0123456789ABCDEF; key-source=wkd; trust=wkd;
layers="encrypted,signed"
Die Grammatik sind durch Semikola getrennte key=value-Paare in fester Reihenfolge. Ein Wert, der kein nacktes Token ist (A–Z, a–z, 0–9 und . _ @ : + / -), wird in doppelte Anführungszeichen gesetzt; ein eingebettetes " wird zu ', und Steuerzeichen werden durch Leerzeichen ersetzt, sodass kein Wert aus der Nachricht das Feld beenden oder ein anderes beginnen kann. Lange Werte werden an Leerraum gefaltet.
Die Schlüssel sind:
encryptedyes/no— die Nachricht kam mit Chiffrat an. Was zählt, ist der Paketstrom, nicht die Bezeichnung: Ein armiertesPGP MESSAGE(oder einmultipart/encrypted-Inhalt), das nur ein Literal- oder signiertes OpenPGP-Paket enthält, öffnet sich ohne jeden Schlüssel, sein Inhalt wird zugestellt, und es wird alsencrypted=nogemeldet, ohne[decrypted]-Markierung und ohne eine Identität, die als öffnende festgehalten wird. Eine Signatur darin wird weiterhin verifiziert.decryptedyes/no— nur vorhanden, wennencrypted=yes.for-clientyes, wenn die Nachricht an den eigenen MUA-Schlüssel des Empfängers verschlüsselt ist und ungeöffnet durchgereicht wurde (Mail für den eigenen Schlüssel des Benutzers).protocolopenpgpodersmime.containerDer Inhaltsverschlüsselungs-Container des geöffneten Chiffrats, wie der Entschlüsseler ihn aus den Bytes gelesen hat:
auth-enveloped-dataoderenveloped-data(S/MIME),seipdv2-aeadoderseipdv1-mdc(OpenPGP). Nurenveloped-datafehlt der Integritätsschutz. Vorhanden, wenn ein Chiffrat geöffnet wurde.signatureEines der obigen Urteile.
signer,fingerprint,key-source,trust,algorithmDer Signaturschlüssel, woher er kam und was er wert war.
key-sourceundtrusttragen beide das Herkunftswort des Verifizierers (anchor,dane,wkd,pinned,autocrypt,attachedoderunknown). Nur vorhanden, wenn bekannt.bindingWie sich der Schlüssel des Signierers zur
From:-Adresse verhielt, wie der Verifizierer sie sah:matched,mismatchedoderno-identity(der Schlüssel nennt keine Adresse). Vorhanden, wenn ein Schlüssel gefunden wurde.anchorDer Fingerabdruck des
ca_trust-Ankers, bei dem die Kette des Signierers endete. Vorhanden bei einer verankerten S/MIME-Signatur.bound-toDie Adresse, an die eine
valid-Signatur gebunden ist — dieFrom:-Adresse, wie geschrieben, die die Markierung nennt. Nur beivalidvorhanden.signed-atDie Erstellungszeit, die die Signatur angibt, als UTC-Zeitstempel nach RFC 3339 (
2026-10-20T09:00:00Z). Vorhanden, wenn die Signatur eine trägt. Es ist die Angabe des Signierers, nur mit der Ankunftszeit dieses Hosts verglichen (MAX_SIGNATURE_AGE_DAYS).withheldWarum eine Signatur, die verifiziert hat,
valid-untrustedstattvalidist:ciphertext-cover,protected-from,protected-subject,reply-to,no-identity,display-name,multiple-from,lookalike-domain,old-signatureoderfuture-signature(Wofür valid vergeben wird). Nur dann vorhanden.unsigned-surfaceWarum ein verifizierter klarsignierter Block
partialist:armor-headersoderhtml. Nur dann vorhanden.reply-tounsigned, wenn die Signaturvalidist und das äußereReply-To:(oderMail-Reply-To:,Mail-Followup-To:) von einer Mailingliste außerhalb davon hinzugefügt wurde (die Markierung[verified (except reply-to)]). Nur dann vorhanden.signer-domainDie Domain des Signierers als A-Label, wenn sie ein internationalisierter Domainname ist oder wie eine bekannte aussieht. Nur dann vorhanden.
usually-signedDas Datum (UTC,
YYYY-MM-DD), an dem einevalid-Signatur derFrom:-Adresse zuletzt verifiziert wurde, bei einer Nachricht, die keine trägt (Korrespondenten, die üblicherweise signieren). Nur dann vorhanden; eine Nachricht, die nur diesen Schlüssel hätte, erhält den Header ebenfalls.failureDer maschinenlesbare Grund, warum ein Signatururteil nicht gut ist.
decrypt-failureDer maschinenlesbare Grund, warum die Entschlüsselung fehlschlug.
unauthenticatedyes, wenn der Klartext aus einem Container ohne Integritätsschutz stammt und keine gültige Signatur ihn abdeckt (Klartext aus einem formbaren Container). Nur dann vorhanden.sanitisedtext, wenn der Klartext auf Inhalt reduziert wurde, den kein Client als Markup darstellt (UNAUTHENTICATED_PLAINTEXT = textoderDECRYPTED_MARKUP = textfür jeden entschlüsselten Klartext). Nur dann vorhanden.isolatedWelche Regeln aus Isolieren geschützter Inhalte die Nachricht verändert haben (
encrypted,signed), durch Kommas getrennt. Nur vorhanden, wenn eine es tat.protected-mismatchDie signierten geschützten Header-Felder (
from,to,reply-to,mail-reply-to,mail-followup-to,subject), die von den äußeren abweichen, durch Kommas getrennt (siehe Geschützte Header). Nur vorhanden, wenn eines abweicht.subjectprotected, wenn das geschützteSubject:des Signierers anstelle eines unterwegs veränderten äußeren gezeigt wurde. Nur dann vorhanden.demoted,droppedWie viele Teile, die die Isolation aus der Nachricht verschoben hat, als Anhänge zugestellt wurden und wie viele nicht (siehe Verschobene Teile). Nur vorhanden, wenn nicht null.
nestedWie viele angehängte Nachrichten, die Chiffrat neben anderem Inhalt trugen, reduziert wurden (Isolieren geschützter Inhalte). Nur vorhanden, wenn nicht null.
layersDie Schutzschichten, von außen nach innen, kommagetrennt.
RFC 8601 registriert keine smime- oder pgp-Methode, sodass eine Authentication-Results-Erweiterung hieße, einen Methodennamen in einem Register zu erfinden, das uns nicht gehört, und andere Implementierungen dürften einen solchen Namen ignorieren oder ihm misstrauen. Ein privater Header mit dokumentierter Grammatik ist die ehrliche Wahl, und der Preis dafür ist das oben beschriebene bedingungslose Entfernen.
95.1.7.1.14. Klartext aus einem formbaren Container¶
Ein S/MIME-EnvelopedData-Container (AES-CBC oder 3DES, wo [pepsi] CRYPTO_ALLOW_DOWNGRADE es zulässt) schützt nichts als die Vertraulichkeit. Wer eine Kopie des Chiffrats hält, kann seinen Klartext Block für Block umschreiben – die CBC-Gadgets von EFAIL – und, wenn er einen Klartextblock kennt oder errät, ein HTML-Element bauen, dessen URL die folgenden Blöcke in sich aufnimmt, sodass ein Client, der das Ergebnis darstellt, den Klartext an den Angreifer sendet. Die Stage muss solche Container lesen (die meiste S/MIME-Mail verwendet sie noch), und Isolation hilft nicht, weil das Umschreiben innerhalb der einen verschlüsselten Einheit geschieht, die behalten wird. Was die Stage nicht tut, ist, einem Client Markup zu übergeben, für das sie nicht bürgen kann.
Ein Klartext aus einem solchen Container ist abgedeckt, wenn eine gültige Signatur innerhalb des Containers für ihn spricht – valid oder valid-untrusted; der Wert des Schlüssels spielt keine Rolle, da ein Umschreiben jede Signatur bricht. Eine Signatur um das Chiffrat herum zählt nicht: Ein Angreifer signiert das umgeschriebene Chiffrat mit einem eigenen Schlüssel neu. Ein abgedeckter Klartext wird so zugestellt, wie er ist. Ein nicht abgedeckter wird behandelt, wie UNAUTHENTICATED_PLAINTEXT es sagt:
text(der Standardwert)Jeder Teil, den ein Client als Markup darstellen würde –
text/html,text/enrichedund die anderentext/*-Typen,application/xhtml+xml, auch innerhalb einer angehängten Nachricht –, wird mit beibehaltenem Zeichensatz alstext/plainneu bezeichnet und verliert seineContent-ID,Content-LocationundContent-Base; einmultipart/alternative, das eine Klartextalternative anbietet, wird auf diese reduziert. Klartext, Bilder, Dateien und Signaturen behalten ihre Bytes, und ein Teil, dessen Inhalt sich nicht ändert, wird nicht umgeschrieben, sodass eine Signatur darüber im Client weiterhin verifiziert. Der Text kommt an, nichts wird dargestellt, und die HTML-Formatierung unsignierter CBC-Mail geht verloren. DasSubjectwird mitTAG_UNAUTHENTICATED([decrypted, unauthenticated]) anstelle vonTAG_DECRYPTEDmarkiert, undX-Pepsi-Cryptosagtunauthenticated=yes; sanitised=text.require-signatureDie Nachricht wird ungeöffnet weitergereicht, wie sie ankam, für den eigenen Mail-Client des Benutzers, der dann den S/MIME-Container sieht und seine eigenen EFAIL-Abwehrmaßnahmen anwendet.
decryptionlautetwithheld, keine Identität wird als öffnende festgehalten, nichts wird markiert, undON_DECRYPT_FAILUREwird nicht herangezogen: Es ist kein Fehlschlag. Unsignierte CBC-Mail an einen Benutzer ohne Client-Schlüssel kommt unlesbar an, was der Preis der Einstellung ist.openDer Klartext wird so zugestellt, wie er aus dem Container kam, Markup eingeschlossen, für eine Installation, die das Risiko in Kauf nimmt. Er wird weiterhin mit
TAG_UNAUTHENTICATEDmarkiert und alsunauthenticated=yesfestgehalten.
OPEN_ENVELOPED_DATA = no geht einen Schritt weiter und öffnet einen EnvelopedData-Container überhaupt nicht, ob signiert oder nicht: Die Nachricht wird so weitergereicht, wie sie ankam, genau wie bei require-signature (decryption lautet withheld, kein Fehlschlag), und kein privater Schlüssel wird auf sie angewendet. Der Bezeichner des Inhaltsverschlüsselungsalgorithmus des Containers ist nicht authentifiziert, daher kann ein Angreifer, der eine AES-GCM-Nachricht an einen unserer Benutzer hält, die ohne Schlüsselableitung nach RFC 9709 gesendet wurde, ihre RecipientInfo unter einem synthetischen AES-CBC-Container erneut einreichen; ihn zu öffnen wendet den Inhaltsschlüssel der GCM-Nachricht auf ein Chiffrat aus der Hand des Angreifers an. Mit abgeschalteter Option wird dieser Schlüssel nie für etwas anderes verwendet als den AEAD-Container, mit dem er kam. Die Option hat den Standardwert yes (öffnen), weil die meisten S/MIME-Clients noch nichts als EnvelopedData senden. Wie jede Option dieses Abschnitts kann sie über eine address:- oder domain:-Überlagerung (pepsi-config(1)) für eine Empfängeradresse oder Domain gesetzt werden, sodass ein Benutzer, dessen Korrespondenten alle AuthEnvelopedData senden, CBC seinem Client überlassen kann, während alle anderen es weiterhin geöffnet bekommen. Es gibt keinen Schalter je Korrespondent: Der Absender des Containers ist nur aus dem äußeren From: bekannt, und genau das lässt ein zusammengefügtes oder neu bezeichnetes Chiffrat den Angreifer schreiben.
95.1.7.1.14.1. Markup in entschlüsselter Mail¶
Ein authentifizierter Klartext – aus einem integritätsgeschützten Container oder einer, den eine gültige Signatur abdeckt – wird so zugestellt, wie er herauskam, HTML eingeschlossen (DECRYPTED_MARKUP = keep, der Standardwert). Niemand kann ihn umgeschrieben haben, aber er kann weiterhin entfernte Inhalte laden: Ein Bild, ein Stylesheet, eine Schrift vom Server des Absenders sagt dem Absender, wann und ungefähr wo die Nachricht gelesen wurde, und CSS kann den Client per Fingerprinting erkennen. Das zu blockieren ist Aufgabe des Mail-Clients und wiegt hier schwerer als bei gewöhnlicher Mail: Wenn das Gateway eine Nachricht entschlüsselt hat, kann der Client nicht erkennen, dass sie verschlüsselt war, und ein Client, der entfernte Inhalte nur in verschlüsselter Mail blockiert, blockiert sie in dieser nicht. Das Kapitel des Handbuchs über Mail-Clients führt die Einstellungen auf. DECRYPTED_MARKUP = text nimmt dem Client die Wahl ab: Jeder entschlüsselte Klartext wird genau so reduziert, wie UNAUTHENTICATED_PLAINTEXT = text einen nicht authentifizierten reduziert, festgehalten als sanitised=text, um den Preis der Formatierung jeder verschlüsselten Nachricht; eine Signatur über einen neu bezeichneten Teil verifiziert im Client nicht. Die Kosten trägt der Leser, weshalb es eine Option ist, die einem Benutzer je Adresse gegeben werden kann.
Ein Container, dessen Inhaltsverschlüsselungsalgorithmus id-alg-cek-hkdf-sha256 nach RFC 9709 ist, wird geöffnet, gleich welcher Art er ist: Der Schlüssel, den die RecipientInfo liefert, wird vor der Verwendung mit HKDF-SHA256 über den echten Algorithmusbezeichner (Chiffre, IV oder Nonce) geleitet, sodass derselbe gelieferte Schlüssel unter einem anderen Algorithmus einen anderen Inhaltsschlüssel ergibt. Der Algorithmus der Schicht lautet dann zum Beispiel aes-256-gcm+cek-hkdf-sha256. Pepsi leitet Schlüssel auf diese Weise für einen Korrespondenten ab, dessen eigene signierte SMIMECapabilities den Bezeichner nennen, und kündigt ihn in seinen eigenen Signaturen an.
Inhalt aus einem AEAD-Container – S/MIME-AuthEnvelopedData, jeder OpenPGP-Container, den diese Stage akzeptiert – ist nie betroffen: Ein umgeschriebenes Chiffrat lässt sich überhaupt nicht öffnen. Welchen Weg ein nicht abgedeckter Klartext nimmt, sieht nur der Empfänger, daher ist die Entscheidung kein Padding-Orakel für den Absender; eine gebrochene innere Signatur einer umgeschriebenen Nachricht wird weiterhin als invalid gemeldet und von ON_BAD_SIGNATURE behandelt. Der Container wird in X-Pepsi-Crypto (container=) und in state.crypto.in.layers für jedes geöffnete Chiffrat genannt.
95.1.7.1.15. Schlüsselentdeckung¶
Die Stage betreibt überhaupt keine Netzwerk-E/A. Wenn der Schlüssel des Signierenden weder in der Nachricht noch im peer_key-Cache liegt, reiht sie eine Entdeckungsanfrage ein und parkt die Nachricht; ein pepsi-keydisc(1)-Dienst gibt sie frei, wenn sich die Anfrage erledigt, gefunden oder nicht, und die Stage läuft erneut. Eine erledigte Anfrage ohne Schlüssel gibt die Nachricht genauso frei, und sie verifiziert dann als unverifiable. Gibt es einen frischen Negativ-Cache-Eintrag, wartet die Nachricht gar nicht. Das verhindert, dass ein Spammer, der mit einem unbekannten Schlüssel signiert, jede Nachricht warten lässt: Die erste parkt, der Rest nicht.
[pepsi-keydiscovery] INBOUND_TIMEOUT begrenzt die Wartezeit und ist getrennt vom ausgehenden TIMEOUT einstellbar; DISCOVERY_TIMEOUT im eigenen Abschnitt dieser Stage überschreibt es. DISCOVERY = no unterdrückt die Anfrage ganz und lässt die Stage auf dem Nur-Cache-Pfad.
Für eine Signatur innerhalb von Inhalt, der aus einem Chiffrat ohne Integritätsschutz stammt (S/MIME-EnvelopedData, AES-CBC oder 3DES, wie der Entschlüsseler es im DER fand), wird keine Entdeckung gestartet. Ein CBC-Gadget lässt einen Angreifer einen verstümmelten Klartext nur dann signiert aussehen lassen, wenn sein Padding gültig ist, und die Abfrage geht an die From:-Domain, die der Angreifer wählt; die WKD-Anfrage oder DNS-Abfrage käme genau dann bei seinem Server an, wenn das Padding gültig war. Den Schlüssel nicht nachzuschlagen, beseitigt dieses Signal vollständig. Bereits zwischengespeicherte Schlüssel und Zertifikate, die die Nachricht trägt, werden weiterhin verwendet, daher beschränken sich die Kosten auf CBC-verschlüsselte Mail, die mit einem Schlüssel signiert ist, der weder zwischengespeichert noch angehängt ist und die als unverifiable zugestellt wird.
Ob eine geparkte Nachricht entschlüsselt gespeichert wird, hängt von der Form der Nachricht ab, und der Unterschied zählt:
Eine S/MIME-Signatur, die in einem Umschlag verschachtelt ist, überlebt die Entschlüsselung als gewöhnliche MIME-Schicht, sodass die Nachricht mit festgeschriebenem Klartext geparkt und genau einmal entschlüsselt wird.
Eine OpenPGP-Signatur lebt nur innerhalb des Paketstroms und ist fort, sobald der Klartext heraus ist. Den Klartext zu committen zerstörte den Beleg, für dessen Prüfung der Schlüssel geholt wird, sodass eine solche Nachricht unverändert geparkt und beim Fortsetzen erneut entschlüsselt wird.
Eine mit committetem Klartext geparkte Nachricht liegt bis zur Entdeckungsfrist entschlüsselt in pepsi.workqueue. Das ist dieselbe Blöße, die die Zustellung einen Augenblick später ohnehin erzeugte; es ist ein längeres Fenster, kein neues.
95.1.7.1.16. Zertifikate, die die Nachricht mitführt¶
Die meiste signierte Mail führt das Zertifikat mit, das sie signiert hat, sodass die Stage, bevor sie etwas entscheidet, die S/MIME-Signiererzertifikate und application/pgp-keys-Teile aus der Nachricht liest und dem Verifizierer anbietet. Sie tut das erneut auf dem Klartext, sobald die Nachricht offen ist, denn ein innerhalb des Chiffrats angehängtes Zertifikat ist bis dahin unsichtbar, und bewertet einmal neu, falls das etwas ergab, was der erste Durchgang nicht hatte.
Diese Zertifikate werden benutzt und verworfen. Diese Stage speichert nichts: Aus eingehender Mail zu lernen — der Autocrypt:-Header, angehängte Schlüssel und Gossip — ist Sache von pepsi-stage-autocrypt-learn(1), das später in der Pipeline läuft, nach den Stages, die entscheiden, ob eine Nachricht Spam ist. Diese Trennung ist das, was die Spam-Regel von Autocrypt Level 1 §5.3 überhaupt einhaltbar macht: Diese Stage läuft konstruktionsbedingt zuerst auf dem eingehenden Pfad, bevor irgendein solches Urteil existiert. Es bedeutet auch, dass nichts von dem Prozess in den Schlüsselspeicher geschrieben wird, der die privaten Schlüssel hält.
Ein Zertifikat zu verwenden, das die Nachricht mitführte, kann das Ansehen eines Urteils immer nur senken, nie heben: Solches Material hat nicht vertrauenswürdige Herkunft, sodass eine dagegen geprüfte Signatur als valid-untrusted zurückkommt und state.signature_verified nicht setzt , das State-Feld, das pepsi-stage-check-whitelist(1) als Schranke verwendet. Das ist dieselbe Sprosse, die ein gespeicherter geernteter Schlüssel hätte, sodass es nichts einbrächte, ihn durch die Datenbank zu leiten. Was einen S/MIME-Signierer heben kann, ist ein Pfad zu einem Anker (siehe Vertrauensanker): Ein in der Nachricht mitgeführtes oder aus einer früheren gelerntes Zertifikat, das zu einem pepsi.ca_trust-Anker führt, ist valid kraft der Autorität des Ankers, nie aus eigener.
95.1.7.1.17. Zwei Tatsachen, die für die Lern-Stage festgehalten werden¶
Das Entschlüsseln committet den Klartext über die angekommenen Bytes, sodass zwei Dinge, die nur diese Stage sehen kann, für pepsi-stage-autocrypt-learn(1) in state.crypto.in geschrieben werden: encrypted, dass die Nachricht überhaupt Chiffrat trug, und outer_gossip, dass der ankommende Header-Block bereits ein Autocrypt-Gossip:-Feld hatte. Beides sind Voraussetzungen dafür, dem Gossip einer Nachricht zu glauben, und keines ist beantwortbar, sobald der Klartext im Datensatz steht.
95.1.7.1.18. Die Schlüssel unserer eigenen Benutzer werden nie überschrieben¶
Schlüssel werden unter der From:-Adresse geerntet, die der Absender schreibt, und die eingehende Authentifizierung ist bewusst fail-open. Eine Nachricht, die vorgibt, von einem der eigenen Benutzer dieser Installation zu kommen, säet daher für diesen Benutzer einen peer_key-Datensatz mit dem Schlüssel, den sie mitführte — und eine dagegen geprüfte Signatur würde sonst verifizieren und state.signature_verified setzen, das pepsi-stage-check-whitelist(1) als Schranke verwendet.
Bevor der Speicher herangezogen wird, fragt die Stage daher, ob der behauptete Absender jemand ist, für den sie eine Identität hält. Ist er es, ist der öffentliche Schlüssel dieser Identität der einzige Kandidat: Dem Verifizierer wird kein peer_key-Datensatz für die Adresse angeboten, gleich welchen Rangs und gleich wie er eintraf. Alles außer einer revoked-Identität zählt, abgelaufene eingeschlossen — eine letztes Jahr erstellte Signatur wurde mit dem letztjährigen Schlüssel erstellt, und sich zu weigern, sie anzusehen, meldete die Mail unserer eigenen Benutzer jedes Mal als unverifizierbar, wenn ein Schlüssel rotiert wurde.
Die Regel hängt daran, einen Schlüssel zu halten, nicht daran, die Adresse zu bedienen: Ein Benutzer, der seinen eigenen OpenPGP-Client betreibt und hier nie einen Schlüssel hochgeladen hat, hat keine Identität, sodass sein geernteter oder gegossipter Schlüssel genau so verwendet wird wie der jedes Korrespondenten. Der Preis ist das Spiegelbild — sobald für eine Adresse eine Identität gehalten wird, verifiziert eine mit dem separaten persönlichen Schlüssel dieses Benutzers erstellte Signatur nicht mehr. Siehe Die Schlüssel unserer eigenen Benutzer werden nicht entdeckt im Handbuch.
95.1.7.1.19. Vertrauensanker¶
X.509-Anker stammen aus der Tabelle pepsi.ca_trust (pepsi-keys(1) ca) und werden je Worker-Prozess für TRUST_ANCHOR_TTL (Standardwert fünf Minuten) zwischengespeichert. Ein hinzugefügter oder deaktivierter Anker wird daher innerhalb dieses Fensters wirksam; starten Sie die Worker neu, um ihn sofort anzuwenden. Sie werden träge geladen und nur für eine Nachricht, die tatsächlich eine S/MIME-Schicht trägt, sodass gewöhnlicher Verkehr keine Abfrage kostet.
Widerrufsdaten werden von der Stage nicht abgerufen: Ein CRL-Abruf wäre Netzwerk-E/A in einer Stage, und genau die soll das Entdeckungsdesign vermeiden. Stattdessen ruft pepsi-keydisc(1) die CRLs, die zwischengespeicherte S/MIME-Peer-Zertifikate nennen, in pepsi.crl_cache ab, und die Stage liest die aktuellen mit den Ankern (verzögert, nur für eine S/MIME-Schicht, hinter derselben TRUST_ANCHOR_TTL). Eine Liste zählt für ein Zertifikat nur, wenn der Schlüssel des Ausstellers sie signiert hat, sie aktuell ist und ihr Geltungsbereich das Zertifikat abdeckt; eine aufgeführte Seriennummer macht die Signatur invalid (Fehlschlag revoked). Jede von solchen Listen abgedeckte Kette wird als not-revoked gemeldet. Alles Geringere – keine Liste für ein Zertifikat der Kette, eine veraltete oder nicht verifizierbare, ein Cache, der nicht gelesen werden kann – wird als Widerruf not-checked gemeldet, was ausdrücklich gesagt wird, statt „nicht widerrufen“ nahezulegen: Die Widerrufsprüfung scheitert weich.
Ein Pfad wird aus den Ankern, den Zertifikaten, die die Nachricht mitführte, den zwischengespeicherten Schlüsseln des Absenders und, unter [pepsi-keydiscovery] CA_ISSUERS_FETCH, den Zwischen-CA-Zertifikaten gebaut, die pepsi-keydisc(1) aus den caIssuers-Verweisen zwischengespeicherter Zertifikate in pepsi.ca_issuer_cache abgerufen hat (gelesen wie die Listen, verzögert und hinter TRUST_ANCHOR_TTL). Ein abgerufenes Zertifikat wird zuletzt durchsucht, nur als Aussteller – nie als Signierer, nie als Anker –, sodass es die Kette eines Signierers vervollständigen kann, der keine Zwischenzertifikate gesendet hat, und sonst nichts tun kann. Ein Zertifikat eines Absenders, das der Schlüsselspeicher aus dessen Mail gelernt hat, beendet die Suche ebenfalls nicht: Es wird wie eines, das die Nachricht mitführte, gegen die Anker validiert, und sein gelerntes Ansehen (valid-untrusted) wird nur gemeldet, wenn kein Pfad einen Anker erreicht.
95.1.7.1.20. Konfiguration¶
Die Stage liest ihren eigenen [stage-<name>]-Abschnitt (PROGRAM = pepsi-stage-decrypt, NEXT_STAGE (erforderlich), BOUNCE_STAGE, dazu ENABLED, LOCAL_DOMAINS, TARGETS, RECIPIENT_DELIMITER, REQUIRE_ACCOUNT, ON_DECRYPT_FAILURE, ON_BAD_SIGNATURE, ON_MISSING_SIGNATURE, MISSING_SIGNATURE_WINDOW_DAYS, TAG_MISSING_SIGNATURE, MAX_SIGNATURE_AGE_DAYS, UNAUTHENTICATED_PLAINTEXT, DECRYPTED_MARKUP, OPEN_ENVELOPED_DATA, QUARANTINE_STAGE, SUBJECT_TAGS, TAG_DECRYPTED, TAG_VERIFIED, TAG_VERIFIED_EXCEPT_REPLY_TO, TAG_UNAUTHENTICATED, TAG_BAD_SIGNATURE, TAG_BAD_SIGNATURE_ENCRYPTED, TAG_UNVERIFIED_SIGNER, STRIP_SUBJECT_TAGS, STRIP_SUBJECT_KEYWORDS, ADD_RESULT_HEADER, ISOLATE_ENCRYPTED, ISOLATE_SIGNED, MAX_LAYERS, TRUST_ANCHOR_TTL, DISCOVERY, DISCOVERY_TIMEOUT), alle dokumentiert in pepsi.conf(5). pepsi-setup(1) verlangt ein BOUNCE_STAGE, sobald ON_BAD_SIGNATURE bounce oder ON_DECRYPT_FAILURE bounce-if-unproblematic lautet, und ein QUARANTINE_STAGE, sobald eine von ON_DECRYPT_FAILURE, ON_BAD_SIGNATURE und ON_MISSING_SIGNATURE quarantine lautet. Ohne ein BOUNCE_STAGE lässt ein Bounce-Weg die Nachricht stattdessen fehlschlagen. Eine Zeile mit mehreren Empfängern wird vor dem Bounce aufgeteilt, und jede Kopie kehrt zu dieser Stage zurück, damit eine DSN über jeden Empfänger berichtet und das NOTIFY jedes Empfängers beachtet. Eine zum QUARANTINE_STAGE geleitete Nachricht hält ihren entschlüsselten Klartext, solange sie dort wartet; pepsi-queue(1) gc erzeugt für eine, die [pepsi-queue] QUARANTINE_MAX_AGE_DAYS (Standardwert 14) nach ihrem Eintreffen noch wartet, einen Bounce ohne ihren Inhalt – es sei denn, sie stammt aus einem EnvelopedData-Chiffrat (AES-CBC) oder ließ sich aus einem solchen nicht öffnen: Diese wird verworfen, wie die Bounce-Wege sie verwerfen, da davon, ob sie überhaupt zurückgehalten wurde, das Padding abhing. Das sind Verhaltens-Optionen und je Adresse über die Tabelle pepsi.settings überschreibbar.
Die kryptographische Richtlinie — Algorithmenwahl, Akzeptanz schwacher Digests, Mindestschlüssellängen — liegt in den CRYPTO_*-Optionen von [pepsi] und in [pepsi-crypto]. Die sind ausschließlich Sache des Systemadministrators und aus pepsi.settings oder pepsi-stage-edit-settings(1) bewusst nicht erreichbar.
Eine davon gilt hier nicht. CRYPTO_ALLOW_DOWNGRADE regelt, was ausgegeben werden darf: OpenPGP-SEIPDv1+MDC und CMS-EnvelopedData sind lesbar, was auch immer es sagt (nur das eigene OPEN_ENVELOPED_DATA = no dieser Stage lässt Letzteres ungeöffnet), denn sie eingehend abzulehnen machte diesen Host unfähig, Mail aus dem größten Teil der Welt zu empfangen, ohne irgendjemanden zu schützen. Nur 3DES und die schwachen Signatur-Digests unterliegen eingehend einer Schranke, und jede Ablehnung erzeugt ihr eigenes Urteil statt eines generischen Fehlschlags. Die 3DES-Schranke ist auf beiden Seiten nicht dieselbe: Eine eingehende S/MIME-3DES-Nachricht wird nur unter yes angenommen, eine eingehende OpenPGP-Nachricht auch unter negotiate, denn ein OpenPGP-Zertifikat nennt seine eigenen Chiffrier-Fähigkeiten und ein X.509-Zertifikat nennt keine. OpenPGP-Blowfish, die andere Chiffre mit 64-Bit-Blöcken, unterliegt genau derselben Schranke wie OpenPGP-3DES. Der tatsächlich verwendete Container wird je Schicht festgehalten, sodass eine Installation sehen kann, wie viel ihrer eingehenden Mail noch vor-AEAD ist.
95.1.7.1.21. Privilegien¶
Das Binärprogramm wird setuid pepsi-crypto installiert, Modus 4750 pepsi-crypto:pepsi, und ist daher nicht in das vereinheitlichte pepsi-Multi-Call-Binärprogramm eingefaltet.
Beide Hälften der Schlüsselverwahrungsgrenze richten sich nach dieser Identität. Die Datenbankrolle pepsi-crypto ist die einzige, der crypto_identity.private_wrapped gewährt ist, und die Peer-Authentifizierung von PostgreSQL richtet sich nach der effektiven uid; der Schlüsselverschlüsselungsschlüssel liegt in secrets.d/pepsi-crypto.secret, Modus 0640, im Besitz desselben Kontos. Ein setgid-Binärprogramm erlangte die Gruppe — genug, um das Fragment zu lesen — und authentifizierte sich gegenüber der Datenbank dennoch als pepsi, genau die Rolle, der die Spalte verwehrt ist.
Die Gruppe im Modus beschränkt die Ausführung auf das Konto des Dispatchers und root; das Programm verweigert zur Laufzeit außerdem den Dienst, sofern seine reale uid nicht root oder eines der Konten pepsi, pepsi-crypto und pepsi-owner ist. Diese Laufzeitprüfung greift nur, wenn das Binärprogramm das setuid-Bit tatsächlich trägt — ein ohne dieses Bit installierter Build (ein Entwicklerbaum, cargo test) lässt jeden es ausführen, mit der Begründung, dass ein solcher Aufrufer die Datenbank als er selbst erreicht und dann PostgreSQLs eigene Berechtigungen maßgeblich sind. -c wird von diesen Aufrufern angenommen (die dokumentierte Startform des Dispatchers ist PROGRAM -c cfg worker), und die Umgebung wird bereinigt, bevor die Konfiguration geladen wird, denn die Konfigurationsschicht ist über XDG_CONFIG_HOME, HOME, PATH und die PG*-Familie steuerbar.
Entschlüsselungsschlüssel werden nach Fähigkeit ausgewählt: jede nicht widerrufene Identität jedes lokalen Empfängers, deren purpose encrypt oder both ist, abgelaufene eingeschlossen, denn alte Mail muss lesbar bleiben.
95.1.7.1.22. Ressourcengrenzen¶
MAX_LAYERS (Standardwert 4) begrenzt, wie viele geschachtelte verschlüsselte Schichten ausgepackt werden; eine Nachricht mit mehr wird mit ungeöffnetem Rest zugestellt und decrypt-failure=unsupported festgehalten.
Eine OpenPGP-Nachricht ist routinemäßig komprimiert, und das Expansionsverhältnis ist die Wahl des Absenders, sodass pepsi-crypto einen Klartext über 64 MiB rundweg ablehnt, statt ihn abzuschneiden — ein Teilklartext darf nie als verifiziert gemeldet werden. Dieser Fall wird mit einem eigenen Fehlergrund, decrypt-failure=too-large, gemeldet und nicht als generischer Entschlüsselungsfehler: „diese Nachricht ist eine Bombe“ und „wir konnten diese nicht öffnen“ sind für einen Betreiber verschiedene Tatsachen.
95.1.7.1.23. State¶
Eingaben: state.dsn (beachtet und im Gleichschritt mit der Lokalitätsaufteilung zerteilt), state.crypto.in (bei einem fortgesetzten Datensatz das, was der entschlüsselnde Durchgang festgehalten hat).
Ausgaben: state.crypto.in — ob die Nachricht verschlüsselt war, was aus dem Chiffrat wurde (decryption: not-encrypted, decrypted, failed, for-client oder withheld), welche Identität sie geöffnet hat, das Signatururteil samt Detail (einschließlich covers_plaintext), die geordnete Schichtenliste und, bei Mail an den eigenen Schlüssel eines Benutzers, for_client und client_fingerprint, sowie isolated, demoted und dropped, wenn Inhalt neben den geschützten Teilen verschoben oder verworfen wurde, protected_mismatch, wenn signierte geschützte Header-Felder von den äußeren abweichen, unauthenticated und sanitised für einen Klartext aus einem Container ohne Integritätsschutz, den keine Signatur abdeckt (Klartext aus einem formbaren Container), und encrypted und outer_gossip für pepsi-stage-autocrypt-learn(1) (siehe Zwei Tatsachen, die für die Lern-Stage festgehalten werden); bei einem Fehlschlag failure (der Grund), failed_unauthenticated, wenn das fehlgeschlagene Chiffrat keinen Integritätsschutz hatte, und route, wenn eine Fehlerrichtlinie die Nachricht geleitet hat. Außerdem state.encrypted = true, wenn die Nachricht verschlüsselt ankam, und state.signature_verified = true nur für das Urteil valid; pepsi-stage-check-whitelist(1) und pepsi-stage-auto-whitelist(1) lesen diese. Bei einem Bounce state.bounce. Das State-Layout wird in pepsi.state(7) beschrieben.
Übergänge: NEXT_STAGE für eine zugestellte Nachricht; QUARANTINE_STAGE oder BOUNCE_STAGE gemäß den Fehlerrichtlinien; paused während des Wartens auf die Schlüsselentdeckung; pending bei ebendieser Stage nach einer Lokalitätsaufteilung.
95.1.7.1.24. Befehle¶
- worker
Läuft als persistenter Dispatcher-Worker, liest Nachrichten-IDs von der Standardeingabe und schreibt eine Statuszeile je Nachricht. Das ist der einzige Modus; es gibt keine Einzelschussform. Um eine einzelne Nachricht von Hand auszuführen, pipen Sie ihre ID:
echo 1234 | pepsi-stage-decrypt -c /etc/pepsi/pepsi.conf worker
95.1.7.1.25. Exit-Status¶
- 0
Der Worker endete sauber (Standardeingabe geschlossen).
- 1
Ein Fehler ist aufgetreten (Fehlkonfiguration, ein nicht lesbarer Schlüsselspeicher oder ein Datenbankfehler). Der Grund wird in das Journal geschrieben.
- 78
Der Worker hat den Start verweigert: Seine Konfiguration oder sein Schlüsselbund funktioniert nicht (siehe Fehler dieses Hosts). Der Dispatcher reiht erneut ein, was er übergeben hatte, und versucht die Stage später wieder.
95.1.7.1.26. Siehe auch¶
pepsi-stage-encrypt(1), pepsi-stage-reencrypt(1), pepsi-stage-arc(1), pepsi-keys(1), pepsi-keydisc(1), pepsi-stage-check-whitelist(1), pepsi-stage-relay-to-maildir(1), pepsi-stage-relay-to-lmtp(1), pepsi-stage-bounce(1), pepsi-dispatch(1), pepsi-setup(1), pepsi.conf(5), pepsi.state(7)
Das Kapitel Security des Handbuchs legt die Mechanismen dar, die diese Stage implementiert (The private-key custody boundary, Who a signed and encrypted message was for, Protected headers against the outer ones, Header forgery, Protected content stands alone, Bounces and replies to encrypted mail); sein Kapitel Threat model legt dar, was sie versprechen (What a security indicator means, End-to-end encryption: two custody modes).
95.1.7.1.27. Fehler¶
Melden Sie Fehler an den Pepsi-Issue-Tracker.