95.1.27. pepsi-stage-autocrypt-learn

learn correspondents‘ keys from the mail they send

Handbuchabschnitt:

1

95.1.27.1.1. Name

pepsi-stage-autocrypt-learn - die Schlüssellern-Stage der Pepsi-Pipeline.

95.1.27.1.2. Übersicht

pepsi-stage-autocrypt-learn [GLOBAL-OPTIONS] worker

95.1.27.1.3. Beschreibung

pepsi-stage-autocrypt-learn 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 diesen pepsi.workqueue-Datensatz (und weigert sich zu handeln, sofern sein status nicht running ist) und liest seinen [stage-<stage>]-Abschnitt.

Hier lehrt eine eingehende Nachricht Pepsi einen öffentlichen Schlüssel. Sie lernt Schlüssel aus vier Quellen, allesamt Dinge, die ein Korrespondent in eine an uns gesendete Nachricht gelegt hat:

  • der Autocrypt:-Header des Absenders (Autocrypt Level 1 §2.1);

  • ein angehängter application/pgp-keys-Teil;

  • das Zertifikat, das eine S/MIME-Signatur über die Nachricht erstellt hat: Ein Zertifikat wird nur gelernt, wenn sich die Signatur unter seinem Schlüssel verifizieren lässt, nie, weil das SignedData es bloß mitführt (eine Kette, ein neben dem des Unterzeichners angehängtes fremdes Zertifikat, eine certs-only-Nachricht);

  • die Autocrypt-Gossip:-Felder einer verschlüsselt eingetroffenen Nachricht, die die Schlüssel der anderen Empfänger einführen (Level 1 §5.3).

Alles, was sie lernt, wird über denselben keydisc_resolve-Pfad, den pepsi-keydisc(1) verwendet, nach pepsi.peer_key geschrieben; ein hier gelernter Schlüssel gibt daher auch jede Nachricht frei, die auf den Schlüssel dieser Adresse wartend geparkt ist.

Die Stage verwirft eine Nachricht nie, pausiert sie nie, erzeugt nie einen Bounce und schreibt sie nie um. Sie lernt und schaltet weiter, daher ist NEXT_STAGE verpflichtend.

Sie hält auch die umgekehrte Richtung fest: dass ein Korrespondent nachweislich einen unserer Schlüssel besitzt (siehe Nachweis, dass ein Korrespondent unseren Schlüssel besitzt), und was der S/MIME-Client eines Korrespondenten lesen kann (siehe S/MIME-Fähigkeiten).

95.1.27.1.4. S/MIME-Fähigkeiten

Eine S/MIME-Signatur kann das Attribut SMIMECapabilities nach RFC 8551 §2.5.2 tragen: die Liste der Chiffren, die der Client des Unterzeichners liest. Für jedes signierende Zertifikat hält die Stage fest, ob diese Liste id-aes256-GCM nennt, ob der Client also das AES-256-GCM-AuthEnvelopedData liest, das Pepsi standardmäßig ausgibt. Der Eintrag kommt in pepsi.smime_capability, den Datensatz je Peer, nach dem pepsi-stage-encrypt(1) den S/MIME-Container wählt. Thunderbird führt kein AES-GCM auf, daher werden seine Benutzer ab ihrer ersten signierten Nachricht als AES-256-CBC-EnvelopedData benötigend festgehalten.

Eine Angabe zählt nur, wenn sich die Signatur darüber unter einem Zertifikat verifizieren lässt, das die Nachricht selbst mitführt (und das keine CA ist), und sie wird auf dieses Zertifikat geschlüsselt statt auf irgendeine Adresse: Wer eine Angabe signiert, kann nur seinen eigenen Schlüssel beschreiben, daher ist kein Absenderfilter nötig und keine der Vertrauensregeln für Schlüssel gilt. Eine Kettenvalidierung ist nicht erforderlich. Eine Signatur ohne das Attribut hält nichts fest (Schweigen heißt nicht „nur CBC“); zwei Signaturen in einer Nachricht, die sich über ein Zertifikat widersprechen, heben sich auf; mehr als acht Angaben in einer Nachricht lehren keine; und ein bestehender Datensatz wird nur durch eine Angabe ersetzt, deren signingTime nicht älter ist, sodass eine wieder eingespielte alte Nachricht einen Korrespondenten, der den Client gewechselt hat, nicht zurücksetzen kann. Es gelten dieselben LEARN_KEYS- und Spam-Schranken wie für Schlüssel.

