95.1.28. pepsi-stage-reencrypt¶
seal decrypted inbound mail to the recipient’s own key before filing it
- Handbuchabschnitt:
1
95.1.28.1.1. Name¶
pepsi-stage-reencrypt - die Stage der Pepsi-Pipeline für die Neuverschlüsselung zur Speicherung.
95.1.28.1.2. Übersicht¶
pepsi-stage-reencrypt [GLOBAL-OPTIONS] worker
95.1.28.1.3. Beschreibung¶
pepsi-stage-reencrypt ist ein Stage-Programm, das von pepsi-dispatch(1) als persistenter Worker ausgeführt wird, der Nachrichten-IDs von der Standardeingabe liest. Es lädt den pepsi.workqueue-Datensatz der Nachricht (und weigert sich zu handeln, sofern sein status nicht running ist) und liest seinen [stage-<stage>]-Abschnitt.
pepsi-stage-decrypt(1) öffnet Mail, die an den Gateway-Schlüssel (MTA-Schlüssel) eines Benutzers verschlüsselt ist, damit die Stages für Sprache, Spam, Whitelist und Schlüssellernen sie lesen können. Der Klartext ist dann das, was im Postfach abgelegt würde. Diese Stage läuft nach all diesen Lesern und verschlüsselt die Nachricht wieder, diesmal an den Schlüssel, den der Benutzer für seinen eigenen Mail-Client registriert hat. Dieser Schlüssel ist der MUA-Schlüssel: ein custody = client-Datensatz in pepsi.crypto_identity. Der Benutzer registriert ihn mit pepsi-keys(1) identity import oder mit den Schlüsselbefehlen per E-Mail, oder Pepsi lernt ihn aus dem Autocrypt:-Header der Nachrichten, die der Benutzer selbst einliefert. Abgelegt wird dann Chiffrat, das nur dieser Client öffnen kann.
Sie wirkt nur auf eine Nachricht, die die Entschlüsselungs-Stage geöffnet hat: state.crypto.in muss besagen, dass sie verschlüsselt eintraf und entschlüsselt wurde. Mail, die im Klartext eintraf, wird nie angefasst, denn sie zu versiegeln würde eine Vertraulichkeit behaupten, die sie auf dem Übertragungsweg nie hatte. Mail, die die Entschlüsselungs-Stage ungeöffnet ließ, weil sie bereits an den MUA-Schlüssel verschlüsselt war (for_client), braucht ebenfalls nichts. Nur Empfänger, die dieser Host bedient, werden berücksichtigt; ein Empfänger, zu dem ein Alias bei einem anderen Anbieter aufgelöst wurde, bleibt unberührt.
Für jeden lokalen Empfänger wird die versiegelte Kopie an jeden aktiven MUA-Schlüssel verschlüsselt, der Verschlüsselung empfangen kann. Ein Benutzer mit zwei Schlüsseln, etwa einem Hardware-Token und dessen Backup oder einem Schlüssel pro Gerät, kann das Postfach daher mit dem Schlüssel öffnen, der gerade zur Hand ist. Eine Nachricht trägt ein Protokoll: Mischen die Schlüssel OpenPGP und S/MIME, gewinnt das Protokoll des neuesten Schlüssels, und die anderen werden als übersprungen festgehalten. Höchstens acht Schlüssel werden verwendet, der neueste zuerst. Kann an einen Schlüssel nicht versiegelt werden, etwa weil sein Zertifikat abgelaufen ist, weil er unter [pepsi] CRYPTO_MIN_RSA_BITS liegt oder weil er auf der Liste bekanntermaßen kompromittierter Schlüssel steht, wird nur dieser Schlüssel mit einer Warnung verworfen, und die Kopie wird an die übrigen versiegelt; erst wenn kein Schlüssel verwendbar ist, gilt ON_NO_CLIENT_KEY. Bei S/MIME entscheidet der schwächste der Fähigkeitsdatensätze der Schlüssel über den Container, sodass jedes Gerät des Benutzers ihn lesen kann. Eine Nachricht mit mehreren Empfängern wird zuerst in einen Datensatz pro Empfänger aufgeteilt, wenn einer von ihnen versiegelt oder abgelehnt werden soll, da jede Kopie an die Schlüssel einer Person versiegelt wird; state.dsn.rcpt wird im Gleichschritt zugeschnitten.
Mail an einen Alias funktioniert genauso, da die Stage nach pepsi-stage-aliases(1) läuft: Eine an den Gateway-Schlüssel einer Rollenadresse verschlüsselte Nachricht wird mit diesem Schlüssel geöffnet, auf die Mitglieder des Alias expandiert, und die Kopie jedes Mitglieds wird an dessen eigene Schlüssel versiegelt.
95.1.28.1.4. Wohin damit¶
Unmittelbar vor der lokalen Zustellung (pepsi-stage-relay-to-maildir(1), pepsi-stage-relay-to-lmtp(1)), und daher:
nach pepsi-stage-decrypt(1): Davor findet die Stage nichts Geöffnetes vor und reicht Mail nur durch;
nach jeder Stage, die den Inhalt liest: Spracherkennung und -blockierung, die Schranken für Whitelist und Pay-to-Send, pepsi-stage-autocrypt-learn(1) (das Gossip aus dem Klartext liest), pepsi-stage-vacation(1);
nach pepsi-stage-aliases(1) und pepsi-stage-dot-forward(1): Eine anderswohin weitergeleitete Kopie darf nicht für den Schlüssel eines lokalen Benutzers versiegelt hinausgehen, weil ihr neuer Empfänger sie nicht öffnen kann.
pepsi-setup(1) warnt, wenn keine Entschlüsselungs-Stage zu ihr führt und wenn sie zu einer der obigen Stages führt. Beachten Sie, dass das Sieve-Skript eines LMTP-Servers die versiegelte Nachricht sieht: Regeln, die den Nachrichtentext prüfen, greifen nicht mehr, und mit PROTECT_HEADERS auch keine Regeln auf den Betreff.
95.1.28.1.5. Was sie schreibt¶
Die Aufteilung des Umschlags ist dieselbe, die pepsi-stage-encrypt(1) verwendet. Die Content-*-Felder und Autocrypt-Gossip: (Autocrypt Level 1 §5.3) kommen in das Chiffrat, und alles andere bleibt im äußeren Block. Dazu gehören Received:, From:/To:/Date:/Message-ID:, der eigene Autocrypt:-Header des Absenders (den ein Client lesen muss, bevor er irgendetwas entschlüsseln kann), die DKIM/ARC-Felder und X-Pepsi-Crypto, das Urteil des Gateways darüber, wie die Nachricht eintraf. Mit PROTECT_HEADERS werden die RFC-5322-Felder zusätzlich nach innen kopiert, und das äußere Subject wird zu ....
Es wird keine Signatur hinzugefügt. Die Entschlüsselungs-Stage hat die Signatur des Absenders bereits beurteilt und ihr Urteil in state.crypto.in und in X-Pepsi-Crypto festgehalten. Eine Gateway-Signatur sagte nur „das Gateway hat dies versiegelt“, und ein Mail-Client kann das nicht von einer Signatur des Autors unterscheiden. Eine Absendersignatur, die die Entschlüsselung als MIME-Schicht überstanden hat (S/MIME oder PGP/MIME-multipart/signed innerhalb des Chiffrats), ist Teil des Klartexts. Sie wird also mit ihm versiegelt und verifiziert im Client weiterhin. Eine OpenPGP-Signatur, die im selben Datenstrom wie die Verschlüsselung verpackt ist, verbraucht die Entschlüsselung, und sie kann nicht rekonstruiert werden; der Client zeigt dann eine unsignierte Nachricht und den Urteils-Header des Gateways.
Der Container folgt [pepsi] CRYPTO_ALLOW_DOWNGRADE genau wie bei der ausgehenden Verschlüsselung (siehe pepsi.conf(5)). Bei einem S/MIME-Client-Schlüssel gilt zusätzlich der Fähigkeitsdatensatz je Peer: Ein lokaler Benutzer, dessen Client AuthEnvelopedData nicht lesen kann (Thunderbird), braucht pepsi-keys peer capability set ADDRESS cbc, sonst kommt die gespeicherte Kopie leer an. Ohne Datensatz wird die Kopie als AES-256-GCM-AuthEnvelopedData versiegelt.
95.1.28.1.6. Ohne Schlüssel¶
ON_NO_CLIENT_KEY entscheidet, was mit einem lokalen Empfänger geschieht, der keinen verwendbaren MUA-Schlüssel hat, weil entweder keiner registriert ist oder an keinen versiegelt werden kann (ein abgelaufenes Zertifikat, ein Container, den die Richtlinie ablehnt, ein Schlüssel unter [pepsi] CRYPTO_MIN_RSA_BITS oder auf der Liste bekanntermaßen kompromittierter Schlüssel pepsi.compromised_key; dieser zweite Fall wird zusätzlich als Warnung protokolliert):
plaintext(Standardwert)Den Klartext ablegen, genau wie ohne diese Stage.
bounceDie Nachricht ablehnen: Sie wird mit dem erweiterten Status
5.7.5(RFC 3463, kryptografischer Fehler) zu BOUNCE_STAGE geleitet. Die zurückgesandte DSN enthält weder den Nachrichtentext noch irgendeinen Header, den der Absender geschützt haben könnte, denn der Absender hat die Nachricht verschlüsselt, und eine DSN reist im Klartext: Der Header-Block wird aufFrom,Sender,To,Cc,DateundMessage-IDgekürzt, der Nachrichtentext wird geleert, undRET=HDRSwird erzwungen, was auch immer der Absender verlangt hat. Ohne BOUNCE_STAGE wird der Datensatz stattdessen failed (und pepsi-setup(1) lehnt diese Kombination ab).Eine Nachricht, die in einem S/MIME-
EnvelopedDataankam (AES-CBC oder 3DES, kein Integritätsschutz;state.crypto.in.layersbenennt den Container), wird statt gebounct verworfen, mit einer Warnung im Log und dem Telemetrie-Schlüsseldecrypt-dropped. Diese Stage sieht nur Nachrichten, die die Entschlüsselungs-Stage geöffnet hat, ihr Bounce würde dem Absender also verraten, dass sich das Chiffrat öffnen ließ: bei einem veränderten CBC-Chiffrat, dass sein Padding gültig war. Eine verworfene Nachricht sieht für ihren Absender aus wie eine, die sich nicht öffnen ließ.
Eine Ablehnung erzeugt absichtlich einen Bounce statt eines Aufschubs. Ein Aufschub hielte den Klartext für die gesamte Lebensdauer der Nachricht in der Warteschlange, und das wäre eine längere Blöße, keine kürzere; außerdem würde nichts die Nachricht wecken, wenn ein Schlüssel registriert wird.
Die Option wird über die Überschreibungsschicht pro Adresse gelesen, sodass der Standort-Standardwert im Abschnitt für einen einzelnen Empfänger mit pepsi-settings(1) geändert werden kann:
pepsi-settings set bob@example.org reencrypt ON_NO_CLIENT_KEY bounce
95.1.28.1.7. Konfiguration¶
Die Optionen liegen im eigenen [stage-<name>]-Abschnitt der Stage (siehe pepsi.conf(5)):
- NEXT_STAGE (verpflichtend)
Lokale Zustellung.
- BOUNCE_STAGE
Wohin eine Ablehnung geht; erforderlich, wenn ON_NO_CLIENT_KEY im Abschnitt
bounceist, und ratsam, wann immer eine Überschreibung pro Adresse dies festlegen könnte.- ON_NO_CLIENT_KEY =
plaintext|bounce Siehe Ohne Schlüssel. Standardwert
plaintext.- PROTECT_HEADERS = yes | no
Die RFC-5322-Felder in das Chiffrat kopieren und das äußere
Subjectdurch...ersetzen. Der Standardwert ist no, wie bei pepsi-stage-encrypt(1): Die Kopie ist für das Postfach, dessen Server Nachrichten nach dem äußeren Betreff auflistet und durchsucht, und ein Client, der nicht hineinsehen kann, zeigt jeden Betreff als....- ENABLED = yes | no
Ist die Option aus, reicht die Stage jede Nachricht unverändert durch. Standardwert yes.
- LOCAL_DOMAINS, TARGETS, RECIPIENT_DELIMITER, REQUIRE_ACCOUNT
Welche Empfänger dieser Host bedient, mit der Bedeutung und den Standardwerten von pepsi-stage-decrypt(1) (LOCAL_DOMAINS fällt auf
[pepsi-ingress] ACCEPTED_DOMAINSzurück).
Die Stage ist unprivilegiert und in das Multi-Call-Binary pepsi eingefaltet: Das Versiegeln für einen öffentlichen Schlüssel braucht kein privates Material, und die Stage liest nur die öffentlichen Spalten von pepsi.crypto_identity, die die gewöhnliche Pipeline-Rolle pepsi lesen darf.
95.1.28.1.8. State¶
Eingaben: state.crypto.in.encrypted, state.crypto.in.decrypted und state.crypto.in.for_client, geschrieben von pepsi-stage-decrypt(1).
Ausgaben: state.crypto.store, dessen Vorhandensein die Stage außerdem davon abhält, einen Datensatz je zweimal zu versiegeln:
outcomereencrypted,plaintextoderbounced.protocol,fingerprint,fingerprints,container,downgradedBei
reencrypted: an welche MUA-Schlüssel die Kopie versiegelt wurde (fingerprints, der neueste zuerst;fingerprintist der erste davon) und welcher Container erzeugt wurde.skippedBei
reencrypted, falls vorhanden: die anderen aktiven Schlüssel des Empfängers, an die die Kopie nicht versiegelt wurde, jeweils mit ihremfingerprintund einemreason. Dieser istprotocol(nicht das Protokoll des neuesten Schlüssels),limit(jenseits des achten) oder der Fehler, den das Versiegeln an diesen Schlüssel ergab.reasonBei
plaintext/bounced:no-client-keyodernot-local, wenn die Nachricht unverändert abgelegt wurde, sonst eine kurze Formulierung (kein verwendbarer eigener Schlüssel des Empfängers oder der Fehler, der das Versiegeln an seinen Schlüssel scheitern ließ).
Das State-Layout wird in pepsi.state(7) beschrieben.
Übergänge: schaltet zu NEXT_STAGE weiter; leitet unter ON_NO_CLIENT_KEY = bounce zu BOUNCE_STAGE um (oder schlägt ohne sie fehl); gibt einen Datensatz mit mehreren Empfängern nach dem Aufteilen an die Warteschlange zurück.
95.1.28.1.9. Befehle¶
- worker
Läuft als persistenter pepsi-dispatch(1)-Worker und liest Nachrichten-IDs von der Standardeingabe.
95.1.28.1.10. Globale Optionen¶
- -c FILE, –config FILE
Liest die Konfiguration aus FILE, statt die Standardorte zu durchsuchen.
- -L LOGLEVEL, –log LOGLEVEL
Setzt die Log-Ausführlichkeit (Standardwert
[pepsi] LOG, sonstinfo).- -v, –verbose
Zeigt Log-Meldungen aus allen Quellen.
- -h, –help; -V, –version
Gibt eine Verwendungsübersicht / die Version aus und beendet sich.
95.1.28.1.11. Sicherheit¶
Der Mechanismus wird unter „Re-sealing decrypted mail for storage“ im Kapitel Security des Pepsi-Handbuchs beschrieben, und was das Handbuch für ihn beansprucht, unter „Client custody“ in seinem Kapitel Threat model (und in der Spalte Filed mail seiner Garantiematrix). Die Garantie betrifft bereits abgelegte Kopien: Solange eine Nachricht in der Warteschlange liegt, sieht jede pepsi-Stage, diese eingeschlossen, den Klartext, und eine kompromittierte Stage könnte eine Nachricht an dieser Stage vorbeileiten.
95.1.28.1.12. Exit-Status¶
- 0
Der Worker endete sauber (Standardeingabe geschlossen).
- 1
Ein Fehler ist aufgetreten (Fehlkonfiguration oder ein Datenbankfehler). Der Grund wird in das Log geschrieben.
- 78
Der Worker hat den Start verweigert: Sein Abschnitt oder die
[pepsi]-Krypto-Richtlinie lässt sich nicht parsen. Der Dispatcher reiht wieder ein, was er übergeben hatte, und versucht die Stage später erneut. Ein Datenbankfehler während der Verarbeitung einer Nachricht wird genauso wiederholt wie jeder andere Fehler dieses Hosts (siehe pepsi-dispatch(1)).
95.1.28.1.13. Beispiele¶
Nachricht 42 neu verschlüsseln (sie muss running sein):
echo 42 | pepsi-stage-reencrypt -c /etc/pepsi/pepsi.conf worker
Das Ende einer eingehenden Pipeline:
[stage-dot-forward]
PROGRAM = pepsi-stage-dot-forward
NEXT_STAGE = reencrypt
[stage-reencrypt]
PROGRAM = pepsi-stage-reencrypt
NEXT_STAGE = local
BOUNCE_STAGE = bounce
Für keinen Empfänger je lesbare Mail ablegen und auch die Betreffzeilen verbergen:
[stage-reencrypt]
PROGRAM = pepsi-stage-reencrypt
NEXT_STAGE = local
BOUNCE_STAGE = bounce
ON_NO_CLIENT_KEY = bounce
PROTECT_HEADERS = yes
95.1.28.1.14. Siehe auch¶
pepsi-stage-decrypt(1), pepsi-stage-encrypt(1), pepsi-keys(1), pepsi-settings(1), pepsi-stage-relay-to-maildir(1), pepsi-stage-relay-to-lmtp(1), pepsi-dispatch(1), pepsi.conf(5), pepsi.state(7), pepsi-setup(1)
95.1.28.1.15. Fehler¶
Melden Sie Fehler an den Pepsi-Issue-Tracker.