77. pepsi-keydisc

Den öffentlichen Schlüssel oder das Zertifikat eines Korrespondenten finden und festhalten, wie viel seine Quelle wert ist.

77.1. Rolle

pepsi-keydisc ist die Schlüssel-Entdeckungs-Schicht: Zu einer E-Mail-Adresse findet es den OpenPGP-Schlüssel oder das S/MIME-Zertifikat des Korrespondenten, hält fest, woher es stammt und ob die Abfrage DNSSEC-validiert war, und speichert es in pepsi.peer_key zwischen. Es ist keine Stage. Es verbindet sich über [pepsi-postgres] und wird vollständig durch [pepsi-keydiscovery] konfiguriert.

Die Entdeckung ist asynchron und außerhalb der Stages. Eine Stage, die einen Schlüssel braucht, den sie nicht im Cache hat, betreibt keine Netzwerk-E/A: Sie committet die bereits geleistete Arbeit, pausiert die Nachricht und reiht eine Anfrage in pepsi.key_request ein; eine Entdeckungsinstanz beantwortet die Anfrage und gibt im selben Round-Trip, in dem sie den Schlüssel speichert, jede an dieser Adresse geparkte Nachricht frei. So wartet nie ein Stage-Worker auf einen Keyserver, hundert Nachrichten an einen Korrespondenten kosten eine Abfrage, und eine Anfrage, die sich ohne Schlüssel erledigt, gibt ihre Wartenden ebenso frei. Die Dienste finden Schlüssel, und die Stages entscheiden über Mail. Referenz: pepsi-keydisc(1).

Das Kapitel Schlüsselverwaltung erklärt die Vertrauensrangfolge, nach der diese Ergebnisse beurteilt werden, und wie sich die Entdeckungsschicht zum Schlüsselspeicher als Ganzem verhält.