Ein Korrespondent, der nie eine signierte Nachricht gesendet hat, hat keinen gelernten Datensatz und erhält AuthEnvelopedData; konfigurieren Sie einen mit pepsi-keys peer capability set (pepsi-keys(1)), der außerdem Vorrang vor einem gelernten Datensatz hat.

95.1.27.1.5. Wo sie hingehört

Dies ist eine eigene Stage statt eines Teils von pepsi-stage-decrypt(1), weil sie an einer anderen Stelle der Pipeline laufen muss; wird sie falsch platziert, hebt das die Wirkung stillschweigend auf:

  • Nach pepsi-stage-decrypt. Gossip-Felder liegen innerhalb des Chiffrats, es gibt also nichts zu lesen, bevor die Nachricht geöffnet wurde.

  • Nach jeder Stage, die eine Nachricht als Junk einstufen kann: pepsi-stage-check-whitelist(1) und jede andere Stage, die state.spam setzt. Autocrypt Level 1 §5.3 sagt, dass der Peer-State für eine Nachricht, die der Client für Spam hält, ignoriert werden SOLLTE; eine Stage, die vor dem Entstehen dieser Einschätzung platziert ist, kann das nicht einhalten. pepsi-stage-decrypt(1) läuft auf dem eingehenden Pfad konstruktionsbedingt zuerst, dort existiert diese Einschätzung also noch nicht.

  • Vor allem, was antwortet oder zustellt — pepsi-stage-vacation(1), den Relay-Stages, den lokalen Zustell-Stages. Ein Schlüssel, der nach dem Versand der Antwort gelernt wird, kommt zu spät, um die Antwort zu verschlüsseln.

pepsi-setup --wizard platziert sie korrekt, wenn Ende-zu-Ende-Kryptographie aktiviert ist.

95.1.27.1.6. Was sie nicht lernt

