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:

none

Die Nachricht trägt keine Signatur.

valid

Kryptographisch 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 die From:-Zeile gebunden, wie der Leser sie sieht (Wofür valid vergeben wird).

partial

Wä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ßer Hash: zwischen der Markierung BEGIN PGP SIGNED MESSAGE und dem Text (der Armor-Leser akzeptiert dort jede Key: value-Zeile und hasht keine davon) oder ein Block, der der Inhalt eines text/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 setzt state.signature_verified nicht. X-Pepsi-Crypto sagt, welcher Fall vorliegt (unsigned-surface=armor-headers oder html).

valid-untrusted

Kryptographisch 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 Stage valid vorenthalten hat — eine Signatur nur über Chiffrat, ein geschütztes From: oder Antwortlenkungsfeld, das abweicht, ein Zertifikat, das kein Postfach nennt, ein Anzeigename, der eine andere Adresse zeigt, ein From: mit mehreren Postfächern, eine Signierer-Domain, die wie eine bekannte aussieht, eine lange vor dem Eintreffen der Nachricht erstellte Signatur; withheld= in X-Pepsi-Crypto und signature.withheld im 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.

invalid

Die 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 zur signingTime, die die Signatur angibt, und ein Postfachname, der kein bloßes local@domain ist, passt zu keiner From:-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 ebenfalls invalid, mit dem Schichturteil wrong-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.

unverifiable

