76. pepsi-keys

Den Ende-zu-Ende-Schlüsselspeicher verwalten.

76.1. Rolle

pepsi-keys ist das Werkzeug des Betreibers für den Speicher der Schlüssel, die Pepsi für die Ende-zu-Ende-Kryptographie verwendet: pepsi.crypto_identity (die Schlüsselpaare der von uns bedienten Adressen, private Hälfte eingeschlossen und im Ruhezustand verpackt), pepsi.peer_key (die zwischengespeicherten öffentlichen Schlüssel und Zertifikate entfernter Korrespondenten) und pepsi.ca_trust (die CA-Zertifikate, gegen die eingehende S/MIME-Ketten validiert werden). Es verbindet sich über den gemeinsamen [pepsi-postgres]-Abschnitt und liest die CRYPTO_*-Optionen von [pepsi] sowie den [pepsi-crypto]-Abschnitt. Es ist keine Stage. Referenz: pepsi-keys(1); der Entwurf ist in Schlüsselverwaltung erläutert.

Es ist eines der eigenständigen Binärprogramme außerhalb der vereinheitlichten ausführbaren Datei pepsi, aus zwei Gründen: Es ist das einzige Programm, das Schlüsselmaterial erzeugt (es einzufalten würde Schlüsselerzeugung und Zertifikatsausstellung in jeden Stage-Worker linken), und ein Standort kann es setuid installieren, damit Benutzer ihre eigenen Identitäten verwalten können, und dieses Bit kann ein gemeinsames Multi-Call-Binärprogramm nicht tragen.