Die Schranken sind die von Autocrypt Level 1, dazu Pepsis eigene, wo Pepsi bewusst strenger ist. Ein Feld oder Schlüssel, der an einer davon scheitert, wird übersprungen; die Nachricht schlägt deswegen nie fehl.

  • Überhaupt kein Schlüssel, wenn LEARN_KEYS aus ist: Die Stage lernt nichts, Gossip eingeschlossen: Gossip erweitert, was eine Nachricht lehren darf, und kann daher nicht an sein, während die engere Sprosse aus ist. (Der unter Nachweis, dass ein Korrespondent unseren Schlüssel besitzt beschriebene Nachweis wird dennoch festgehalten.)

  • Nichts aus einer als Spam bewerteten Nachricht, sofern LEARN_FROM_SPAM nichts anderes sagt.

  • Kein Schlüssel, dessen private Hälfte bekannt ist. Ein Schlüssel auf der Liste bekanntermaßen kompromittierter Schlüssel wird übersprungen, aus jeder Quelle, Gossip eingeschlossen. Diese Liste ist pepsi.compromised_key: die badkeys-Sperrliste, schwache Debian-Schlüssel eingeschlossen, und die Moduli, die das tägliche pepsi-keys peer screen faktorisiert hat.

  • Nichts aus einer Nachricht, die mehr als acht Schlüssel für den Absender anbietet: Jenseits dieser Obergrenze ist das Material ein an eine Nachricht geheftetes Schlüsselbund, und eine beliebige Teilmenge aus einer vom Angreifer gewählten Liste zu nehmen wäre eine stillschweigende Wahl, daher lehrt die Nachricht keinen davon.

  • Nur den eigenen Schlüssel des Absenders aus den ersten drei Quellen: eine Nachricht darf legitim einen Schlüsselbund Dritter mitführen, und diese so zu speichern, als hätte der Absender für sie gebürgt, ließe einen Korrespondenten den Speicher für alle säen. Die Einführung eines Dritten ist die Aufgabe von Gossip, und sie landet auf einer eigenen Sprosse.

  • Gossip nur aus einer verschlüsselt eingetroffenen Nachricht, und nur, wenn der eintreffende Header-Block kein eigenes Autocrypt-Gossip:-Feld trug. Alles auf dem Zustellpfad kann ein solches Feld schreiben, daher lehrt eine Nachricht, die eines trägt, überhaupt kein Gossip. Keine der beiden Tatsachen ist am festgeschriebenen Klartext ablesbar, deshalb hält pepsi-stage-decrypt(1) beide unter state.crypto.in fest, und diese Stage liest sie dort. Eine Nachricht, die nie eine Entschlüsselungs-Stage gesehen hat, hat keinen solchen Eintrag, und Fehlen bedeutet Nein: eine solche Installation lernt Header und angehängte Schlüssel, aber kein Gossip.

  • Kein Gossip für eine Adresse, die die Nachricht nicht sichtbar nennt: Das addr eines Feldes muss im To:, Cc: oder Reply-To: der Nachricht selbst vorkommen (die Empfängerregel aus Level 1 §5.3). Ohne sie könnte ein Absender für jede beliebige Adresse der Welt einen Schlüssel einführen, indem er sie in einem Header nennt, den niemand liest.

  • Nie ein per Gossip gelernter Schlüssel für eine Adresse, die dieser Host bedient. Ein Peer-Schlüssel für eine lokale Adresse ist der Schlüssel, mit dem unsere eigene ausgehende Mail an diesen Benutzer verschlüsselt würde; ein Gossip-Feld, das eine solche nennt, ist daher eine Schlüsselersetzung und keine Einführung. Der Test ist LOCAL_DOMAINS, und er gilt allein für Gossip: Das eigene Material des Absenders wird nach Adresse gefiltert und nicht nach Lokalität (weiter unten steht, was ein gefälschtes From: bedeutungslos macht).

  • Nie die eigene Adresse des Absenders per Gossip (sein eigener Schlüssel gehört auf die Sprosse darüber), nie zwei Felder, die dieselbe Adresse nennen (nichts hier kann zwischen zwei Behauptungen über einen Fremden entscheiden), und nichts aus einer Nachricht mit mehr als 50 Gossip-Feldern (sie werden alle ignoriert), wobei jedes Feld höchstens 16 KiB an keydata= trägt (ein minimaler übertragbarer Schlüssel liegt selbst für RSA-4096 unter 4 kB Base64, das ist also um den Faktor vier großzügig; ein übergroßes Feld wird übersprungen, nicht fatal). Die davon getrennte Grenze von 10 KiB, die manchem Leser begegnet sein wird, ist die Obergrenze aus Autocrypt Level 1 §2.1 für den Autocrypt:-Header selbst und wird nie auf ein Gossip-Feld angewendet.

95.1.27.1.7. Was ein gelernter Schlüssel wert ist

