52. pepsi-stage-autocrypt-learn

Die Schlüssel von Korrespondenten aus der Mail lernen, die sie uns senden.

52.1. Rolle

pepsi-stage-autocrypt-learn ist die Stelle, an der Pepsi öffentliche Schlüssel aus eingehender Mail lernt. Die Stage liest den Autocrypt:-Header des Absenders, einen angehängten application/pgp-keys-Teil, das Zertifikat, das eine S/MIME-Signatur über die Nachricht erstellt hat, und bei einer verschlüsselt angekommenen Nachricht die Autocrypt-Gossip:-Felder, die die anderen Empfänger einführen (Autocrypt Level 1 §5.3). Sie lernt und schaltet weiter; sie verwirft, pausiert und schreibt eine Nachricht nie um und erzeugt nie einen Bounce, sodass NEXT_STAGE verpflichtend ist. Referenz: pepsi-stage-autocrypt-learn(1).

52.2. Funktionen

  • Platzierung. Sie läuft nach den Spam-Prüfungen und vor der Zustellung, denn Level 1 §5.3 sagt, dass der Peer-Zustand für eine als Spam vermutete Nachricht ignoriert werden SOLLTE, und das lässt sich erst einhalten, sobald ein Spam-Urteil vorliegt. pepsi-stage-decrypt läuft auf dem eingehenden Pfad zuerst, damit alles Nachgelagerte Klartext sieht; zu diesem Zeitpunkt hat noch keine Stage beurteilt, ob die Nachricht Müll ist.

  • Beachtet das Spam-Urteil: Aus einer Nachricht mit state.spam = true lernt die Stage nichts, sofern LEARN_FROM_SPAM nichts anderes sagt.

  • Nur der eigene Schlüssel des Absenders: Aus den Headern und Anhängen einer Nachricht lernt die Stage nur den Schlüssel des Absenders. Einen Dritten einzuführen ist Aufgabe des Gossip, und ein per Gossip gelernter Schlüssel landet auf einer niedrigeren Sprosse.

  • Nur ein Zertifikat, das signiert hat: Ein S/MIME-Zertifikat wird gelernt, wenn sich eine SignerInfo der Nachricht unter seinem Schlüssel über den signierten Inhalt verifizieren lässt, nie, weil ein SignedData es mitführt. Es landet auf inbound-signed, wenn DMARC beim Ingress bestanden wurde oder eine ausgerichtete, bestandene DKIM-Signatur den Nachrichtentext abdeckte, und andernfalls auf inbound; ein Zertifikat aus nicht authentifizierter Mail ersetzt nie eines aus authentifizierter Mail.

  • Gossip nur aus Chiffrat: Gossip wird nur geglaubt, wenn pepsi-stage-decrypt festgehalten hat, dass die Nachricht verschlüsselt ankam, und dass ihr ankommender Header-Block kein eigenes Autocrypt-Gossip:-Feld trug. Beides ist aus dem festgeschriebenen Klartext nicht ersichtlich, daher werden beide aus state.crypto.in gelesen.

  • Nie ein Schlüssel für eine Adresse, die dieser Host bedient: Ein Peer-Schlüssel für eine lokale Adresse ist der, mit dem unsere eigene ausgehende Mail an diesen Benutzer verschlüsselt würde, sodass ein Gossip-Feld, das eine solche benennt, eher eine Schlüsselersetzung als eine Einführung ist.

  • Hält fest, dass ein Korrespondent unseren Schlüssel besitzt: Wurde eine Nachricht mit einem unserer MTA-Schlüssel entschlüsselt und trägt sie eine gültige, den Klartext abdeckende Signatur ihrer From:-Adresse, wird ein pepsi.peer_has_own_key-Datensatz geschrieben, sodass pepsi-stage-encrypt diesen Schlüssel nicht mehr als Datei anhängt (ATTACH_KEYS_AS_FILES). Dies geschieht unabhängig davon, was LEARN_KEYS und das Spam-Urteil sagen, da es um unseren Schlüssel geht, nicht um deren.

  • Hält fest, was der S/MIME-Client eines Korrespondenten liest: Die SMIMECapabilities nach RFC 8551, die eine verifizierte Signatur mitführt, werden je signierendem Zertifikat in pepsi.smime_capability festgehalten, woraus pepsi-stage-encrypt und pepsi-stage-reencrypt für diesen Peer AES-GCM-AuthEnvelopedData oder AES-CBC-EnvelopedData wählen; ein von Hand gesetzter Datensatz (pepsi-keys peer capability set) gewinnt gegenüber einem gelernten. Siehe Welchen S/MIME-Container ein Korrespondent erhält.

  • Lehnt bekanntermaßen kompromittierte Schlüssel ab: Ein Schlüssel auf der badkeys-Sperrliste oder in pepsi.compromised_key wird nie gespeichert, und aus einer Nachricht, die mehr als acht Schlüssel für ihren Absender anbietet, lernt die Stage keinen.

  • Schlüsselwechsel geschehen nie stillschweigend: Wird der Schlüssel eines Korrespondenten unter der Regel „das Neueste gewinnt“ ersetzt, schreibt die Stage einen key.peer.rotate-Audit-Datensatz und mailt, wenn RESPONSE_STAGE gesetzt ist, den lokalen Empfängern der Nachricht eine Benachrichtigung. Diese zeigt beide Fingerabdrücke als Hex und als PGP-Wörter, die Vertrauensstufe des neuen Schlüssels und den pin-Befehl, der einen Vergleich festhält (Das eigene Pinnen eines Benutzers). ACCEPT_ROTATION = expired hält stattdessen einen neuen Schlüssel zurück, bis der gespeicherte tot ist. Ein per Gossip gelernter Schlüssel, den sein Besitzer später selbst ankündigt, wird auf die Sprosse inbound befördert.

  • Unprivilegiert: Sie schreibt nur öffentliches Schlüsselmaterial, sodass sie anders als die Krypto-Stages kein setuid-Bit braucht und in das Multi-Call-pepsi-Binärprogramm eingefaltet ist.

