95.1.51. pepsi-keydisc¶
find a correspondent’s public key or certificate
- Handbuchabschnitt:
1
95.1.51.1.1. Name¶
pepsi-keydisc - asynchrone Schlüsselentdeckung, ein Dienst je Methode.
95.1.51.1.2. Übersicht¶
pepsi-keydisc [GLOBAL-OPTIONS] serve METHOD
pepsi-keydisc [GLOBAL-OPTIONS] probe ADDRESS
95.1.51.1.3. Beschreibung¶
pepsi-keydisc findet den OpenPGP-Schlüssel oder das S/MIME-Zertifikat eines Korrespondenten, hält fest, woher es kam und wie viel diese Quelle wert ist, und legt es in pepsi.peer_key ab (siehe pepsi-keys(1)). Einen Schlüssel zu finden ist leicht; schwierig ist, zu wissen, ob man ihm glauben soll. Daher trägt jedes Ergebnis seine Quelle und die Angabe, ob die Abfrage, die es lieferte, DNSSEC-validiert war, und die Richtlinie der Stage, die den Schlüssel verwendet, entscheidet, was gut genug ist.
Die Entdeckung ist asynchron und lebt außerhalb der Stages. Eine Stage, die einen Schlüssel braucht, der nicht in ihrem Cache liegt, betreibt nie eigene Netzwerk-E/A: Sie committet, was sie behalten darf, pausiert die Nachricht und reiht eine Anfrage in pepsi.key_request ein; eine pepsi-keydisc-Instanz beantwortet die Anfrage und gibt im selben Round-Trip, in dem sie den Schlüssel speichert, jede an dieser Adresse geparkte Nachricht frei:
stage cache hit -> use the key
fresh negative -> the no-key path, at once
cache miss -> park: commit, pause, enqueue
pepsi-keydisc@... LISTEN key_request -> look up -> store the key AND
release every parked message
Was das Parken committet, ist die Entscheidung der Stage, nicht dieses Programms. Insbesondere parkt pepsi-stage-decrypt(1) eine S/MIME-Nachricht mit committetem entschlüsseltem Klartext, weil die geschachtelte Signatur als gewöhnliche MIME-Schicht erhalten bleibt. Eine OpenPGP-Nachricht parkt es unverändert: Eine OpenPGP-Signatur lebt nur innerhalb des Paketstroms, und wer den Klartext committet, zerstört genau den Beleg, für dessen Prüfung der Schlüssel geholt wird.
Ein langsamer Keyserver hält also nie einen Stage-Worker auf; das Problem ist beseitigt, nicht bloß begrenzt. Der Schlüssel der Anfrage ist die Adresse, sodass hundert Nachrichten an einen Korrespondenten eine Abfrage kosten und gemeinsam freigegeben werden. Eine Anfrage, die sich ohne Schlüssel erledigt, gibt ihre Wartenden genauso frei wie eine, die einen Schlüssel gefunden hat: Die Dienste finden Schlüssel, die Stages entscheiden über Mail.
Es ist keine Stage. Es verbindet sich mit der gemeinsamen Datenbank über den [pepsi-postgres]-Abschnitt und wird vollständig durch [pepsi-keydiscovery] konfiguriert (siehe pepsi.conf(5)).
95.1.51.1.4. Eine Instanz je Methode¶
Es gibt ein Binärprogramm und einen Konfigurationsabschnitt, aber einen Prozess je Entdeckungsmethode, gestartet aus der systemd-Vorlagen-Unit pepsi-keydisc@.service:
pepsi-keydisc@daneDNS-
OPENPGPKEY(RFC 7929) und -SMIMEA(RFC 8162), unter einem gehashten Local-Part. Beide werden ohne das DNSSEC-AD-Bit des Resolvers abgelehnt. Die Resolver sind[pepsi] DNS_SERVERS(siehe pepsi.conf(5)), sonst die ausresolv.conf, und da Pepsi ihrem AD-Bit vertraut, statt DNSSEC selbst zu validieren, protokolliert die Instanz beim Start eine Warnung, wenn einer von ihnen weder auf diesem Host liegt noch über DNS over TLS oder HTTPS erreicht wird (jeder auf dem Weg dorthin könnte eine validierte Antwort fälschen), und wenn sie nicht validieren: Eine Probe nach dem signiertenSOAvonietf.org, die ohne das AD-Bit zurückkommt, bedeutet, dass jede Abfrage nichts findet.pepsi-keydisc@wkd-advancedDas Web Key Directory unter
openpgpkey.<domain>, unter/.well-known/openpgpkey/<domain>/hu/<hash>.pepsi-keydisc@wkd-directDas Web Key Directory an der Domain selbst, unter
/.well-known/openpgpkey/hu/<hash>.pepsi-keydisc@vksDie verifizierenden Keyserver aus
VKS_SERVERS, unter/vks/v1/by-email/<address>.pepsi-keydisc@ldapDas konfigurierte LDAP-Verzeichnis; nur in einem Build mit dem
ldap-Feature.
pepsi.target startet die ersten vier, die die Standard-SOURCES bilden.
Die Aufteilung trennt die Methoden voneinander: Ein hängendes LDAP-Bind kann WKD nicht aufhalten, und um eine Methode abzuschalten, führen Sie systemctl mask --now pepsi-keydisc@vks aus (und streichen sie aus SOURCES), statt etwas Gemeinsames neu zu starten. Die beiden Web-Key-Directory-Methoden haben getrennte Ränge und laufen daher als getrennte Instanzen gleichzeitig. Sie bilden keine Rückfallkette: Würde die direct-Methode nur versucht, „falls advanced fehlschlägt“, so würde die schwächere Antwort stillschweigend immer dann angenommen, wenn die stärkere bloß langsam war.
Das ist eine bewusste Abweichung von draft-koch-openpgp-webkey-service §3.1, der verlangt, dass zuerst die advanced-Methode versucht wird und die direct-Methode nur dort verwendet wird, wo die Sub-Domain openpgpkey überhaupt nicht existiert. Bei der Reihenfolge des Entwurfs geht es um Vertrauen und nicht um Geschwindigkeit: Das Apex-/.well-known/openpgpkey/ wird von dem bedient, was die Website der Domain betreibt, oft eine andere Partei als ihr Mailbetreiber. Auch bei einer Domain, die korrekt unter openpgpkey.<domain> veröffentlicht, wird hier also ihr Apex abgefragt, und eine Antwort vom Apex wird im Rang wkd-direct gespeichert, über LDAP, VKS und allem, was aus Mail geerntet wurde. Wo das zählt, kann SOURCES wkd-advanced ohne wkd-direct auflisten.
Eine Instanz, deren Methode nicht in [pepsi-keydiscovery] SOURCES erscheint, verweigert den Start, mit einer Meldung, die nennt, was SOURCES auflistet. Das ist keine Pedanterie: Die Rang-Gnadenfrist-Stoppregel wartet nur auf die von SOURCES benannten Methoden, sodass eine nicht gelistete Instanz eine Anfrage beantworten würde, auf die niemand wartet.
Schlüssel aus eingehender Mail zu ernten (application/pgp-keys-Teile, S/MIME-Unterzeichnerzertifikate, der Autocrypt:-Header) ist kein Entdeckungsdienst und hat keine Instanz. Es läuft inline dort, wo die Nachricht ohnehin ist, in pepsi-stage-autocrypt-learn(1), kostet keine Netzwerk-E/A und schreibt über denselben Pfad, sodass ein geernteter Schlüssel ebenfalls alles freigibt, was an dieser Adresse geparkt ist. inbound wird folglich in SOURCES abgelehnt, ebenso inbound-signed, die Sprosse, auf die dieselbe Stage einen Schlüssel anhebt, wenn ihn eine ausgerichtete DKIM-Signatur abdeckte, die beim Ingress bestanden hat.
Dasselbe gilt für gossip, die Schlüssel, die dieselbe Stage aus den Autocrypt-Gossip:-Feldern in einer verschlüsselt angekommenen Nachricht liest (Autocrypt Level 1 §5.3). Es ist eine zweite Inline-Sprosse und keine Variante von inbound, weil diese Schlüssel Dritten gehören statt dem Absender selbst und die Leiter sie auseinanderhalten können muss.
Beachten Sie, wo „inline“ liegt: pepsi-stage-decrypt(1) entnimmt die Zertifikate, die eine Nachricht mitführt, um ihre Signatur zu prüfen, und verwirft sie dann; es speichert nichts. Eine Pipeline ohne eine pepsi-stage-autocrypt-learn-Stage lernt überhaupt nie einen Schlüssel aus Mail, wie viel Material auch eintrifft, und keine noch so ausgefeilte [stage-decrypt]-Konfiguration ändert daran etwas.
95.1.51.1.5. Welcher Schlüssel einen Konflikt gewinnt¶
Ein Schlüssel, dessen Fingerabdruck für dieselbe Adresse und dasselbe Protokoll bereits gespeichert ist, ist überhaupt kein Konflikt: Der Datensatz wird an Ort und Stelle aktualisiert (seine Quelle, Gültigkeit, sein Ablauf und Autocrypt-Wirksamkeitsdatum werden fortgeschrieben, wobei sich die Quelle nur verbessern kann), und die Antwort ist refreshed. Das geschieht vor jedem Test unten, sodass das erneute Sehen eines gepinnten Schlüssels weiterhin auffrischt, was über ihn bekannt ist. Die gespeicherten und die eingehenden OpenPGP-Zertifikate werden zusammengeführt, nicht ausgetauscht, sodass ein Widerruf oder eine neuere Selbstsignatur, die die gespeicherte Kopie trägt, erhalten bleibt, wenn später eine ältere Kopie eintrifft; die Zusammenführung verwirft Signaturen, die sich nicht verifizieren lassen, und Komponenten, die nichts bindet. Die Zusammenführung geschieht gleich welchen Rang die eingehende Quelle hat: Ein Widerruf oder eine neuere Selbstsignatur, die nur eine schwächere Kopie trägt (die eigene Mail eines Korrespondenten, die einen zuerst über WKD gefundenen oder von Hand importierten Schlüssel wiederholt), wird in den gespeicherten Datensatz geschrieben, der dann als revoked markiert wird, wenn das zusammengeführte Zertifikat es ist, während seine Quelle, sein Rang und sein Pinning bleiben, wie sie waren. Das ist sicher, weil die Zusammenführung nur Signaturen behält, die der Schlüssel selbst (oder ein von ihm bestimmter Widerrufer) erstellt hat; eine schwächere Quelle kann einen anderen Schlüssel weiterhin nicht ersetzen.
Wenn ein entdeckter Schlüssel von allem abweicht, was für diese Adresse und dieses Protokoll gespeichert ist, entscheidet der Speicher in einem serverseitigen Schritt, in dieser Reihenfolge:
ein gepinnter Datensatz wird nie verdrängt, was auch immer eintrifft;
eine strikt besser eingestufte Quelle ersetzt alles Gespeicherte — sodass WKD einen geernteten Schlüssel verdrängt, ein Eintrag des Betreibers WKD verdrängt und ein per Gossip gelernter Schlüssel überhaupt nichts verdrängt; innerhalb der Autocrypt-Stufe ist die bessere Sprosse
inbound-signedgegenüberinbound, und diese eine Ersetzung wird als Rotation (unten) gemeldet und auditiert, da beides die eigenen Angaben des Korrespondenten sind;das Neueste gewinnt innerhalb der Autocrypt-Stufe (unten);
andernfalls wird der gespeicherte Schlüssel behalten und der neue nicht gespeichert, und die Antwort wird als
rejectedgemeldet.
95.1.51.1.5.1. Das Neueste gewinnt in der Autocrypt-Stufe¶
Die Peer-State-Aktualisierung von Autocrypt Level 1 ist jüngstes gewinnt: Ein Client speichert den Schlüssel aus der jüngsten Nachricht, die er mit einem Autocrypt:-Header gesehen hat. Regel 2 allein kann das nicht ausdrücken: Sie würde den zweiten je für eine Adresse gesehenen Autocrypt-Schlüssel ablehnen und den ersten für immer behalten, sodass ein Korrespondent, der seinen Client neu installiert, das Gerät wechselt oder seinen Schlüssel rotiert, weiterhin Mail erhielte, die an einen Schlüssel verschlüsselt ist, den er nicht mehr besitzt. Solche unlesbare Mail ist genau der Fehler, den Autocrypt vermeiden soll.
Regel 3 lässt daher einen neueren Schlüssel gewinnen, und sie ist so eingegrenzt, dass sie immer nur zwischen Behauptungen derselben Art entscheiden kann. Sie gilt, wenn alles davon zutrifft:
die eingehende Quelle ist
inbound-signed,inboundodergossip; undjeder derzeit für diese Adresse und dieses Protokoll gespeicherte Schlüssel steht ebenfalls auf einer dieser Sprossen — nichts, was ein Eigentümer oder ein Betreiber veröffentlicht hat, steht je auf dem Spiel; und
die eingehende Quelle rangiert mindestens so hoch wie die gespeicherte, sodass
inboundinboundersetzt undgossipgossipersetzt, aber die Vorstellung durch einen Dritten den Datensatz nie von dem wegnehmen kann, was der Eigentümer der Adresse über sich selbst gesagt hat, und ein Schlüssel aus einer unsignierten Nachricht ihn nie von einem Schlüssel wegnehmen kann, den eine DKIM-signierte Nachricht gebracht hat (inbound-signed), wie neu die unsignierte Nachricht auch zu sein behauptet; unddas Wirksamkeitsdatum der eingehenden Nachricht ist strikt neuer als das gespeicherte.
Das Wirksamkeitsdatum ist der Date:-Header der Nachricht, so gekappt, dass er nie in der Zukunft liegen kann, und der Empfangszeitpunkt, wenn der Header fehlt oder nicht parsbar ist — Level 1s eigene Definition. Bei gleichem Datum gewinnt daher das erste (eine erneut zugestellte Nachricht kann den Datensatz nicht umkippen), und ein Schlüssel, der überhaupt kein Wirksamkeitsdatum trägt — jede Netzwerkmethode —, verdrängt nie etwas.
Die Regel hat ihren Preis, denn ein Angreifer kann sie nutzen. Das Ernten ist auf den From:-Header geschlüsselt, den der Absender schreibt, und die eingehende Authentifizierung ist fail-open, sodass ein gefälschtes From: einen Schlüssel verdrängen kann, der selbst nur auf Vertrauen beim ersten Gebrauch beruhte. Das ist Autocrypts eigener Kompromiss: Es verteidigt gegen passives Sammeln, nicht gegen einen aktiven Angreifer auf dem Pfad. Die Regel ist oben nach allen vier Seiten begrenzt: Nichts, was die Domain (WKD, DANE), ein Keyserver, ein Verzeichnis oder der Betreiber veröffentlicht hat, kann angetastet werden, und ein gepinnter Datensatz ebenso wenig. Ein Betreiber, der die Regel nicht will, setzt [pepsi-keydiscovery] MIN_TRUST über die Stufe oder pinnt die Schlüssel, auf die es ankommt, mit pepsi-keys peer pin (siehe pepsi-keys(1)). Beachten Sie, dass eine Adresse, für die diese Installation eine Identität hält, aus dieser Identität beantwortet wird und überhaupt nie aus dem Peer-Cache.
Eine Ersetzung nach Regel 3 wird als rotated statt replaced gemeldet und schreibt in derselben Anweisung einen key.peer.rotate-Datensatz ins Audit-Log, sodass eine Rotation nicht ohne ihren Eintrag geschehen kann. Nur das eingehende Lernen (pepsi-stage-autocrypt-learn(1)) kann eine auslösen. Diese Stage benachrichtigt außerdem die lokalen Empfänger der Nachricht per Mail, und sie kann die Regel mit ACCEPT_ROTATION = expired einschränken (jeder gespeicherte Schlüssel muss als widerrufen oder abgelaufen festgehalten sein); dann wird eine abgelehnte Rotation als held gemeldet und als key.peer.rotate.held protokolliert. Die Netzwerkmethoden erreichen Regel 3 nie.
Ein inbound-signed-Schlüssel, der über einem gespeicherten inbound-Schlüssel eintrifft, ist dem Rang nach Regel 2, wird aber trotzdem als Rotation gemeldet und auditiert, und ACCEPT_ROTATION = expired hält ihn wie jeden anderen zurück. Wenn die sendende Domain für einen anderen Schlüssel bürgt als den, den die unsignierte Mail ihres Benutzers trug, ist das genau die Änderung, von der die Empfänger erfahren sollten. Der eigene Schlüssel des Inhabers, der über einem per Gossip gelernten eintrifft, bleibt eine gewöhnliche Ersetzung nach Regel 2.
Derselbe Fingerabdruck, erneut gesehen, ist eine Auffrischung, kein Konflikt, und der Datensatz übernimmt die bessere der beiden Quellen — sodass ein zuerst unsigniert gesehener Schlüssel auf inbound-signed wechselt, sobald ihn zum ersten Mal eine signierte Nachricht trägt, und nie zurück. Eine solche Auffrischung wird gesondert gemeldet: Ein aus Gossip gespeicherter Schlüssel, den nun die eigene Nachricht seines Inhabers (Quelle inbound oder inbound-signed) trägt, wird als promoted gemeldet und als key.peer.promote auditiert, nie als Rotation — die Beförderung aus dem Gossip nach Autocrypt Level 1 §5.3.
95.1.51.1.6. Schlüssel, deren private Hälfte bekannt ist¶
Ein entdeckter Schlüssel wird nicht gespeichert, wenn er auf der Liste bekanntermaßen kompromittierter Schlüssel steht oder wenn sein RSA-Modulus seine Primfaktoren preisgibt (ROCA, nahe beieinanderliegende Primzahlen, ein kleiner Faktor). Die Liste ist pepsi.compromised_key: die badkeys-Sperrliste mit den schwachen Debian-OpenSSL-Schlüsseln, die pepsi-keys blocklist update aktuell hält, und die Moduli, die das eigene pepsi-keys peer screen dieser Installation faktorisiert hat (siehe pepsi-keys(1)). Für einen solchen Schlüssel meldet die Methode, dass sie nichts gefunden hat, mit einer Warnung, die die Adresse nennt, und die Anfrage wird mit den Antworten der anderen Methoden abgeschlossen. Das Ernten in pepsi-stage-autocrypt-learn(1) wendet denselben Test an. Diese Rolle darf die Liste lesen und nichts weiter; nur pepsi-crypto schreibt sie.
95.1.51.1.7. Eine Abfrage, die im DNS fehlschlägt¶
Eine Anfrage, die ohne Schlüssel abgeschlossen wird, läse sich unabhängig vom Grund als „kein Schlüssel“, und opportunistische Verschlüsselung würde dann im Klartext senden. Ein Angreifer, der die Schlüsseleinträge des Empfängers fehlschlagen lassen kann (ein gefälschtes SERVFAIL, verworfene Antworten, eine DNSSEC-bogus-Antwort), erreichte so eine Herabstufung. Jede Instanz stuft daher eine fehlgeschlagene Abfrage ein, bevor sie sie meldet:
Für
daneein Fehlschlag derOPENPGPKEY- oderSMIMEA-Abfrage selbst; fürwkd-advancedundwkd-directein Fehlschlag beim Auflösen des WKD-Hostnamens (openpgpkey.domain oder die Domain), den die Instanz erneut erfragt, weil der Fehler des HTTPS-Clients nicht sagt, welche Schicht fehlschlug.Die Instanz fragt dann die
MX-,A- undAAAA-Einträge der Domain ab. Antwortet keiner mit einem Eintrag, ist der Fehlschlag unreachable; antwortet einer, schlagen die Schlüsseleinträge fehl, während die Domain antwortet (key-records).
Der stärkste Bericht einer Runde wird an der Anfrage behalten (dns_report). Wird die Anfrage ohne Schlüssel abgeschlossen, so wird dieser Bericht zu einem Urteil (key_request.dns_failure): unreachable; transient für Schlüsseleinträge, die fehlschlagen, während die Domain antwortet; und inconsistent, sobald das in drei aufeinanderfolgenden Runden geschehen ist, jede innerhalb einer Stunde nach der vorherigen — sodass ein verlorenes Paket oder ein Server, der einmal einen ungewöhnlichen Eintragstyp verwirft, eine Wiederholung und kein Urteil ist. Eine wegen eines DNS-Fehlers abgeschlossene Anfrage bleibt nur 15 Minuten statt ERROR_TTL frisch, weil die auf sie wartenden Nachrichten zurückgehalten, nicht gesendet werden (siehe pepsi-stage-encrypt(1), „DNS-Fehlschläge bei Empfängern“); eine Runde, die einen Schlüssel findet oder aus einem anderen Grund fehlschlägt, setzt die Zählung zurück.
Was bewusst nicht eingestuft wird und daher „kein Schlüssel“ bleibt: ein WKD-Fehlschlag, dessen Hostname auflöst (ein HTTPS-, TLS- oder 5xx-Fehler — häufig und harmlos), ein Fehlschlag eines Keyservers oder von LDAP und ein NXDOMAIN oder eine leere Antwort. Ohne DNSSEC ist ein gefälschtes NXDOMAIN oder eine gefälschte leere Antwort von einer echten nicht zu unterscheiden und liest sich weiterhin als „kein Schlüssel“.
95.1.51.1.8. Zwischengespeicherte Schlüssel auffrischen¶
Ein gespeicherter Schlüssel wird für CACHE_TTL verwendet und dann vom täglichen pepsi-keys-refresh.timer erneut geprüft (pepsi-keys peer refresh, siehe pepsi-keys(1)). Die Auffrischung fragt erneut nur die Methode, die den Schlüssel gefunden hat, und nur, wenn diese Methode noch in SOURCES steht: Ein vks-Schlüssel wird erneut von den Keyservern abgerufen, ein wkd-Schlüssel aus dem erweiterten Web Key Directory und ein wkd-direct-Schlüssel aus dem direkten, ein dane-Schlüssel aus dem DNS und ein ldap-Schlüssel aus dem Verzeichnis. Schlüssel, die keine Netzwerkmethode erzeugt hat, werden nie über das Netz aufgefrischt: die aus Mail geernteten inbound-signed-, inbound- und gossip-Schlüssel und die manual- und api-Schlüssel, die ein Betreiber eingetragen hat. Ein geernteter Schlüssel wird durch die nächste Nachricht seines Inhabers aktualisiert. Gepinnte Schlüssel und *@domain-Datensätze werden ebenfalls nicht aufgefrischt. Ein geernteter Schlüssel ist jedoch ein Grund nachzusehen: pepsi-stage-encrypt(1) stellt eine gewöhnliche Entdeckungsanfrage, höchstens einmal je NEGATIVE_TTL, wann immer es an einen Schlüssel auf einer dieser drei Sprossen verschlüsselt, sodass ein vom Inhaber veröffentlichter Schlüssel übernehmen kann.
Das ist eine Entscheidung für die Privatsphäre. Den ganzen Fan-out für jeden fälligen Schlüssel auszuführen würde dem Keyserver einmal täglich die gesamte Menge der Korrespondenten der Installation verraten, gleich welche Methode ihre Schlüssel tatsächlich gefunden hat; auf die ursprüngliche Methode beschränkt, erfährt der Keyserver nur von den Korrespondenten, deren Schlüssel er geliefert hat, und die eigenen Domains der Korrespondenten nur von ihren eigenen Adressen. Der Preis ist die Aktualität: Ein Widerruf, der nur auf einem Keyserver veröffentlicht wird, wird für einen Schlüssel, der aus WKD, DANE oder einer Nachricht stammt, nicht gesehen. pepsi-keys peer refresh --address führt weiterhin den ganzen Fan-out für eine Adresse aus, wenn ein Betreiber danach fragt.
95.1.51.1.10. Sperrlisten¶
Die Stages, die S/MIME-Signaturen verifizieren, arbeiten ohne Netz, daher müssen die Widerrufsdaten, gegen die sie prüfen, im Voraus abgerufen werden, und dies ist der eine Prozess, der für Schlüssel irgendetwas abruft. Sofern nicht [pepsi-keydiscovery] CRL_FETCH = no, führt jede Instanz neben ihrer Entdeckungsschleife eine zweite Schleife aus:
Ernten. Stündlich liest sie jedes zwischengespeicherte S/MIME-Peer-Zertifikat in
pepsi.peer_key(widerrufene ausgenommen) und registriert diehttp://- undhttps://-URIs seinercRLDistributionPoints-Erweiterung – höchstens zwei pro Zertifikat – inpepsi.crl_cache. Ein Zertifikat, das eine Entdeckungsmethode gerade gespeichert hat, wird sofort registriert, ebenso die Punkte jeder Kette von TLS-Client-Zertifikaten, die pepsi-ingress(1) validiert (TLS_AUTH_CLIENT_CA), übercrl_cache_register, den einen Schreibvorgang, den diese Rolle hier vornehmen darf. UnterCA_ISSUERS_FETCHwerden auch die Punkte jedes für einencaIssuers-Verweis abgerufenen Zwischenzertifikats (unten) registriert, sodass eine Kette über ein solches Zwischenzertifikat ganz abgedeckt werden kann; das verrät der CA nichts, was der Abruf ihres Zertifikats nicht verraten hätte. Ein Verteilungspunkt, der einencRLIssueroder nur einige Widerrufsgründe nennt, wird übersprungen, ebenso LDAP-URIs. Ein Punkt, den 30 Tage lang kein zwischengespeichertes Zertifikat genannt hat, wird vergessen.Abrufen. Alle fünf Minuten beansprucht sie die fälligen Punkte (jeder wird nur von einer Instanz abgerufen) und ruft jeden mit demselben gehärteten Client ab, den die WKD- und VKS-Abfragen verwenden: die SSRF-Adressprüfung, die Frist
METHOD_TIMEOUTfür die ganze Antwort und eine Byte-Obergrenze vonCRL_MAX_BYTES(Standardwert 1 MiB), die schon während des Streamens gilt. Dieser Abruf folgt jedoch keinen Umleitungen, und er verwendet einfacheshttp://, wenn das Zertifikat das nennt: Eine CRL ist von ihrem Aussteller signiert, und nach RFC 5280 liefern Verteilungspunkte sie über HTTP aus. Eine Antwort wird nur gespeichert, wenn sie eine DER-kodierte CRL ist, derennextUpdatevorhanden und in der Zukunft liegt und derenthisUpdatehöchstens eine Stunde in der Zukunft liegt (Uhrenabweichung), und nur, wenn sie nicht älter als die bereits gespeicherte Liste ist (eine wieder eingespielte alte Liste würde ein Zertifikat „ent-widerrufen“). Der Punkt wird erneut abgerufen, wenn seinnextUpdateeintrifft, mindestens aber täglich und höchstens stündlich; ein fehlgeschlagener Abruf wird nachERROR_TTLwiederholt und lässt die gespeicherte Liste an ihrem Platz.Ausmustern. Nach jedem Speichern prüft die Instanz, ob der Liste hier geglaubt werden kann. Das ist der Fall, wenn die Liste aktuell ist und eines von zwei Zertifikaten sie signiert hat: ein aktivierter Vertrauensanker (pepsi-keys(1)
ca) mit dem Namen des Ausstellers, der CRLs signieren darf, oder ein CA-Zwischenzertifikat dieses Namens, das für einencaIssuers-Verweis abgerufen wurde und dessen Pfad bis zu einem aktivierten Anker validiert (jede Signatur auf dem Pfad verifiziert, innerhalb ihrer Gültigkeit, eine CA, die CRLs signieren darf, jede Pfadbeschränkung beachtet, nötigenfalls über andere abgerufene Zwischenzertifikate). Kann der Liste geglaubt werden, so wird jedes zwischengespeicherte Zertifikat, das diesen Punkt nennt, diesen Aussteller hat und im Geltungsbereich der Liste liegt, in ihr nachgeschlagen. Eine gelistete Seriennummer markiert den Datensatz inpepsi.peer_keyalsrevoked(check_method = crl,revoked_at,revoked_reasonmit dem Punkt, dem Grundcode des Eintrags und seinem Datum), und das Journal sagt, welches Zertifikat welcher Adresse ausgemustert wurde. Der Datensatz wird nicht gelöscht: pepsi-keys peer list und peer show zeigen ihn weiterhin mit dem Grund, sein Fingerabdruck bleibt als widerrufen bekannt, sodass ein Verzeichnis, das das alte Zertifikat noch ausliefert, es nicht zurückbringen kann, und ein später gefundenes neu ausgestelltes Zertifikat ersetzt ihn (auch aus derselben Quelle, was ein lebender Datensatz bei gleichem Rang ablehnen würde; eine schwächere Quelle weiterhin nicht). Von diesem Moment an ist der Datensatz für niemanden ein Schlüssel: Jede Abfrage überspringt ihn, sodass pepsi-stage-encrypt(1) denON_NO_KEY-Weg des Empfängers nimmt und „revoked“ als Grund festhält, ohne eigenen Widerrufscode. Eine Liste, die keiner von beiden signiert hat, wird für den unten beschriebenen Verifizierer gespeichert, aber nichts handelt danach: Ein Verteilungspunkt ist meist einfacheshttp://, und Schlüssel auf das Wort einer unverifizierten Liste hin auszumustern ließe jeden auf diesem Weg die Mail eines Korrespondenten im Klartext senden lassen. Die Ankermenge gehört dem Betreiber: Eine Zwischen-CA, die ihre eigene Liste veröffentlicht, mustert nur dann etwas aus, wenn ihr Zertifikat abgerufen wurde (CA_ISSUERS_FETCH) und zu einem aktivierten Anker verkettet, oder wenn sie selbst mit pepsi-keys ca add hinzugefügt wird. Ein Zertifikat, das nach dem Abruf einer Liste gespeichert wird, wird beim nächsten erneuten Abruf geprüft, innerhalb eines Tages.
Das Speichern verifiziert nichts. Wenn eine Liste verwendet wird, kommt das Ausstellerzertifikat, gegen das ihre Signatur geprüft wird, mit der zu verifizierenden Nachricht. pepsi-stage-decrypt(1) liest die aktuellen Listen aus dem Cache (hinter seinem TRUST_ANCHOR_TTL), und der Verifizierer verwendet eine Liste für ein Zertifikat nur, wenn der Schlüssel des Ausstellers sie signiert hat, sie aktuell ist und ihr Geltungsbereich das Zertifikat abdeckt (eine partitionierte Liste für einen anderen Verteilungspunkt, ein Delta, eine indirekte oder eine auf Gründe beschränkte Liste nicht; ebenso wenig eine mit einer kritischen Erweiterung, die der Verifizierer nicht verarbeitet). Eine gelistete Seriennummer macht die Signatur bad mit dem Grund revoked.
Die Widerrufsprüfung schlägt für Mail weich fehl: Ein nicht erreichbarer Punkt, eine veraltete, nicht verifizierbare oder außerhalb des Geltungsbereichs liegende Liste oder ein nicht lesbarer Cache lässt das Urteil bei „nicht geprüft“ und jeden zwischengespeicherten Schlüssel in Verwendung, genau wie wenn nichts abgerufen wurde. Der eine harte Nutzer ist pepsi-ingress(1): Ein TLS-Client-Zertifikat, dessen Pfad einen Verteilungspunkt nennt, wird nicht angenommen, bis eine aktuelle Liste aus diesem Cache es abdeckt. Es gibt keine OCSP-Abfrage: Ein CRL-Abruf verrät der CA höchstens täglich, dass dieser Host irgendein von ihr ausgestelltes Zertifikat hält; eine OCSP-Abfrage würde ihr verraten, welches, in dem Moment, in dem eine damit signierte Nachricht eintrifft. (Eine Antwort, die ein TLS-Server anheftet, kostet keine Abfrage und wird in dieser Sitzung ausgewertet, pepsi-stage-relay-to-internet(1).)
95.1.51.1.11. Zwischenzertifikate¶
Viele Unterzeichner senden ihr S/MIME-Zertifikat ohne die CA-Zwischenzertifikate zwischen ihm und der Wurzel, und ein Pfad, den der Verifizierer nicht bauen kann, lässt die Signatur untrusted, selbst wenn die Wurzel ein konfigurierter Anker ist. Das Zertifikat selbst sagt, wo das Zertifikat seines Ausstellers veröffentlicht ist (der caIssuers-Eintrag seiner authorityInfoAccess-Erweiterung, RFC 5280 §4.2.2.1). Mit [pepsi-keydiscovery] CA_ISSUERS_FETCH = yes (Standardwert no) führt jede Instanz nach dem Zeitplan der CRL-Schleife eine dritte Schleife aus:
Ernten. Stündlich registriert sie die
http://- undhttps://-caIssuers-URIs jedes zwischengespeicherten S/MIME-Peer-Zertifikats – höchstens zwei pro Zertifikat, nie eineldap://-URI – inpepsi.ca_issuer_cache, und die jedes bereits abgerufenen Zertifikats, eine Ebene weiter oben, höchstens drei Ebenen über einem Peer-Zertifikat. Eine URL, die 30 Tage lang kein Zertifikat genannt hat, wird vergessen.Abrufen. Alle fünf Minuten beansprucht sie die fälligen URLs und ruft jede mit dem gehärteten Client und den Regeln des CRL-Abrufs ab (die SSRF-Adressprüfung, die Frist
METHOD_TIMEOUTfür die ganze Antwort, keine Umleitungen, einfacheshttp://, wo das Zertifikat es nennt), unter einer festen Byte-Obergrenze von 64 KiB. Die Antwort kann ein DER-Zertifikat, eincerts-only-CMS-Bündel oder PEM sein; ihre CA-Zertifikate werden gespeichert, höchstens vier, und alles andere wird abgelehnt und inlast_errorfestgehalten. Eine gespeicherte Antwort wird nach einer Woche erneut abgerufen, eine fehlgeschlagene nachERROR_TTL.
pepsi-stage-decrypt(1) liest die gespeicherten Zertifikate (hinter seinem TRUST_ANCHOR_TTL) und übergibt sie dem Verifizierer als Zwischenzertifikate, durch die ein Pfad laufen darf. Sie sind nie Anker und benennen nie einen Unterzeichner: Ein Pfad durch eines zählt nur, wenn jede Signatur darauf bis zu einem aktivierten pepsi-keys(1)-ca-Anker verifiziert, sodass eine gefälschte Antwort zwar nicht helfen, aber keine Signatur gültig machen kann. Die Option ist standardmäßig aus, weil jeder Abruf einer CA verrät, dass dieser Host mit einem ihrer Kunden korrespondiert; ist sie aus, lautet ein Unterzeichner, der keine Zwischenzertifikate sendet, untrusted.
95.1.51.1.12. Befehle¶
- serve METHOD
Führt die Dienstinstanz einer Methode bis zur Unterbrechung aus. METHOD ist eines von
dane,wkd-advanced,wkd-direct,vksoderldap— der Instanzname der systemd-Vorlage — und muss in[pepsi-keydiscovery] SOURCESerscheinen.Die Instanz lauscht mit
LISTENauf demkey_request-Kanal, dessen Nutzlast die Anfrage-ID ist, beantwortet jede Anfrage, die diese Methode noch schuldet, und macht beim Start und bei jeder Wiederverbindung des Listeners einen Durchlauf, sodass nichts verloren geht, was während ihrer Abwesenheit aufkam. Zwischen den Benachrichtigungen tickt sie einen kurzen Settle-Durchlauf: Ein Rang-Gnadenfrist-Fenster ist ein Zeitpunkt, also muss etwas auf die Uhr sehen, und eine Installation, die überhaupt eine Instanz betreibt, hat daher den Durchlauf. Eine einzelne fehlgeschlagene Abfrage wird auf der Anfrage festgehalten (was das kurzeERROR_TTLstatt des langenNEGATIVE_TTLauswählt) und beendet nie den Listener.- probe ADDRESS
Führt den gesamten Fächer für eine Adresse einmal aus und gibt aus, was jede Methode gefunden hat — das Protokoll, den Fingerabdruck, die Größe und
dnssecbei einer AD-validierten DANE-Antwort — oder den Fehler, auf den sie stieß, oder dass sie nichts gefunden hat.Bewusst nur lesend: Es speichert nichts, weder den Schlüssel noch einen Negativ-Cache-Eintrag. Ein Betreiber, der „warum hat dieser Korrespondent keinen Schlüssel“ diagnostiziert, will die Antwort jeder Methode sehen und nicht, dass eine Diagnose einen negativen Eintrag schreibt, der dann die echte Abfrage einen Tag lang unterdrückt. Um eine Adresse nachzuschlagen und das Ergebnis zu speichern, verwenden Sie
pepsi-keys peer refresh --address(siehe pepsi-keys(1)).Eine durch
ALLOW_DOMAINS/DENY_DOMAINSausgeschlossene Adresse wird als solche gemeldet und nicht abgefragt.
95.1.51.1.13. Privilegien¶
Die Dienste laufen unter ihrem eigenen unprivilegierten Konto pepsi-keydisc — nicht dem Dienstbenutzer pepsi und nicht pepsi-crypto. Dieser Daemon parst Schlüsselmaterial, das aus dem offenen Internet geholt wurde (ein feindlicher WKD-Inhalt, eine Keyserver-Antwort, ein DNS-Eintrag), was ihn zum wahrscheinlichsten Prozess hier macht, in den eingebrochen wird, sodass pepsi-setup(1) ihm die engste Datenbankrolle der Installation gibt:
SELECT/INSERT/UPDATE/DELETEaufpepsi.peer_key— den Cache zu füllen ist seine ganze Aufgabe, und die Konfliktregel muss einen Datensatz ersetzen können;SELECT/INSERT/UPDATEaufpepsi.key_request— die Arbeitswarteschlange, die er beantwortet;EXECUTEauf denkeydisc_*-Funktionen und den beidencrypto_*-Helfern, die sie aufrufen;auf
pepsi.workqueueSELECTplus einUPDATE (status, timeout)auf Spaltenebene;SELECT/INSERT/UPDATE/DELETEaufpepsi.crl_cache, die Sperrlisten, die sie abruft. Sie ist der einzige Schreiber des Caches; die Rollenpepsiundpepsi-cryptodürfen ihn nur lesen, sodass ein kompromittierter Stage-Worker keine aktuelle Liste löschen kann, um einen Widerruf zu unterdrücken;SELECT/INSERT/UPDATE/DELETEaufpepsi.ca_issuer_cache, die Zwischenzertifikate, die sie abruft, deren einziger Schreiber sie ebenfalls ist;SELECTaufpepsi.ca_trust, die aktivierten Anker, gegen die die Signatur einer abgerufenen Liste geprüft wird, bevor die Zertifikate, die sie listet, ausgemustert werden.
Nichts sonst.
Diese beiden Spalten reichen genau aus, um einen geparkten Datensatz von paused zurück auf pending zu bewegen, was innerhalb von keydisc_resolve/keydisc_sweep geschieht. Mit einer Berechtigung auf Tabellenebene könnte dieses Konto die Empfänger oder den Nachrichtentext einer Nachricht umschreiben; mit diesen beiden Spalten kann es eine Nachricht nur aufwecken. Es hat überhaupt keinen Zugriff auf pepsi.crypto_identity und damit auf keinen privaten Schlüssel.
Das Programm trägt kein setuid- oder setgid-Bit und ist in das Multi-Call-pepsi-Binärprogramm eingefaltet. Als root gestartet wird es vor dem Verbinden zum Konto pepsi-keydisc (die Konfiguration und ein etwaiges @inline-secret@-Fragment werden zuerst als aufrufender Benutzer gelesen), sodass es zum Testen aus einer root-Shell ohne sudo -u gestartet werden kann.
95.1.51.1.14. LDAP ist ein Feature zur Kompilierzeit¶
Der LDAP-Client liegt hinter dem Cargo-Feature ldap und ist standardmäßig aus: Er fügt eine Abhängigkeit hinzu, und eine Installation ohne Verzeichnis sollte keine linken. Ein Build ohne das Feature verweigert den Start von pepsi-keydisc@ldap mit einer entsprechenden Meldung, statt für immer stillschweigend „kein Schlüssel“ zu antworten, und pepsi-setup(1) lehnt auf einem solchen Build eine Konfiguration ab, die ldap in SOURCES auflistet — ebenso wie eine, die ldap ohne LDAP_URL und LDAP_BASE auflistet.
95.1.51.1.15. Globale Optionen¶
Diese globalen Optionen stehen vor dem Unterbefehl (ein nachgestelltes Flag wird abgelehnt).
- -c FILE, –config FILE
Liest die Konfiguration aus FILE, statt die Standardorte zu durchsuchen.
- -L LOGLEVEL, –log LOGLEVEL
Setzt die Log-Ausführlichkeit. LOGLEVEL ist eines von
error,warn,info,debugodertrace(Standardwert:[pepsi] LOG, sonstinfo).- -v, –verbose
Zeigt Log-Meldungen aus allen Quellen, einschließlich Drittanbieter-Bibliotheken.
- -h, –help
Gibt eine Verwendungsübersicht aus und beendet sich.
- -V, –version
Gibt die Version aus und beendet sich.
95.1.51.1.16. Signale¶
- SIGINT, SIGTERM
Nimmt keine neuen Anfragen mehr an und beendet sich. Nichts geht verloren: Eine unbeantwortete Anfrage bleibt
pendinginpepsi.key_requestund wird vom Start-Durchlauf der nächsten Instanz aufgenommen oder erledigt sich an ihrer eigenen Frist.
95.1.51.1.17. Exit-Status¶
- 0
Sauberes Herunterfahren oder ein abgeschlossenes probe.
- 1
Ein Fehler ist aufgetreten: eine fehlerhafte Konfiguration, eine Methode, die
[pepsi-keydiscovery] SOURCESnicht auflistet,ldapin einem Build ohne das Feature oder eine fehlgeschlagene Datenbankverbindung. Einzelne fehlgeschlagene Abfragen sind keine Fehler — sie werden auf der Anfrage festgehalten, und der Dienst läuft weiter.- 78
Das Datenbankschema ist nicht das, was dieser Build erwartet (nicht installiert, älter, neuer oder verändert): Führen Sie pepsi-setup(1)
schemaaus.
95.1.51.1.18. Beispiele¶
pepsi.target startet die Standardmenge von Methoden (dane wkd-advanced wkd-direct vks). Ohne das Target starten Sie sie von Hand:
systemctl enable --now pepsi-keydisc@dane pepsi-keydisc@wkd-advanced \
pepsi-keydisc@wkd-direct pepsi-keydisc@vks
Eine Methode abschalten, ohne die Konfiguration der anderen anzufassen:
systemctl mask --now pepsi-keydisc@vks
(danach [pepsi-keydiscovery] SOURCES = dane wkd-advanced wkd-direct setzen, damit die Stoppregel aufhört, auf eine Antwort zu warten, die nie kommt). mask statt disable: pepsi.target startet eine bloß deaktivierte Instanz wieder.
Herausfinden, was jede Methode über eine Adresse sagt, ohne etwas zu ändern:
pepsi-keydisc -c /etc/pepsi/pepsi.conf probe bob@example.com
Eine Instanz im Vordergrund mit vollem Logging ausführen, um zu sehen, warum eine Adresse keinen Schlüssel liefert:
pepsi-keydisc -c /etc/pepsi/pepsi.conf -L debug serve wkd-advanced
95.1.51.1.19. Siehe auch¶
pepsi-keys(1), pepsi-setup(1), pepsi.conf(5), pepsi.state(7), pepsi-dispatch(1), pepsi-config(1)
Das Kapitel Security des Handbuchs legt die Mechanismen dar, die dieses Programm implementiert (A correspondent’s key changing, A key lookup that fails in the DNS, Key-discovery SSRF, Key-discovery certificate authorities); sein Kapitel Threat model legt dar, was sie versprechen (Keys of correspondents).
95.1.51.1.20. Fehler¶
Melden Sie Fehler an den Pepsi-Issue-Tracker.