Wenig, mit Absicht. Geerntete Schlüssel sitzen auf dem Rang inbound oder auf inbound-signed, wenn die Nachricht eine DKIM-Signatur trug, die beim Ingress bestanden hat, mit From: ausgerichtet war und den Schlüssel abdeckte. Die Signatur deckt den Schlüssel ab, wenn ihr h= den Autocrypt:-Header aufführt oder, bei einem angehängten Schlüssel oder Unterzeichnerzertifikat, wenn sie den Nachrichtentext abdeckt. Die Stage liest das aus state.auth.dkim und dem Authentication-Results-Fragment, das der Ingress festgehalten hat; hier wird nichts erneut verifiziert. Ein S/MIME-Unterzeichnerzertifikat wird ebenfalls auf inbound-signed angehoben, wenn DMARC beim Ingress bestanden wurde (state.auth.dmarc = pass, durch ausgerichtetes DKIM oder ausgerichtetes SPF): Die Domain hat für den Absender gebürgt, und das Zertifikat hat die Nachricht signiert. Ein OpenPGP-Schlüssel nicht, weil nichts außer einer DKIM-Signatur ein Header-Feld oder einen Anhang an die Nachricht bindet. Per Gossip gelernte sitzen auf gossip. Das sind die untersten drei Sprossen der Vertrauensleiter (siehe pepsi-keydisc(1)):

  • ein solcher Schlüssel kann nie einen aus der Entdeckung oder von einem Betreiber verdrängen;

  • eine gegen einen solchen verifizierte Signatur wird bestenfalls als valid-untrusted gemeldet, nie als valid, sie setzt also nie state.signature_verified, den State-Schlüssel, von dem pepsi-stage-check-whitelist(1) einen signature_required-Datensatz abhängig macht;

  • ein peer_key-Datensatz wird für eine Adresse, für die dieser Host eine crypto_identity hält, vollständig ignoriert: Die Abfrage, die die Krypto-Stages verwenden, ersetzt die zwischengespeicherten Schlüssel einer solchen Adresse durch die öffentliche Hälfte der Identität. Eine Nachricht, die From: eines lokalen Benutzers fälscht, kann daher zwar einen Datensatz hinterlassen, ihn aber nie für diesen Benutzer verwenden lassen.

Innerhalb einer Sprosse lautet die Konfliktregel das Neueste gewinnt, gemessen am Autocrypt-Gültigkeitsdatum der Nachricht; ein Korrespondent, der seinen Client neu installiert, erhält also keine Mail mehr, die an einen Schlüssel verschlüsselt ist, den er nicht mehr besitzt. Zwischen den beiden eingehenden Sprossen gilt die Regel nur in einer Richtung: Ein Schlüssel, den eine DKIM-signierte Nachricht gebracht hat, wird nie durch einen aus einer unsignierten Nachricht ersetzt, wie neu auch immer, während ein signierter Schlüssel einen unsignierten unabhängig von dessen Datum ersetzt. Sobald also die Domain eines Korrespondenten für seinen Schlüssel signiert hat, leitet das Fälschen seines From: seine Mail nicht mehr um; was bleibt, ist Schutz gegen einen passiven Angreifer für Korrespondenten, deren Domain nichts signiert, und mehr beansprucht Autocrypt nicht. Ein Betreiber, der opportunistische Verschlüsselung, aber keine Einführungen Dritter will, setzt [pepsi-keydiscovery] MIN_TRUST = harvested; einer, der sie nur für signierte Angaben will, setzt inbound-signed.

95.1.27.1.8. Wenn sich der Schlüssel eines Korrespondenten ändert