76.2. Funktionen

  • identity list / show — welches Material für eine Adresse existiert: Protokoll, Zweck, Status, ob es das primäre für seine Fähigkeit ist, ob es veröffentlicht ist, ob die private Hälfte vorhanden, getilgt oder nie gehalten worden ist (client für den eigenen MUA-Schlüssel des Benutzers, dessen private Hälfte in seinem Mail-Client liegt), und bei show außerdem die Verwahrung, ob es das öffentliche Gesicht der Adresse ist, und sein Zustand auf dem Keyserver. list --served ergänzt, was das Web Key Directory und die OPENPGPKEY/SMIMEA-Einträge für jede aufgeführte Adresse tatsächlich ausliefern, abgerufen wie ein Korrespondent es täte, und meldet einen Fingerabdruck, den der Speicher nicht veröffentlicht (Prüfen, was tatsächlich ausgeliefert wird).

  • identity generate — Schlüsselmaterial erzeugen und speichern. OpenPGP erzeugt einen übertragbaren Schlüssel (standardmäßig Ed25519, RSA optional); S/MIME erzeugt ein Signier- und ein Verschlüsselungszertifikat, jedes selbstsigniert zur sofortigen Nutzung, oder unter CRYPTO_SMIME_SHARED_KEY ein Zertifikat mit beiden Schlüsselverwendungen. --csr gibt zusätzlich je Schlüssel eine PKCS#10-Anforderung aus, sodass eine echte CA einen Ersatz ausstellen kann, ohne neu zu schlüsseln.

  • identity import / export / csr — anderswo erzeugtes Material ablegen (ein ohne --private importierter öffentlicher OpenPGP-Schlüssel wird als eigener MUA-Schlüssel des Benutzers registriert), Material in seiner eigenen Binärform wieder ausgeben (--pem für X.509) oder eine Zertifikatsanforderung über den vorhandenen Schlüssel einer Identität bauen.

  • identity revoke / retire / forget-private — der Lebenszyklus. Der Widerruf und der periodische retire-Lauf zerstören privates Signier-Material und behalten Entschlüsselungsmaterial; revoke signiert zuerst ein Widerrufszertifikat, solange der private Schlüssel noch existiert, das das Web Key Directory dann ausliefert und das zum Keyserver geht, wann immer der Schlüssel dort hochgeladen worden war (--upload sendet es an einen, der ihn nie hatte). forget-private ist der ausdrückliche, bestätigte Weg (-y überspringt die Rückfrage), einen Entschlüsselungsschlüssel zu zerstören. rotate-due (pepsi-keys-rotate.timer, täglich) ersetzt jeden vom Server gehaltenen Verschlüsselungsschlüssel, der älter als [pepsi-crypto] ENCRYPTION_ROTATION_DAYS ist. Außerdem zerstört es ausgemusterte private Hälften, sobald RETIRED_PRIVATE_GRACE_DAYS verstrichen sind, es sei denn, eine Nachricht in der Warteschlange ist noch an sie verschlüsselt.

  • identity set-primary / publish / unpublish / delete — das für neue Nachrichten verwendete Material wählen, eine Adresse in die Veröffentlichung ein- oder ausschließen (publish kann sie auch auf einen Schlüsselserver hochladen) oder einen Datensatz rundweg entfernen.

  • peer list / show / import / pin / unpin / refresh / prune / remove — die zwischengespeicherten Peer-Schlüssel. refresh validiert bereits vorhandene Schlüssel erneut und entdeckt niemals einen für eine Adresse, die keinen hat. Jeder Schlüssel wird nur über die Methode erneut geprüft, aus der er gelernt wurde (geerntete, per Gossip gelernte und von Hand eingetragene Schlüssel werden nie über das Netz erneut geprüft), sodass der Keyserver nur von den Korrespondenten erfährt, deren Schlüssel er geliefert hat. prune löscht abgelaufene Schlüssel und veraltete Entdeckungsanfragen (--dry-run, um zuerst nachzusehen). show wendet die Abgleichsregel an (eine exakte Adresse schlägt immer einen von Hand eingetragenen *@domain-Rückfall). import legt einen Schlüssel mit der Quelle manual ab, der einzigen Quelle, die eine ganze Domain benennen darf; bei einem *@domain-Schlüssel, der keine Adresse nennt, vermerkt es, dass eine mit diesem Schlüssel erstellte Signatur für jedes From: in der Domain als valid gemeldet wird. import führt den Schlüssel außerdem mit einer bereits gespeicherten Kopie desselben Schlüssels zusammen (sodass ein älterer Export keinen Widerruf rückgängig machen kann) und lehnt einen Schlüssel ab, dessen private Hälfte bekannt ist. pepsi-keys-refresh.timer führt refresh, prune und screen täglich aus.

  • peer unclaimed — listet die bedienten Adressen auf, die keine Identität von uns haben, deren Verschlüsselung aber dennoch von einem geernteten oder per Gossip gelernten Schlüssel bestimmt wird, also von einem Schlüssel, den ein Fremder mit einem gefälschten From: eingeschleust haben könnte. Die Ausgabe ist eine Arbeitsliste, die mit jedem Inhaber zu bestätigen ist (Die Benutzer finden, die ihren eigenen Schlüssel mitbringen).

  • peer screen — gespeicherte Schlüssel finden, deren private Hälfte bekannt ist: ein Batch-GCD über jeden zwischengespeicherten RSA-Modulus und die öffentlichen Hälften unserer Identitäten, dazu die Liste bekanntermaßen kompromittierter Schlüssel (pepsi.compromised_key: badkeys, die schwachen Debian-OpenSSL-Schlüssel). Ein durchfallender Peer-Schlüssel wird gelöscht, gepinnt oder nicht, und ein faktorisierter Modulus wird dieser Liste hinzugefügt, sodass jede Schlüsselprüfung ihn ablehnt; eine durchfallende Identität von uns wird gemeldet (Audit-Schweregrad error), nie verändert.

  • blocklist update / status / dismiss / restore — die Liste bekanntermaßen kompromittierter Schlüssel in der Datenbank. update (pepsi-keys-blocklist.timer, täglich) fragt [pepsi-keydiscovery] BADKEYS_URL bedingt, ob sich die badkeys-Liste geändert hat, und fügt nur Neues hinzu; nie wird etwas entfernt. Eine Liste mit weniger Einträgen als die letzte oder eine, die die Tabelle um mehr als ein Viertel wachsen ließe, wird abgelehnt, sofern nicht --force. status sagt, wann die Liste zuletzt geprüft wurde; dismiss nimmt die Einträge eines Laufs oder einer Quellliste außer Dienst, ohne dass die nächste Aktualisierung sie wieder hinzufügt (siehe „A known-compromised key is never stored“ in Schlüsselverwaltung).

  • ct-logs update / status — die Liste der Certificate-Transparency-Logs, gegen die jeder TLS-Client die SCTs von Server-Zertifikaten prüft ([pepsi] CT_LOG_LIST, eine Datei, keine Tabelle). update (pepsi-keys-ct-logs.timer, täglich) ruft [pepsi] CT_LOG_LIST_URL bedingt ab und ersetzt die Datei atomar, wobei es eine Liste ablehnt, die älter als die vorhandene ist, sofern nicht --force; status sagt, wie alt die Liste ist.

  • peer capability list / set / unset / forget — der S/MIME-Fähigkeitsdatensatz je Korrespondent (pepsi.smime_capability), der entscheidet, ob ein Empfänger AuthEnvelopedData (AES-256-GCM, auch wenn es keinen Datensatz gibt) oder CBC-EnvelopedData erhält. Datensätze werden aus der verifizierten Signatur eines Korrespondenten von pepsi-stage-autocrypt-learn gelernt oder je Adresse oder *@domain konfiguriert; ein konfigurierter gewinnt (Welchen S/MIME-Container ein Korrespondent erhält).

  • ca list / add / scope / accept-nameless / enable / disable / remove — die S/MIME-Vertrauensanker (scope begrenzt die Mail-Domains, für die ein Anker bürgt). Ein Zertifikat ohne basicConstraints CA:TRUE wird abgelehnt, da keine Kette je bei ihm enden könnte. Hier angenommen zu werden heißt nicht, brauchbar zu sein: Die eigenen nameConstraints, pathLenConstraint und Richtlinienbeschränkungen eines Ankers binden jede Kette, die durch ihn führt (RFC 5937), und eine CA mit einer kritischen Erweiterung, die Pepsi nicht verarbeiten kann, wird beim Pfadaufbau übersprungen (RFC 5280 §4.2).

  • wrap rotate — jeden gespeicherten privaten Schlüssel und jedes Geheimnis eines zweiten Faktors unter einem neuen Schlüsselverschlüsselungsschlüssel neu verpacken, inkrementell und mit --dry-run, um zuerst nachzusehen; es verpackt auch einen Schlüssel im Format 0x01 neu, dessen Verpackung den Fingerabdruck des Schlüssels nicht bindet.

  • otp status / enroll / remove / reset — der TOTP-Zweitfaktor je Adresse. Einmal registriert, muss ein unprivilegierter Aufrufer einer setuid-Installation für jede Änderung an den Identitäten dieser Adresse sowie für export --private und csr identity --otp CODE angeben; zehn aufeinanderfolgende Fehlschläge sperren ihn, bis der Betreiber ihn zurücksetzt (Ein zweiter Faktor für die Schlüsselverwaltung). Mit --console LOGIN registriert, zeigt oder setzt der Betreiber den zweiten Faktor eines Konsolenkontos zurück, dessen Passwort-Anmeldungen dann ebenfalls einen aktuellen Code brauchen.

  • dns — die OPENPGPKEY- (RFC 7929) und SMIMEA-Einträge (RFC 8162) ausgeben, die eine Adresse veröffentlichen, unter den gehashten Eigentümernamen, die diese Standards definieren. Die Einträge zu veröffentlichen lohnt sich nur in einer DNSSEC-signierten Zone, und die Ausgabe sagt das auch.

  • mpki domain / credential / user / order / notices / run — die Managed PKI: S/MIME-Zertifikate, die eine kommerzielle CA (DigiCert CertCentral) für die Benutzer einer Domain ausstellt. domain enthält die Einstellungen jeder Domain, credential den API-Schlüssel ihres CA-Kontos (eine secrets.d-Datei), user die Personen und die Namen, die ihre Zertifikate tragen (import liest einen LDIF- oder CSV-Export eines Verzeichnisses), order und notices, was gerade läuft und was auf einen Administrator wartet. run (pepsi-keys-mpki.timer, alle fünf Minuten) bestellt, installiert, erneuert und widerruft; der Schlüssel wird immer hier erzeugt, und die CA erhält nur eine Zertifikatsanforderung (Zertifikate einer kommerziellen CA: die Managed PKI).