52.3. Konfiguration

LEARN_KEYS (Standardwert yes; ausgeschaltet lernt die Stage überhaupt keinen Schlüssel), LEARN_GOSSIP (Standardwert yes, und nur sinnvoll, solange LEARN_KEYS eingeschaltet ist), LEARN_FROM_SPAM (Standardwert no, gemäß dem SOLLTE aus Autocrypt Level 1 §5.3), ACCEPT_ROTATION (newest, der Standardwert, oder expired: den gespeicherten Schlüssel eines Korrespondenten erst ersetzen, wenn jeder gespeicherte Schlüssel der Adresse widerrufen oder abgelaufen ist), das optionale RESPONSE_STAGE (wo die Benachrichtigungen injiziert werden, die lokalen Empfängern mitteilen, dass sich der Schlüssel eines Korrespondenten geändert hat; ohne es wird eine Änderung nur protokolliert und als key.peer.rotate auditiert), die Lokalitätsoptionen LOCAL_DOMAINS (mit [pepsi-ingress] ACCEPTED_DOMAINS als Standardwert), TARGETS und RECIPIENT_DELIMITER, mit denen die Stage Gossip über lokale Benutzer ablehnt und die zu benachrichtigenden lokalen Empfänger auswählt, sowie ein verpflichtendes NEXT_STAGE. Die gesamte Nachricht wird geladen, da das Schlüsselmaterial in ihr steckt. Siehe Konfiguration.

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

52.4. Was ein gelernter Schlüssel wert ist

Ein gelernter Schlüssel ist mit Absicht wenig wert. Geerntete Schlüssel sitzen auf dem Rang inbound-signed (wenn eine bestandene, an From: ausgerichtete DKIM-Signatur sie abdeckte oder, bei einem S/MIME-Zertifikat, das signiert hat, DMARC bestanden wurde) oder inbound, per Gossip gelernte auf gossip. Das sind die drei untersten Sprossen der Vertrauensleiter. Ein solcher Schlüssel kann nie einen aus der Entdeckung oder von einem Betreiber verdrängen; eine gegen ihn geprüfte Signatur wird bestenfalls als valid-untrusted gemeldet, sodass sie nie state.signature_verified setzt; und ein peer_key-Datensatz wird für eine Adresse, für die dieser Host eine Identität hält, gänzlich ignoriert. Innerhalb einer dieser Sprossen gilt das Neueste gewinnt nach dem Autocrypt-Wirksamkeitsdatum der Nachricht (ein Schlüssel von einer niedrigeren Sprosse ersetzt nie einen von einer höheren). Ein Korrespondent, der seinen Client neu installiert, erhält daher keine Mail mehr, die an einen Schlüssel verschlüsselt ist, den er nicht mehr besitzt. Das schützt gegen einen passiven Gegner, und mehr beansprucht Autocrypt nicht. Schlüssel von Korrespondenten legt dar, wofür solchen Schlüsseln vertraut wird.

52.5. Siehe auch

pepsi-stage-decrypt, pepsi-stage-encrypt, pepsi-keydisc, pepsi-keys, Schlüsselverwaltung, Welchen S/MIME-Container ein Korrespondent erhält, Schlüssel von Korrespondenten, pepsi-stage-autocrypt-learn(1).