Neuester-gewinnt ist auf den From:-Header geschlüsselt, den der Absender schreibt, und die eingehende Authentifizierung ist fail-open, also kann eine Nachricht, die bloß behauptet, von einem Korrespondenten zu stammen, den Schlüssel ersetzen, mit dem wir an ihn verschlüsseln. Autocrypt nimmt das hin; Pepsi nimmt es ebenfalls hin, aber nie stillschweigend:

  • Ein Audit-Datensatz. Die Datenbank schreibt in derselben Anweisung wie die Ersetzung einen key.peer.rotate-Datensatz in pepsi.event_log (Schweregrad notice, Akteur autocrypt:inbound, autocrypt:inbound-signed oder autocrypt:gossip, Subjekt die Adresse des Korrespondenten), mit dem Protokoll, dem verdrängten und dem neuen Fingerabdruck und beiden Gültigkeitsdaten. Es gibt keine Rotation ohne ihren Datensatz. Er wird von GET /api/v1/events und im Ereignisprotokoll der Konsole aufgeführt und von pepsi-status(1) unter Schlüsseländerungen bei Korrespondenten zusammengefasst.

  • Eine Benachrichtigung an die Betroffenen. Ist RESPONSE_STAGE gesetzt, schickt Pepsi jedem lokalen Umschlagempfänger der Nachricht, die die Änderung verursacht hat, eine Benachrichtigung per Mail. Das sind die Personen, an die dieser Korrespondent gerade geschrieben hat, und ihre Antwort wird an den neuen Schlüssel verschlüsselt. Die Benachrichtigung nennt den Korrespondenten und beide Fingerabdrücke und gibt an, ob der neue Schlüssel der eigene des Korrespondenten war oder per Gossip eingeführt wurde (und von wem). Jeder Fingerabdruck wird als Hex und darunter in der PGP-Wortliste ausgegeben (ein Wort pro Byte, abwechselnd zwei- und dreisilbige Wörter), die Form zum lauten Vergleichen; die Vertrauensstufe des neuen Schlüssels wird genannt (inbound-signed, wenn die Domain des Korrespondenten die Nachricht mit einer ausgerichteten DKIM-Signatur signiert hat, die den Schlüssel abdeckte, inbound, wenn nichts das tat, gossip). Wenn ein pepsi-stage-encrypt-Abschnitt Schlüsselbefehle beantwortet (er hat ein RESPONSE_STAGE und ein KEYS_CONTROL_LOCAL_PART, das nicht none ist), gibt die Benachrichtigung außerdem den genauen Betreff an, mit dem ein Leser, der den Schlüssel verglichen hat, ihn pinnt (pepsi-stage-encrypt(1)): pin FPR CODE, gesendet an diese Adresse in der Domain des Empfängers. Sie hat den Null-Absender, Auto-Submitted: auto-generated und From: postmaster@<recipient's domain>, wird aus der Vorlage key-rotation.<lang>.body unter [pepsi] TEMPLATE_DIR für die erkannte state.language der Nachricht mit englischem Rückfall gerendert (dessen Existenz pepsi-setup(1) verlangt) und bei RESPONSE_STAGE eingespeist. „Lokal“ ist ein Empfänger an einer LOCAL_DOMAINS-Domain; niemand anderswo erhält je Mail, und niemandem wird etwas über seine eigene Adresse mitgeteilt. Lokale Benutzer, die mit der Adresse korrespondieren, diese Nachricht aber nicht erhalten haben, werden nicht benachrichtigt: Pepsi führt kein Verzeichnis darüber, wer mit wem korrespondiert, und eines dafür anzulegen wäre der schlechtere Handel. Der Audit-Datensatz deckt sie ab. Eine Benachrichtigung, die nicht eingereiht werden kann (eine nicht lesbare Vorlage, ein Datenbankfehler), wird auf Stufe warn protokolliert und nicht erneut versucht: Ein zweiter Durchlauf fände den neuen Schlüssel bereits gespeichert und hätte keine Änderung zu melden, sodass der Audit-Datensatz dann die einzige Aufzeichnung ist.

  • Eine Logzeile und ein Telemetrie-Zähler (autocrypt-rotation).

Eine Ersetzung durch eine echt bessere Quelle ist die Leiter, die wie vorgesehen funktioniert, und keine Rotation: zum Beispiel eine WKD- oder DANE-Antwort, die einen geernteten Schlüssel verdrängt, oder der eigene Autocrypt:-Header des Inhabers, der einen per Gossip gelernten verdrängt. Die eine Ersetzung durch eine bessere Quelle, die doch als Rotation behandelt wird, mit dem Datensatz, der Benachrichtigung und dem Zurückhalten durch ACCEPT_ROTATION, ist ein Schlüssel aus einer DKIM-signierten Nachricht, der einen anderen Schlüssel aus der unsignierten Mail desselben Korrespondenten verdrängt: Beides sind die eigenen Angaben des Korrespondenten, und die Empfänger sollten erfahren, dass die Domain jetzt für einen anderen Schlüssel bürgt.