77.2. Funktionen

  • Ein Prozess je Methode (pepsi-keydisc serve <method>), aus der systemd-Vorlage pepsi-keydisc@.service: @dane, @wkd-advanced, @wkd-direct, @vks und (in einem Build mit dem Cargo-Feature ldap) @ldap. SOURCES verwendet standardmäßig die ersten vier, die pepsi.target startet. Ein hängendes LDAP-Bind kann WKD nicht aufhalten. Um eine Methode abzuschalten, führen Sie systemctl mask --now pepsi-keydisc@vks aus und entfernen die Methode aus SOURCES (mask, weil pepsi.target eine bloß deaktivierte Instanz wieder startet). Eine Instanz, deren Methode in [pepsi-keydiscovery] SOURCES fehlt, verweigert den Start, weil die Stopp-Regel nur auf die von SOURCES benannten Methoden wartet.

  • Die beiden WKD-Methoden sind getrennte Ränge, daher laufen sie als getrennte, gleichzeitige Instanzen statt als Rückfallkette. „direct“ nur „falls advanced fehlschlägt“ auszuführen, würde die schwächere Antwort immer dann annehmen, wenn die stärkere bloß langsam war.

  • DANE ist an das AD-Bit gebunden. OPENPGPKEY (RFC 7929) und SMIMEA (RFC 8162) werden ohne das DNSSEC-AD-Bit des Resolvers rundweg abgelehnt: Eine unvalidierte DNS-Antwort ist keine schwächere Antwort, sie ist keine Antwort. Dem AD-Bit wird nur vertraut, es wird nicht geprüft, daher warnt pepsi-keydisc@dane beim Start, wenn ein Resolver aus resolv.conf nicht auf Loopback liegt oder bei einer signierten Probeantwort das AD-Bit nicht setzt.

  • Ein gehärteter Abruf für WKD und VKS: nur HTTPS, Zertifikatsvalidierung ohne unsicheren Modus, höchstens eine HTTPS-zu-HTTPS-Umleitung zum selben Host, Verweigerung von Verbindungen zu Loopback-/privaten/Link-Local-Adressen, eine während des Streamens durchgesetzte Byte-Obergrenze, eine Frist für jeden Schritt und IDNA-A-Label-Umwandlung. Ein zurückgegebener Schlüssel, dessen User-ID die abgefragte Adresse nicht benennt, wird verworfen (SSRF bei der Schlüsselentdeckung).

  • Welche Zertifizierungsstellen für eine WKD- oder Keyserver-Antwort bürgen. [pepsi-keydiscovery] TLS_CA_BUNDLE ersetzt für diese Abrufe den System-Wurzelspeicher durch die CA-Zertifikate einer PEM-Datei (auch für den Keyserver-Verkehr von pepsi-keys und pepsi-stage-vks-confirm); eine unlesbare oder leere Datei verhindert den Start der Instanz, statt auf die System-Wurzeln zurückzufallen.

  • Eine Abfrage, die im DNS fehlschlägt, ist nicht „kein Schlüssel“. Eine fehlgeschlagene OPENPGPKEY/SMIMEA-Abfrage oder ein WKD-Hostname, der nicht auflöst, wird eingestuft, indem auch die MX- und A/AAAA-Einträge der Domain abgefragt werden: unreachable, wenn nichts antwortet, transient, wenn nur die Schlüsseleinträge fehlschlagen, und inconsistent nach drei solchen Runden, jede innerhalb einer Stunde nach der letzten. Das Urteil wird auf dem abgeschlossenen key_request-Datensatz gespeichert, und pepsi-stage-encrypt hält die Nachricht zurück oder leitet sie um, statt sie im Klartext zu senden (Ein Schlüssel-Lookup, der im DNS scheitert).

  • Schlüssel, deren private Hälfte bekannt ist, werden nicht gespeichert. Ein entdeckter Schlüssel auf der Liste bekanntermaßen kompromittierter Schlüssel (pepsi.compromised_key: badkeys, die schwachen Debian-OpenSSL-Schlüssel und was pepsi-keys peer screen faktorisiert hat) oder mit einem RSA-Modulus, der seine Primfaktoren preisgibt (ROCA, nahe beieinanderliegende Primzahlen, ein kleiner Faktor), zählt bei dieser Methode als „kein Schlüssel“.

  • Konflikte werden serverseitig entschieden, und Zertifikate werden zusammengeführt. Wird derselbe Fingerabdruck erneut gesehen, wird der Datensatz an Ort und Stelle aktualisiert, und die Zertifikate werden zusammengeführt. Ein Widerruf, den die gespeicherte Kopie trägt, überdauert so eine ältere Kopie; ein anderer Schlüssel ersetzt den gespeicherten nur aus einer echt besser eingestuften Quelle, nie einen gepinnten Datensatz (Schlüssel von Korrespondenten).

  • Die Auffrischung fragt nur die Methode, die den Schlüssel gefunden hat. Das tägliche pepsi-keys peer refresh prüft einen vks-Schlüssel erneut beim Keyserver, einen WKD-Schlüssel bei derselben WKD-Methode, einen dane-Schlüssel im DNS und einen ldap-Schlüssel im Verzeichnis, und nur, solange diese Methode in SOURCES steht; geerntete, per Gossip gelernte und von Hand eingetragene Schlüssel werden nie über das Netz aufgefrischt, sodass der Keyserver nicht die ganze Korrespondentenliste der Installation erfährt.

  • S/MIME-Sperrlisten. Sofern nicht CRL_FETCH = no gesetzt ist, ruft jede Instanz außerdem in pepsi.crl_cache die CRLs ab, die zwischengespeicherte S/MIME-Peer-Zertifikate in ihren cRLDistributionPoints nennen (http:///https://, höchstens zwei pro Zertifikat, keine Umleitungen, CRL_MAX_BYTES). Unter CA_ISSUERS_FETCH ruft sie auch die CRLs ab, die die abgerufenen Zwischenzertifikate nennen. Jede Liste ruft sie zu deren nextUpdate, mindestens aber täglich, erneut ab, und sie ersetzt nie eine gespeicherte Liste durch eine ältere. pepsi-stage-decrypt prüft Unterzeichnerketten gegen diese Listen; die Prüfung fällt weich auf „nicht geprüft“ zurück, und es gibt kein OCSP. Eine gespeicherte Liste mustert die zwischengespeicherten Zertifikate aus, die sie widerruft, wenn sie von einem aktivierten Vertrauensanker mit dem Namen des Ausstellers signiert wurde oder von einem abgerufenen Zwischenzertifikat, dessen Pfad zu einem solchen Anker validiert. Ein ausgemustertes Zertifikat zählt für pepsi-stage-encrypt nicht als Schlüssel.

  • probe ADDRESS — führt den ganzen Fan-out für eine Adresse aus und gibt aus, was jede Methode gefunden hat, ohne etwas zu speichern (nicht einmal einen Negativ-Cache-Eintrag), als Diagnose.

  • Die engste Datenbankrolle der Installation, eingerichtet von pepsi-setup: peer_key, key_request, die keydisc_*-Funktionen und pepsi.crl_cache, und auf pepsi.workqueue nur SELECT plus ein UPDATE (status, timeout) auf Spaltenebene, was genügt, um eine geparkte Nachricht zu wecken, und nicht mehr. Es ist der einzige Schreiber von pepsi.crl_cache, sodass ein kompromittierter Stage-Worker keine aktuelle Liste löschen kann, um einen Widerruf zu unterdrücken. Es hat keinen Zugriff auf pepsi.crypto_identity. Es läuft unter seinem eigenen Konto pepsi-keydisc ohne setuid- oder setgid-Bit.

77.3. Siehe auch

pepsi-keys, pepsi-setup, Schlüsselverwaltung, RFC-Index, Schlüssel von Korrespondenten, Ein Schlüssel-Lookup, der im DNS scheitert, pepsi-keydisc(1), pepsi-keys(1), pepsi.conf(5).