76.3. Privilegienmodell

Einen privaten Schlüssel zu erreichen erfordert zwei unabhängig bewachte Dinge: die Datenbankrolle pepsi-crypto und den Schlüsselverschlüsselungsschlüssel. Die Rolle ist die einzige, der die Spalte crypto_identity.private_wrapped gewährt ist; jede andere Dienstrolle hält eine spaltenweise Berechtigung, die sie auslässt. Der Schlüsselverschlüsselungsschlüssel liegt nur in secrets.d/pepsi-crypto.secret. Eine gestohlene Datenbank liefert Chiffrat; das Geheimnis allein liefert nichts.

pepsi-keys nimmt diese Rolle nur für die Dauer jedes Datenbankaufrufs an: Als root gestartet, wird es zum Konto (root hat keine eigene Datenbankrolle) und kehrt danach zurück. Die Peer-Authentifizierung von PostgreSQL richtet sich nach der effektiven uid, nicht nach der gid, sodass ein setgid-Bit die Gruppe gewähren würde, die das Geheimnisfragment bewacht, aber nicht die Datenbankidentität.

Das Binärprogramm wird ohne setuid-Bit ausgeliefert, anders als pepsi-whitelist: Ein Programm, das jeden privaten Schlüssel einer Installation öffnen kann, ist eine weit größere Beute als eine einzelne Whitelist-Tabelle. Eine Site, die will, dass Benutzer ihre eigenen Identitäten verwalten, installiert es setuid pepsi-crypto; Identitäten gehören dem passwd-Login, auf das ihre Adresse auflöst, und ein unprivilegierter Aufrufer des setuid-Binärprogramms darf nur die eigenen sehen und ändern. Ohne das Bit verbindet sich jeder Aufrufer als er selbst, und allein die Datenbankrechte entscheiden, sodass es setuid zu machen eine Entscheidung der Site ist und keine Codeänderung. Eine setuid-Installation wechselt vor allem anderen zum aufrufenden Benutzer, entfernt die Umgebungsvariablen, die die Konfigurationssuche und libpq steuern, und lehnt -c für unprivilegierte Aufrufer ab, da die Konfiguration den Schlüsselverschlüsselungsschlüssel benennt. Peer-Schlüssel und Vertrauensanker gelten installationsweit und sind nur dem Betreiber vorbehalten, das Auflisten eingeschlossen.

Jede Schlüsseloperation und jedes Lesen privaten Materials (identity export --private, identity csr) wird im gemeinsamen Audit-Log (pepsi.event_log) festgehalten, demselben, in das die administrative API schreibt.

76.4. Siehe auch

Schlüsselverwaltung, Die Verwahrungsgrenze für private Schlüssel, Ein zweiter Faktor für die Schlüsselverwaltung, Gateway-Verwahrung (custody = local, der MTA-Schlüssel), Schlüssel von Korrespondenten, pepsi-keydisc, pepsi-setup, pepsi-whitelist, pepsi-settings, Architektur, pepsi-keys(1), pepsi.conf(5).