Ein per Gossip erhaltener Schlüssel, den sein Inhaber bestätigt, wird befördert. Wenn der eigene Autocrypt:-Header des Absenders (oder ein angehängter Schlüssel, der ihn nennt) denselben Schlüssel trägt, den Gossip bereits für ihn gespeichert hat, wechselt der Datensatz von der Sprosse gossip zu inbound (oder zu inbound-signed, wenn diese Nachricht DKIM-signiert war). Das ist die Beförderung nach Autocrypt Level 1 §5.3. Da sich der Schlüssel nicht geändert hat, ist das weder eine Rotation noch zurückgehalten, und niemand erhält eine Benachrichtigung; die Datenbank schreibt in derselben Anweisung einen key.peer.promote-Datensatz (Schweregrad info, Akteur autocrypt:inbound, Detail das Protokoll, der Fingerabdruck, from_source gossip, source inbound und beide Gültigkeitsdaten), und die Stage protokolliert es. Das Gültigkeitsdatum des Datensatzes wird das eigene des Absenders, sodass eine spätere Rotation durch ihn an seiner eigenen Angabe gemessen wird und nicht an dem Datum, das die Nachricht eines Dritten trug. Das Urteil, das eine Signatur erreichen kann, bleibt unverändert (bestenfalls valid-untrusted, wie bei jedem geernteten Schlüssel), doch der Datensatz verteidigt sich nun auf dem Rang inbound, sodass ein späteres Gossip-Feld, das einen anderen Schlüssel für die Adresse anbietet, abgelehnt wird, und MIN_TRUST = harvested lässt ihn zu. ACCEPT_ROTATION spielt keine Rolle: Nichts wird verdrängt.

ACCEPT_ROTATION = expired verengt die Regel für einen Betreiber, der lieber eine echte Rotation ablehnt, als eine gefälschte anzunehmen: Der neuere Schlüssel wird nur übernommen, wenn jeder gespeicherte Schlüssel für diese Adresse und dieses Protokoll tot ist — seine Gültigkeit revoked oder expired oder sein expires_at in der Vergangenheit. Andernfalls wird der gespeicherte Schlüssel behalten und das Angebot zurückgehalten: ein key.peer.rotate.held-Datensatz (Schweregrad warning, mit dem behaltenen und dem angebotenen Fingerabdruck), dieselbe Benachrichtigung mit dem Hinweis, dass der neue Schlüssel nicht angenommen wurde, und der Zähler autocrypt-rotation-held. Ob ein Schlüssel tot ist, wird aus dem Gespeicherten gelesen, und jeder gelernte Schlüssel wird mit dem Ablauf gespeichert, den sein eigenes Material angibt: bei OpenPGP das Datum in der aktuellen Selbstsignatur des Primärschlüssels, bei S/MIME das notAfter des Zertifikats. Ein verfallener Schlüssel ist daher ab diesem Moment tot. Ein Schlüssel ohne angegebenen Ablauf ist erst tot, wenn er als widerrufen oder abgelaufen markiert ist oder ein Betreiber ihn entfernt (pepsi-keys peer remove) oder den neuen von Hand importiert (pepsi-keys peer import, das die Sprosse der geernteten Schlüssel übertrifft). Die Richtlinie wird über den Stage-Abschnitt gelesen, sodass eine pepsi.settings-Überschreibung für einen Empfänger bei einer in EDITABLE_STAGES aufgeführten Stage gilt.

95.1.27.1.9. Nachweis, dass ein Korrespondent unseren Schlüssel besitzt

Mit eingeschaltetem [stage-encrypt] ATTACH_KEYS_AS_FILES hängt pepsi-stage-encrypt(1) den öffentlichen Schlüssel des Absenders als Datei an, bis der Korrespondent ihn nachweislich besitzt. Diese Stage schreibt diesen Nachweis, ein Datensatz je (fingerprint, peer_address) in pepsi.peer_has_own_key, wenn eine eingehende Nachricht ihn zeigt:

  • sie wurde mit einem unserer Schlüssel entschlüsselt (state.crypto.in.decrypted und decrypted_with) und nicht bloß für den eigenen Mail-Client eines Benutzers durchgereicht;

  • sie trägt eine Signatur, deren Urteil valid oder valid-untrusted lautet und die den Klartext abdeckt (signature.covers_plaintext), sodass ein Fremder, der das Chiffrat eines anderen in seine eigene Signatur einhüllt, nichts beweist;

  • der Unterzeichner ist die From:-Adresse selbst (nie der beim Lernen von Schlüsseln verwendete Rückgriff auf den Umschlag), sodass ein gefälschtes From: den Anhang nicht unterdrücken kann.

