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-Vorlagepepsi-keydisc@.service:@dane,@wkd-advanced,@wkd-direct,@vksund (in einem Build mit dem Cargo-Featureldap)@ldap.SOURCESverwendet standardmäßig die ersten vier, diepepsi.targetstartet. Ein hängendes LDAP-Bind kann WKD nicht aufhalten. Um eine Methode abzuschalten, führen Siesystemctl mask --now pepsi-keydisc@vksaus und entfernen die Methode ausSOURCES(mask, weilpepsi.targeteine bloß deaktivierte Instanz wieder startet). Eine Instanz, deren Methode in[pepsi-keydiscovery] SOURCESfehlt, verweigert den Start, weil die Stopp-Regel nur auf die vonSOURCESbenannten 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) undSMIMEA(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 warntpepsi-keydisc@danebeim Start, wenn ein Resolver ausresolv.confnicht 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_BUNDLEersetzt 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 dieMX- undA/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 abgeschlossenenkey_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 waspepsi-keys peer screenfaktorisiert 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 refreshprüft einenvks-Schlüssel erneut beim Keyserver, einen WKD-Schlüssel bei derselben WKD-Methode, einendane-Schlüssel im DNS und einenldap-Schlüssel im Verzeichnis, und nur, solange diese Methode inSOURCESsteht; 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 = nogesetzt ist, ruft jede Instanz außerdem inpepsi.crl_cachedie CRLs ab, die zwischengespeicherte S/MIME-Peer-Zertifikate in ihrencRLDistributionPointsnennen (http:///https://, höchstens zwei pro Zertifikat, keine Umleitungen,CRL_MAX_BYTES). UnterCA_ISSUERS_FETCHruft sie auch die CRLs ab, die die abgerufenen Zwischenzertifikate nennen. Jede Liste ruft sie zu derennextUpdate, 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, diekeydisc_*-Funktionen undpepsi.crl_cache, und aufpepsi.workqueuenurSELECTplus einUPDATE (status, timeout)auf Spaltenebene, was genügt, um eine geparkte Nachricht zu wecken, und nicht mehr. Es ist der einzige Schreiber vonpepsi.crl_cache, sodass ein kompromittierter Stage-Worker keine aktuelle Liste löschen kann, um einen Widerruf zu unterdrücken. Es hat keinen Zugriff aufpepsi.crypto_identity. Es läuft unter seinem eigenen Kontopepsi-keydiscohne 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).