Fü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), Grund display-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; Grund multiple-from;

  • das Zertifikat kein Postfach nennt und zu einem ca_trust-Anker führt — es widerspricht keinem From:, daher kann die Bindung es nicht scheitern lassen, aber es bürgt auch für keine Adresse und wäre sonst für jeden Absender valid. Grund no-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 eines from-Whitelist-Datensatzes, während die Domain selbst abweicht. Grund lookalike-domain, und das A-Label der Domain wird in X-Pepsi-Crypto geschrieben (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 sonst valid wäre, und für TRUST_ANCHOR_TTL zwischengespeichert; 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ützte Subject: einen gefälschten Indikator trägt (Geschützte Header), Gründe protected-from, reply-to und protected-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 als MAX_SIGNATURE_AGE_DAYS (Standardwert 7) vor der Ankunftszeit des Datensatzes, Grund old-signature, oder mehr als einen Tag danach, Grund future-signature. Eine abgefangene signierte Nachricht, die unter einem frischen äußeren Subject: oder Date: 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 Feld Date:, das der Wiedereinspielende schreibt. Eine Signatur ohne Erstellungszeit (CMS ohne signingTime) wird nicht beurteilt, und 0 schaltet die Prüfung ab. Legitim verspätet zugestellte Mail (eine Moderationswarteschlange einer Liste, eine unverändert weitergeleitete Nachricht) verliert nur die Markierung. X-Pepsi-Crypto zeigt 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ßeren From: abweicht (verglichen als addr-specs des ersten Postfachs, ohne Beachtung der Groß-/Kleinschreibung, Anzeigenamen und Kommentare ignoriert), enthält valid vor: Die Signatur wird als valid-untrusted gemeldet (withheld=protected-from), erhält keine [verified]-Markierung und setzt state.signature_verified nicht. Der Signierer hat für eine Nachricht von jemand anderem gebürgt; eine signierte Nachricht, die unter einem neuen äußeren From: erneut gesendet wird (heimliches Weiterleiten), ist die Form, die dies erfasst. Ein geschützter Block mit zwei From:-Feldern, die sich widersprechen, oder einer ohne lesbare Adresse zählt als Abweichung. Nur das positive Urteil wird vorenthalten; invalid und unverifiable bleiben unverändert. Mailinglisten-Software, die das äußere From: signierter Mail umschreibt, kostet solche Mail daher ihr valid, nie mehr.

  • Ein Antwortlenkungsfeld — Reply-To:, Mail-Reply-To: oder Mail-Followup-To: —, das abweicht, enthält valid auf 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 ein List-Id:, und der Signierer hat keines der drei geschützt: Die Signatur bleibt valid, und die Markierung lautet [verified (except reply-to): …] (TAG_VERIFIED_EXCEPT_REPLY_TO, reply-to=unsigned in X-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 verliert valid, 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 und Re:-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 einem Re:. Eine größere Abweichung wird gemeldet, und wenn die Signatur sonst valid ist, wird der signierte Betreff anstelle des äußeren gezeigt (subject=protected in X-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 wie EXTERNAL: wird dadurch entfernt; ebenso alles andere, was unterwegs hinzugefügt wurde. Header-Schutz ersetzt das äußere Subject: 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ält valid vor (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 als valid-untrusted gemeldet. 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 Antwort valid behä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 = passthrough

Die 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. quarantine und bounce-if-unproblematic stehen zur Verfügung. Der Wert bounce ist ein Alias für das längere, aber eindeutige bounce-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 = record

Eine 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. quarantine und bounce stehen zur Verfügung; bounce verwirft 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-Crypto erhält usually-signed=<date of the last valid signature>, und state.crypto.in.usually_signed hä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.

tag

Stellt zusätzlich TAG_MISSING_SIGNATURE (Standardwert [unsigned, usually signed]) dem Subject voran.

quarantine

Leitet 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, einen application/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 einem text/plain-Teil, der nur das Armor enthält, und der Text, der ihn umgab, wird zu einem eigenen Anhang. Jeder verschobene Teil wird umgeschrieben zu application/octet-stream mit Content-Disposition: attachment, einem bereinigten Dateinamen (dem des Absenders oder part-N.html, message-N.eml, encrypted-N.asc und dergleichen), einer Content-Description, die sagt, dass Pepsi ihn verschoben hat und dass der Schutz der Nachricht ihn nicht abdeckt, und ohne Content-ID, Content-Location oder Content-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 einen application/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 einen text/*-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-SignedData oder einen inline klarsignierten Block — neben unsigniertem Inhalt, wird der unsignierte Inhalt verworfen (mehrere signierte Einheiten werden zusammen in einem multipart/mixed behalten). 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, .asc oder .p7m (report.pdf.pgp kommt als report.pdf an), 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- oder valid-untrusted-Signatur mit demselben Schlüssel wie die der Nachricht trägt. Das ist das verschlüsselte Gegenstück zu ISOLATE_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; m wird als rn gelesen), 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, und STRIP_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, authentic und ihre nahen Formen), oder ein Wort unserer eigenen Markierungen; eine führende Verified:-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.12. Betreffmarkierungen

Mit SUBJECT_TAGS = yes (dem Standardwert) werden die verdienten Markierungen dem Subject in Schachtelungsreihenfolge vorangestellt:

encrypted(signed(body))   ->  [decrypted][verified] quarterly figures
signed(encrypted(body))   ->  [verified][decrypted] quarterly figures

Beide Formen öffnen sich. Die zweite Zeile nennt die Reihenfolgeregel; beachten Sie, dass das zweite Beispiel sein [verified] nur von einer inneren Signatur verdient, denn eine äußere Signatur über Chiffrat erreicht nie das Urteil valid, für das die Markierung geschrieben wird (Eine Signatur, die Chiffrat abdeckt). Eine signed(encrypted(body))-Nachricht ohne innere Signatur wird daher allein mit [decrypted] markiert.

Für die meisten Benutzer ist das das einzige Signal, das sie je sehen werden — niemand, der Mail in einem Webmail-Client liest, sieht sich Header an —, sodass es die Arbeit verschwendete, sie unsichtbar zu tun. Der Preis ist, dass ein für den Benutzer sichtbares Feld verändert wird: Es beeinflusst Suche, Threading und den zitierten Betreff von Antworten. Setzen Sie SUBJECT_TAGS = no, um sich allein auf den Header zu verlassen.

[verified] wird nur für das Urteil valid geschrieben, und es nennt die Adresse, an die der Signierer gebunden ist, innerhalb der schließenden Klammer:

[verified: alice@example.org] quarterly figures

[verified] allein sagt nur, dass irgendjemand mit einem verankerten Schlüssel signiert hat, und der Leser müsste sich noch auf eine From:-Zeile verlassen, deren Anzeigenamen der Absender frei schreibt; mit der Adresse in der Markierung sagt das eine Feld, das jeder Client zeigt, wer signiert hat. (Ein ohne schließende Klammer geschriebenes TAG_VERIFIED erhält die Adresse nach einem Doppelpunkt angehängt.) Wenn eine Mailingliste das äußere Reply-To: (oder Mail-Followup-To:) außerhalb der Signatur hinzugefügt hat (Geschützte Header), ist die Markierung stattdessen TAG_VERIFIED_EXCEPT_REPLY_TO, [verified (except reply-to): alice@example.org]: Die Kernaussage bleibt erhalten, und das eine Feld, das die Signatur nicht abdeckt, wird genannt.

Eine Signatur innerhalb eines Chiffrats wird unabhängig von ihrem Urteil markiert. Jeder kann ein abgefangenes Chiffrat erneut senden oder an einen veröffentlichten Schlüssel verschlüsseln, von einer eigenen Adresse; der Leser sähe sonst [decrypted] und nichts, was sagt, dass der Signierer nicht der Absender ist, und eine zitierende Antwort gäbe den Klartext an den zurück, der ihn gesendet hat. Daher erhält eine Signatur dort, die einwandfrei, aber nicht valid ist — ein nicht vertrauenswürdiger oder unbekannter Schlüssel, eine partial-Abdeckung —, TAG_UNVERIFIED_SIGNER ([unverified signer]), und eine schlechte TAG_BAD_SIGNATURE_ENCRYPTED ([bad signature]), beide standardmäßig an (none schaltet jede davon stumm):

encrypted(signed(body)), untrusted key  ->  [decrypted][unverified signer] …
encrypted(signed(body)), bad signature  ->  [decrypted][bad signature] …

Außerhalb eines Chiffrats ist TAG_BAD_SIGNATURE standardmäßig leer: Eine schlechte Signatur ist eine alltägliche Eigenschaft legitimer Mail (eine Liste schreibt Nachrichtentexte um), daher würde eine standardmäßig aktive Markierung einen großen Teil des Posteingangs eines Benutzers mit einer Anschuldigung versehen. Dieses Argument gilt nicht innerhalb eines Chiffrats — eine Liste kann keinen Inhalt umschreiben, den sie nicht lesen kann —, weshalb die beiden getrennte Standardwerte haben. Eine nicht vertrauenswürdige oder nicht verifizierbare Klartextsignatur erhält keine Markierung.

Jede Form, die diese Stage schreibt, die Adressform eingeschlossen, wird aus einem eingehenden Betreff entfernt, bevor unsere hinzugefügt wird, gleich wie lang die Adresse ist, die ein Absender in eine gefälschte schreibt.

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:

encrypted

yes/no — die Nachricht kam mit Chiffrat an. Was zählt, ist der Paketstrom, nicht die Bezeichnung: Ein armiertes PGP MESSAGE (oder ein multipart/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 als encrypted=no gemeldet, ohne [decrypted]-Markierung und ohne eine Identität, die als öffnende festgehalten wird. Eine Signatur darin wird weiterhin verifiziert.

decrypted

yes/no — nur vorhanden, wenn encrypted=yes.

for-client

yes, 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).

protocol

openpgp oder smime.

container

Der Inhaltsverschlüsselungs-Container des geöffneten Chiffrats, wie der Entschlüsseler ihn aus den Bytes gelesen hat: auth-enveloped-data oder enveloped-data (S/MIME), seipdv2-aead oder seipdv1-mdc (OpenPGP). Nur enveloped-data fehlt der Integritätsschutz. Vorhanden, wenn ein Chiffrat geöffnet wurde.

signature

Eines der obigen Urteile.

signer, fingerprint, key-source, trust, algorithm

Der Signaturschlüssel, woher er kam und was er wert war. key-source und trust tragen beide das Herkunftswort des Verifizierers (anchor, dane, wkd, pinned, autocrypt, attached oder unknown). Nur vorhanden, wenn bekannt.

binding

Wie sich der Schlüssel des Signierers zur From:-Adresse verhielt, wie der Verifizierer sie sah: matched, mismatched oder no-identity (der Schlüssel nennt keine Adresse). Vorhanden, wenn ein Schlüssel gefunden wurde.

anchor

Der Fingerabdruck des ca_trust-Ankers, bei dem die Kette des Signierers endete. Vorhanden bei einer verankerten S/MIME-Signatur.

bound-to

Die Adresse, an die eine valid-Signatur gebunden ist — die From:-Adresse, wie geschrieben, die die Markierung nennt. Nur bei valid vorhanden.

signed-at

Die 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).

withheld

Warum eine Signatur, die verifiziert hat, valid-untrusted statt valid ist: ciphertext-cover, protected-from, protected-subject, reply-to, no-identity, display-name, multiple-from, lookalike-domain, old-signature oder future-signature (Wofür valid vergeben wird). Nur dann vorhanden.

unsigned-surface

Warum ein verifizierter klarsignierter Block partial ist: armor-headers oder html. Nur dann vorhanden.

reply-to

unsigned, wenn die Signatur valid ist und das äußere Reply-To: (oder Mail-Reply-To:, Mail-Followup-To:) von einer Mailingliste außerhalb davon hinzugefügt wurde (die Markierung [verified (except reply-to)]). Nur dann vorhanden.

signer-domain

Die Domain des Signierers als A-Label, wenn sie ein internationalisierter Domainname ist oder wie eine bekannte aussieht. Nur dann vorhanden.

usually-signed

Das Datum (UTC, YYYY-MM-DD), an dem eine valid-Signatur der From:-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.

failure

Der maschinenlesbare Grund, warum ein Signatururteil nicht gut ist.

decrypt-failure

Der maschinenlesbare Grund, warum die Entschlüsselung fehlschlug.

unauthenticated

yes, 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.

sanitised

text, wenn der Klartext auf Inhalt reduziert wurde, den kein Client als Markup darstellt (UNAUTHENTICATED_PLAINTEXT = text oder DECRYPTED_MARKUP = text für jeden entschlüsselten Klartext). Nur dann vorhanden.

isolated

Welche Regeln aus Isolieren geschützter Inhalte die Nachricht verändert haben (encrypted, signed), durch Kommas getrennt. Nur vorhanden, wenn eine es tat.

protected-mismatch

Die 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.

subject

protected, wenn das geschützte Subject: des Signierers anstelle eines unterwegs veränderten äußeren gezeigt wurde. Nur dann vorhanden.

demoted, dropped

Wie 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.

nested

Wie viele angehängte Nachrichten, die Chiffrat neben anderem Inhalt trugen, reduziert wurden (Isolieren geschützter Inhalte). Nur vorhanden, wenn nicht null.

layers

Die 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/enriched und die anderen text/*-Typen, application/xhtml+xml, auch innerhalb einer angehängten Nachricht –, wird mit beibehaltenem Zeichensatz als text/plain neu bezeichnet und verliert seine Content-ID, Content-Location und Content-Base; ein multipart/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. Das Subject wird mit TAG_UNAUTHENTICATED ([decrypted, unauthenticated]) anstelle von TAG_DECRYPTED markiert, und X-Pepsi-Crypto sagt unauthenticated=yes; sanitised=text.

require-signature

Die 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. decryption lautet withheld, keine Identität wird als öffnende festgehalten, nichts wird markiert, und ON_DECRYPT_FAILURE wird 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.

open

Der 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_UNAUTHENTICATED markiert und als unauthenticated=yes festgehalten.

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.