Der Speicher prüft dann erneut, dass der Fingerabdruck einen aktiven MTA-Schlüssel (custody = local) der Adresse benennt, für die die Nachricht entschlüsselt wurde, und entfernt in derselben Anweisung Datensätze, deren Fingerabdruck keine aktive Identität mehr benennt. Der Eintrag ist auf den Fingerabdruck geschlüsselt, sodass ein neuer Schlüssel wieder angehängt wird. Ein Gegenüber, das verschlüsselt, ohne zu signieren, erhält die Datei weiterhin, was keinen Schaden anrichtet.

Dies läuft vor jeder Schranke für das Lernen von Schlüsseln: Es hält etwas über unseren eigenen Schlüssel fest, nicht über ihren, sodass weder LEARN_KEYS noch die Spam-Einschätzung etwas dazu zu sagen haben. Wie alles andere hier lässt es die Nachricht nie fehlschlagen.

95.1.27.1.10. Konfiguration

Die Optionen liegen im eigenen [stage-<name>]-Abschnitt der Stage (PROGRAM = pepsi-stage-autocrypt-learn): LEARN_KEYS, LEARN_GOSSIP, LEARN_FROM_SPAM, ACCEPT_ROTATION (newest, der Standardwert, oder expired), das optionale RESPONSE_STAGE für Benachrichtigungen über Schlüsseländerungen, die gemeinsamen Lokalitätsoptionen LOCAL_DOMAINS, TARGETS und RECIPIENT_DELIMITER (geparst, aber nur LOCAL_DOMAINS wird herangezogen) und ein verpflichtendes NEXT_STAGE. Die Stage parst außerdem [pepsi-keydiscovery], dessen NEGATIVE_TTL sie an den gemeinsamen Speichern-und-Freigeben-Pfad weiterreicht. Sie sind in pepsi.conf(5) dokumentiert.

Die Stage ist unprivilegiert: Sie schreibt nur öffentliches Schlüsselmaterial (und die Tatsache, dass ein Korrespondent unseren öffentlichen Schlüssel besitzt), läuft daher unter dem gewöhnlichen Dienstkonto pepsi und ist in das Multi-Call-Binärprogramm pepsi eingefaltet. Sie trägt kein setuid- oder setgid-Bit.

95.1.27.1.11. State

Eingaben: state.spam (die Einschätzung, die vorgelagerte Stages festhalten); state.crypto.in.encrypted, state.crypto.in.decrypted und state.crypto.in.outer_gossip, geschrieben von pepsi-stage-decrypt(1), die zusammen entscheiden, ob dem Gossip dieser Nachricht geglaubt werden darf. Der Absender wird der Spalte from_header entnommen, ersatzweise dem Umschlagabsender.

Ausgaben: keine an der Nachricht — ihr state bleibt unangetastet. Die Seiteneffekte sind pepsi.peer_key-Datensätze, pepsi.peer_has_own_key-Datensätze, key.peer.rotate/key.peer.rotate.held/key.peer.promote-Datensätze in pepsi.event_log und die bei RESPONSE_STAGE eingespeisten Benachrichtigungen über Schlüsseländerungen (Token <token>-key-rotation-<n>). Der Nachweis liest zusätzlich state.crypto.in.decrypted_with, state.crypto.in.for_client und state.crypto.in.signature. Das State-Layout wird in pepsi.state(7) beschrieben.

Übergänge: schaltet immer zu NEXT_STAGE weiter. Es gibt keine Verzweigung; die Stage pausiert nie, schlägt nie fehl, leitet nie um und schließt nie ab. Jeder Fehler beim Lernen wird protokolliert und dann ignoriert: Eine Nachricht wird gerade zugestellt, und nichts am Schlüsselmaterial eines Fremden darf dem im Weg stehen. Schlüsselmaterial, das sich nicht parsen lässt, ist Sache des Absenders und wird auf Stufe debug protokolliert; Material, das geparst wurde und nicht gespeichert werden konnte (ein Datenbankfehler), ist Sache dieses Hosts und wird auf Stufe warn protokolliert, damit ein Betreiber einen Speicher bemerkt, der aufgehört hat zu lernen. Die Konfiguration ist die Ausnahme: Der Abschnitt der Stage, [pepsi-keydiscovery] und die Krypto-Richtlinie von [pepsi] werden beim Start des Workers geprüft (eine kaputte lässt ihn den Start verweigern, Exit 78, und der Dispatcher hält die Warteschlange zurück), und ein Abschnitt, der sich unter einem laufenden Worker nicht mehr parsen lässt, wird erneut versucht statt stillschweigend übersprungen.

95.1.27.1.12. Befehle

worker

Läuft als persistenter pepsi-dispatch(1)-Worker, der Nachrichten-IDs von der Standardeingabe liest.

95.1.27.1.13. 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, sonst info).

-v, –verbose

Zeigt Log-Meldungen aus allen Quellen.

-h, –help; -V, –version

Gibt eine Verwendungsübersicht / die Version aus und beendet sich.

95.1.27.1.14. Exit-Status

0

Der Worker endete sauber (Standardeingabe geschlossen).

1

Ein Fehler ist aufgetreten (eine fehlkonfigurierte Stage oder ein Datenbankfehler). Der Grund wird in das Journal geschrieben.

78

Der Worker hat den Start verweigert: Sein Abschnitt, [pepsi-keydiscovery] oder die Krypto-Richtlinie von [pepsi] lässt sich nicht parsen. Der Dispatcher reiht erneut ein, was er übergeben hatte, und versucht die Stage später wieder.

95.1.27.1.15. Beispiele

Aus Nachricht 42 lernen (sie muss running sein):

echo 42 | pepsi-stage-autocrypt-learn -c /etc/pepsi/pepsi.conf worker

Eine eingehende Pipeline, die sie nach den Spam-Prüfungen und vor der Zustellung platziert:

[stage-check-whitelist]
PROGRAM = pepsi-stage-check-whitelist
NEXT_STAGE = autocrypt-learn
WHITELIST_NAME = correspondents

[stage-autocrypt-learn]
PROGRAM = pepsi-stage-autocrypt-learn
NEXT_STAGE = local

Empfänger benachrichtigen, wenn sich der Schlüssel eines Korrespondenten ändert, und eine Änderung erst annehmen, wenn der alte Schlüssel tot ist:

[stage-autocrypt-learn]
PROGRAM = pepsi-stage-autocrypt-learn
NEXT_STAGE = local
RESPONSE_STAGE = dkim-sign
ACCEPT_ROTATION = expired

Opportunistische Verschlüsselung beibehalten, aber Einführungen Dritter ablehnen:

[stage-autocrypt-learn]
PROGRAM = pepsi-stage-autocrypt-learn
NEXT_STAGE = local
LEARN_GOSSIP = no

95.1.27.1.16. Siehe auch

pepsi-stage-decrypt(1), pepsi-stage-encrypt(1), pepsi-keydisc(1), pepsi-keys(1), pepsi-stage-check-whitelist(1), pepsi-dispatch(1), pepsi-status(1), pepsi.conf(5), pepsi.state(7), pepsi-setup(1)

Das Kapitel Security des Handbuchs (A correspondent’s key changing, Which S/MIME container a correspondent gets) und sein Kapitel Threat model (Keys of correspondents) legen dar, wofür gelernten Schlüsseln vertraut wird.

95.1.27.1.17. Fehler

Melden Sie Fehler an den Pepsi-Issue-Tracker.