95.1.50. pepsi-keys¶
manage the end-to-end key store: identities, peer keys and anchors
- Handbuchabschnitt:
1
95.1.50.1.1. Name¶
pepsi-keys - Ende-zu-Ende-Schlüsselmaterial erzeugen, importieren, veröffentlichen und ausmustern.
95.1.50.1.2. Übersicht¶
pepsi-keys [GLOBAL-OPTIONS] identity list [–address ADDRESS] [–json] [–served]
pepsi-keys [GLOBAL-OPTIONS] identity show IDENTITY-ID [–json]
pepsi-keys [GLOBAL-OPTIONS] identity generate ADDRESS –protocol PROTOCOL [–name NAME] [–days N] [–no-publish] [–csr] [–shared | –split]
pepsi-keys [GLOBAL-OPTIONS] identity import ADDRESS –protocol PROTOCOL –purpose PURPOSE –public FILE [–private FILE] [–algorithm NAME] [–primary] [–no-publish]
pepsi-keys [GLOBAL-OPTIONS] identity export IDENTITY-ID [–private] [–pem]
pepsi-keys [GLOBAL-OPTIONS] identity csr IDENTITY-ID
pepsi-keys [GLOBAL-OPTIONS] identity revoke IDENTITY-ID [–reason TEXT] [–upload]
pepsi-keys [GLOBAL-OPTIONS] identity forget-private IDENTITY-ID [-y]
pepsi-keys [GLOBAL-OPTIONS] identity set-primary IDENTITY-ID
pepsi-keys [GLOBAL-OPTIONS] identity publish [IDENTITY-ID] [–wkd] [–vks] [–retry [–dry-run]] [-y]
pepsi-keys [GLOBAL-OPTIONS] identity unpublish IDENTITY-ID
pepsi-keys [GLOBAL-OPTIONS] identity delete IDENTITY-ID [-y]
pepsi-keys [GLOBAL-OPTIONS] identity retire
pepsi-keys [GLOBAL-OPTIONS] identity rotate-due [–dry-run]
pepsi-keys [GLOBAL-OPTIONS] peer list [–address ADDRESS] [–json]
pepsi-keys [GLOBAL-OPTIONS] peer show ADDRESS [–protocol PROTOCOL] [–json]
pepsi-keys [GLOBAL-OPTIONS] peer unclaimed [–address ADDRESS] [–all-sources] [–json]
pepsi-keys [GLOBAL-OPTIONS] peer import ADDRESS –protocol PROTOCOL –file FILE [–pin]
pepsi-keys [GLOBAL-OPTIONS] peer pin | unpin | remove PEER-KEY-ID
pepsi-keys [GLOBAL-OPTIONS] peer refresh [–address ADDRESS | –expire PEER-KEY-ID] [–expiring-within-days DAYS] [–limit N]
pepsi-keys [GLOBAL-OPTIONS] peer prune [–retain-days DAYS] [–dry-run]
pepsi-keys [GLOBAL-OPTIONS] peer screen [–dry-run]
pepsi-keys [GLOBAL-OPTIONS] peer capability list [–address ADDRESS] [–json]
pepsi-keys [GLOBAL-OPTIONS] peer capability set ADDRESS aead | cbc
pepsi-keys [GLOBAL-OPTIONS] peer capability unset ADDRESS
pepsi-keys [GLOBAL-OPTIONS] peer capability forget FINGERPRINT
pepsi-keys [GLOBAL-OPTIONS] blocklist update [–force]
pepsi-keys [GLOBAL-OPTIONS] blocklist status [–json]
pepsi-keys [GLOBAL-OPTIONS] blocklist dismiss | restore –import N | –list NAME
pepsi-keys [GLOBAL-OPTIONS] ct-logs update [–force]
pepsi-keys [GLOBAL-OPTIONS] ct-logs status [–json]
pepsi-keys [GLOBAL-OPTIONS] ca list [–json]
pepsi-keys [GLOBAL-OPTIONS] ca add FILE [–label TEXT] [–accept-nameless] [–domain DOMAIN]…
pepsi-keys [GLOBAL-OPTIONS] ca scope CA-ID –domain DOMAIN… | –any
pepsi-keys [GLOBAL-OPTIONS] ca accept-nameless CA-ID yes | no
pepsi-keys [GLOBAL-OPTIONS] ca enable | disable | remove CA-ID
pepsi-keys [GLOBAL-OPTIONS] identity –otp CODE COMMAND …
pepsi-keys [GLOBAL-OPTIONS] otp status [ADDRESS | –console LOGIN] [–json]
pepsi-keys [GLOBAL-OPTIONS] otp enroll | remove ADDRESS [–otp CODE]
pepsi-keys [GLOBAL-OPTIONS] otp reset ADDRESS
pepsi-keys [GLOBAL-OPTIONS] otp enroll | reset –console LOGIN
pepsi-keys [GLOBAL-OPTIONS] wrap rotate [–dry-run]
pepsi-keys [GLOBAL-OPTIONS] dns ADDRESS
pepsi-keys [GLOBAL-OPTIONS] mpki domain list [–json]
pepsi-keys [GLOBAL-OPTIONS] mpki domain show | check DOMAIN [–json]
pepsi-keys [GLOBAL-OPTIONS] mpki domain set DOMAIN [–enable | –disable] [SETTING-OPTIONS]
pepsi-keys [GLOBAL-OPTIONS] mpki credential set DOMAIN [–file FILE]
pepsi-keys [GLOBAL-OPTIONS] mpki credential remove DOMAIN
pepsi-keys [GLOBAL-OPTIONS] mpki user list [–domain DOMAIN] [–deleted] [–json]
pepsi-keys [GLOBAL-OPTIONS] mpki user add ADDRESS –given-name NAME –surname NAME [–select SELECTION]
pepsi-keys [GLOBAL-OPTIONS] mpki user set ADDRESS [–given-name NAME] [–surname NAME] [–confirm] [–select SELECTION]
pepsi-keys [GLOBAL-OPTIONS] mpki user delete ADDRESS
pepsi-keys [GLOBAL-OPTIONS] mpki user import FILE –ldif | –csv [–domain DOMAIN] [–mail-attribute ATTR] [–given-name-attribute ATTR] [–surname-attribute ATTR] [–prune] [–dry-run] [–yes] [–json]
pepsi-keys [GLOBAL-OPTIONS] mpki order list [–domain DOMAIN] [–address ADDRESS] [–open] [–limit N] [–json]
pepsi-keys [GLOBAL-OPTIONS] mpki order release | retry | cancel ORDER-ID
pepsi-keys [GLOBAL-OPTIONS] mpki notices [–domain DOMAIN] [–unread] [–read ID… | –read-all] [–json]
pepsi-keys [GLOBAL-OPTIONS] mpki run [–domain DOMAIN] [–json]
95.1.50.1.3. Beschreibung¶
pepsi-keys ist das Werkzeug des Betreibers für Pepsis Ende-zu-Ende-Kryptographie-Schlüsselspeicher — die drei Tabellen, die jeden Schlüssel enthalten, den die OpenPGP- und S/MIME-Verarbeitung braucht:
pepsi.crypto_identityDie Schlüsselpaare der Adressen, die wir bedienen, einschließlich der privaten Hälfte, im Ruhezustand verpackt (
custody = local, ein MTA-Schlüssel). Sie werden verwendet, um ausgehende Mail zu signieren und eingehende Mail zu entschlüsseln. Hier liegen außerdem die eigenen Schlüssel der Benutzer, deren private Hälfte nur in ihrem Mail-Client existiert (custody = client, ein MUA-Schlüssel; siehe MTA-Schlüssel und MUA-Schlüssel).pepsi.peer_keyDie öffentlichen Schlüssel und Zertifikate entfernter Korrespondenten, wie auch immer sie erlangt wurden, jeweils mit der Quelle, aus der sie stammen, einem Gültigkeitsurteil und einer Cache-Frist. Wird verwendet, um ausgehende Mail zu verschlüsseln und eingehende Signaturen zu verifizieren.
pepsi.ca_trustDie CA-Zertifikate, die eine eingehende S/MIME-Kette erreichen muss, damit ihre Signatur als vertrauenswürdig gilt.
Das Werkzeug ist keine Stage. Es verwaltet Datensätze direkt, in der Gestalt von pepsi-whitelist(1) und pepsi-settings(1), verbindet sich über den geteilten [pepsi-postgres]-Abschnitt mit derselben Datenbank wie die übrigen Komponenten und liest die CRYPTO_*-Optionen von [pepsi] sowie den in pepsi.conf(5) beschriebenen [pepsi-crypto]-Abschnitt.
Es ist aus zwei Gründen ein eigenständiges Binärprogramm statt Teil der vereinheitlichten pepsi-Ausführungsdatei: Es ist das einzige Programm im Baum, das Schlüsselmaterial erzeugt, und ein Standort kann es setuid installieren (siehe Privilegien).
Die mpki-Befehle ergänzen eine Managed PKI: S/MIME-Zertifikate, die eine kommerzielle Zertifizierungsstelle für die Benutzer einer Domain ausstellt und die Pepsi bestellt, installiert, erneuert und widerruft (siehe Managed-PKI-Befehle).
95.1.50.1.3.1. Fähigkeit, nicht Gestalt¶
Das Material einer Adresse wird als ein Datensatz je Fähigkeit gespeichert, nie als „die Identität“. Der purpose jedes Datensatzes ist sign, encrypt oder both:
eine OpenPGP-Identität ist ein einziger
both-Datensatz — ein übertragbarer Schlüssel, dessen signierfähiger Hauptschlüssel einen Verschlüsselungs-Unterschlüssel trägt, sodass die Trennung intrinsisch ist und nichts kostet;eine S/MIME-Identität besteht normalerweise aus zwei Datensätzen, einem Zertifikat mit
digitalSignatureund einem mitkeyEncipherment/keyAgreement;mit
[pepsi] CRYPTO_SMIME_SHARED_KEY = yesist es stattdessen einboth-Zertifikat, das beide Schlüsselverwendungen trägt (nur RSA).
Diese Option entscheidet nur, wie neu erzeugte Identitäten aussehen. Beide Gestalten werden dauerhaft unterstützt und können für eine Adresse nebeneinander bestehen, zum Beispiel ein altes, noch gültiges gemeinsames Zertifikat neben einem frisch ausgestellten geteilten Paar. Jede Abfrage passt daher auf eine Fähigkeit (sign oder both; encrypt oder both), statt Datensätze zu zählen. Auflistungen und identity show geben genau deshalb den purpose aus.
95.1.50.1.3.2. Die Ausmusterung ist asymmetrisch¶
Pepsi stellt Klartext in das Postfach zu, sodass ein privater Entschlüsselungsschlüssel nur für noch unterwegs befindliche Mail und für das von einem Betreiber archivierte Chiffrat gebraucht wird — nie, um das eigene Postfach zu lesen. Ein privater Signier-Schlüssel kann nach der Ausmusterung überhaupt nichts Legitimes mehr tun: Alte Mail wird nie neu signiert. Also gilt bei Ablauf oder Widerruf:
die private Hälfte eines
sign-Datensatzes wird zerstört, und nur die öffentliche Hälfte bleibt erhalten, damit alte Signaturen weiterhin verifiziert werden können;die private Hälfte eines
encrypt-Datensatzes wird behalten;ein
both-Datensatz folgt der Entschlüsselungs-Regel, denn ihn zu zerstören nähme die Fähigkeit, damit zu entschlüsseln. Das ist der Preis des Modus mit gemeinsamem Zertifikat: Einen kompromittierten Signierschlüssel dort zu widerrufen beendet zugleich die Fähigkeit, neue verschlüsselte Mail zu empfangen.
private_purged_at hält fest, wann Material verworfen wurde, sodass „bewusst zerstört“ von „nie besessen“ unterscheidbar bleibt; sowohl identity list als auch identity show melden es.
95.1.50.1.3.3. MTA-Schlüssel und MUA-Schlüssel¶
Eine Adresse kann Schlüssel zweier Arten halten. Ein MTA-Schlüssel (custody = local) ist einer, dessen private Hälfte Pepsi hält: pepsi-stage-encrypt(1) signiert damit, pepsi-stage-decrypt(1) öffnet damit Mail, und er wird in Autocrypt:-Headern beworben. Er wird durch identity generate, durch einen Import mit –private oder automatisch bei der ersten Einlieferung eines Benutzers unter [stage-encrypt] ENABLE_PEP erzeugt. Ein MUA-Schlüssel (custody = client) ist der eigene Schlüssel des Benutzers aus seinem Mail-Client: für immer rein öffentlich, nie primär. Pepsi verschlüsselt an ihn und reicht an ihn verschlüsselte Mail ungeöffnet durch, kann mit ihm aber nie signieren oder entschlüsseln. Er entsteht durch einen Import ohne –private, über die Web-Konsole oder die API, durch den E-Mail-Befehl register oder automatisch aus dem Autocrypt:-Header der vom Benutzer selbst eingelieferten Mail.
Das öffentliche Gesicht einer Adresse ist der neueste aktive MUA-Schlüssel, wenn es einen gibt, sonst der primäre aktive MTA-Schlüssel. Es ist der erste Schlüssel, den das Web Key Directory ausliefert, und der Schlüssel, an den lokale Mail an den Benutzer verschlüsselt wird. Neben einem MUA-Schlüssel liefert das Verzeichnis auch die anderen aktiven MUA-Schlüssel des Benutzers aus (der neueste zuerst, höchstens acht; lokale Mail wird ebenfalls an diese Schlüssel verschlüsselt), nie den MTA-Schlüssel. Der MTA-Schlüssel wird nicht ausgemustert, wenn ein MUA-Schlüssel hinzukommt; er entschlüsselt weiterhin Mail von Korrespondenten, die ihn noch verwenden. identity show gibt die Verwahrung aus und ob die Identität das öffentliche Gesicht ist.
95.1.50.1.3.4. Keyserver-Uploads werden je Identität angefordert¶
Jede Identität hält fest, ob ihr Upload zum Keyserver angefordert wurde (crypto_identity.vks_wanted). Automatisch erzeugte Schlüssel und automatisch registrierte MUA-Schlüssel beginnen mit ausgeschaltetem Wert: Autocrypt und das eigene Web Key Directory der Installation sind der Weg, auf dem sie gefunden werden, und ein Upload kann nicht zurückgenommen werden. Von Hand erstellte Schlüssel (identity generate, identity import sowie generate über Web und E-Mail) übernehmen [pepsi-keys] VKS_PUBLISH als Standardwert, und –no-publish lässt ihn ausgeschaltet. Eine ausdrückliche Anforderung setzt ihn, gleich was VKS_PUBLISH sagt: identity publish –vks, Upload to the key server in der Web-Konsole oder der E-Mail-Befehl publish. identity publish –retry lädt genau die Datensätze hoch, bei denen er gesetzt ist, sodass „nicht hochgeladen“ ein festgehaltener Zustand ist, und identity show meldet ihn.
95.1.50.1.3.5. Eigentum¶
Eine Identität ist auf die kleingeschriebene Adresse geschlüsselt. Wenn die Lokalitätsregeln von pepsi-common ([pepsi-crypto] LOCAL_DOMAINS, RECIPIENT_DELIMITER und TARGETS, mit Rückfall auf [pepsi-ingress] ACCEPTED_DOMAINS und den uid-Bereich aus /etc/login.defs) diese Adresse zu einem lokalen Konto auflösen, wird der passwd-Login in crypto_identity.login festgehalten; andernfalls ist die Spalte NULL — eine Rollenadresse, eine gehostete Domain, eine Installation vor einem Exchange.
Diese Spalte ist die Zugriffsregel. Ein unprivilegierter Aufrufer darf nur Identitäten sehen und ändern, deren login sein eigener ist, aufgelöst aus dem passwd-Eintrag der realen uid — nicht $USER, kein Argument, nicht die effektive uid. Eine Identität ohne besitzendes Konto gehört niemandem im Besonderen und ist daher nur für Betreiber: „ohne Eigentümer“ als „gehört allen“ zu behandeln würde jede Rollenadresse für jeden lokalen Benutzer beschreibbar machen.
root sowie die Konten pepsi-crypto, pepsi und pepsi-owner dürfen jede Identität verwalten. Peer-Schlüssel und Vertrauensanker haben keinen Namensraum je Benutzer: Sie sind der Schlüssel eines anderen oder installationsweite Richtlinie. Jeder peer- und ca-Unterbefehl, list eingeschlossen, ist daher nur für Betreiber, ebenso wie wrap rotate und identity retire.
95.1.50.1.3.6. Privilegien¶
Um an einen privaten Schlüssel zu gelangen, braucht es zweierlei, und beides wird getrennt bewacht:
die Datenbankrolle
pepsi-crypto, die einzige, der die Spaltecrypto_identity.private_wrappedgewährt ist (abgesehen vom Schema-Eigentümerpepsi-owner, der sie kraft Eigentümerschaft liest, aber den Schlüsselverschlüsselungsschlüssel nicht lesen kann). Jede gewöhnliche Dienstrolle hält eine Berechtigung auf Spaltenebene, die sie auslässt; das gilt auch für daspepsi-Konto, unter dem jeder gewöhnliche Stage-Worker läuft. Eine Kompromittierung anderswo in der Pipeline liefert daher die öffentliche Hälfte jeder Identität und sonst nichts (siehe pepsi-setup(1));der Schlüsselverschlüsselungsschlüssel (KEK), der nur im Dateisystem lebt, in
secrets.d/pepsi-crypto.secret.
Die Datenbank allein liefert daher nichts als Chiffrat, und der Schlüsselverschlüsselungsschlüssel allein liefert überhaupt nichts.
pepsi-keys nimmt die pepsi-crypto-Identität nur für die Dauer jedes Datenbankaufrufs an. Als root ausgeführt wird es für den Aufruf zu jenem Konto (root hat keine eigene Datenbankrolle) und kehrt danach zurück; als pepsi-crypto oder pepsi-owner ausgeführt verbindet es sich schlicht als es selbst; aus einer setuid-Installation heraus hebt es seine effektiven Ids auf den Eigentümer des Binärprogramms an. Die Peer-Authentifizierung von PostgreSQL richtet sich nach der effektiven uid, nicht nach der gid, sodass ein setgid-Bit die Gruppe gewährte, die das Geheimnis-Fragment bewacht, aber nicht die Datenbankidentität — ein Programm, das diese Rolle sein muss, muss dieses Konto sein.
So wie ausgeliefert trägt das Binärprogramm kein setuid-Bit (Modus 0755): Ein Binärprogramm, das jeden privaten Schlüssel einer Installation öffnen kann, ist eine weit größere Beute als die eine Tabelle von pepsi-whitelist(1), sodass standardmäßig nur der Betreiber es ausführt. Ein Standort, der möchte, dass gewöhnliche Benutzer ihre eigenen Identitäten verwalten, macht es setuid pepsi-crypto.
Welche Autorität gilt, unterscheidet sich zwischen den beiden Installationen. Die obige Eigentumsregel je Identität greift nur, wenn das Binärprogramm das setuid-Bit tatsächlich trägt: Ein Aufrufer gilt als privilegiert, wenn er root ist, wenn sein Login eines der privilegierten Konten ist, oder wenn das Binärprogramm überhaupt nicht setuid ist. Bei der ausgelieferten 0755-Installation ist daher jeder Aufrufer privilegiert, soweit es dieses Programm betrifft, und nur PostgreSQL steht zwischen einem Benutzer und den Identitäten eines anderen — der Aufrufer authentifiziert sich als er selbst, und die Datenbank-Berechtigungen entscheiden. Das ist der beabsichtigte Entwurf, aber es bedeutet, dass jemandem die Datenbankrolle pepsi-crypto zu gewähren ihm jede Identität der Installation übergibt, was auch immer die Eigentumsregel dieses Programms sonst gesagt hätte. Wenn es setuid ist, gelten dieselben drei Vorsichtsmaßnahmen wie bei pepsi-whitelist(1): Die effektiven Ids werden vor allem anderen auf den aufrufenden Benutzer abgesenkt, die Umgebungsvariablen, die die Konfigurationssuche (HOME, XDG_CONFIG_HOME), die ${DATADIR}-Expansion (PATH) und libpq (PG*) steuern, werden entfernt, und -c/–config wird für unprivilegierte Aufrufer abgelehnt — die Konfiguration benennt die Datenbank und den Schlüsselverschlüsselungsschlüssel.
95.1.50.1.4. Befehle¶
95.1.50.1.4.1. Identitätsbefehle¶
- identity list [–address ADDRESS] [–json] [–served]
Listet Identitäten als Tabelle auf: Id, Adresse, Protokoll, Zweck, Status, ob der Datensatz der primäre für seine Fähigkeit ist, ob er veröffentlicht ist, der Zustand seiner privaten Hälfte (
yes/no/purgedoderclientfür den eigenen MUA-Schlüssel des Benutzers, dessen private Hälfte Pepsi nie gehalten hat) und sein Ablauf. Ein unprivilegierter Aufrufer sieht nur seine eigenen. –address beschränkt die Auflistung auf eine Adresse; –json gibt die Datensätze stattdessen als JSON aus.–served fragt außerdem für jede aufgeführte Adresse mit einer veröffentlichten, aktiven Identität, was einem Korrespondenten gegeben wird: beide Methoden des Web Key Directory und die
OPENPGPKEY- undSMIMEA-Einträge, abgerufen mit den gehärteten Clients und den[pepsi-keydiscovery]-Einstellungen der Schlüsselentdeckung. Eine Spalte SERVED nennt die Kanäle, die den Fingerabdruck jeder Identität ausliefern (wkd-advanced,wkd-direct,openpgpkey,smimea;nonefür eine veröffentlichte, aktive Identität, die nichts ausliefert;-für eine, die nicht ausgeliefert werden soll), und unter der Tabelle wird jeder Kanal aufgeführt, der vom Schlüsselspeicher abweicht:MISMATCH, wenn er einen Fingerabdruck ausliefert, den der Speicher für diese Adresse nicht veröffentlicht – ein anderer Webserver auf dem Apex der Domain, ein DNS-Eintrag aus einer Rotation, ein Schlüssel, den jemand anderes dort abgelegt hat –, sonstINCOMPLETE,ABSENToderFAILED. Mit –json wird die Ausgabe zu einem Objekt mitidentities(den Zeilen) undserved(ein Bericht je Adresse). Das Netz wird gefragt, nachdem die Datenbankverbindung geschlossen ist, als der aufrufende Benutzer. Die Antworten sind die, die dieser Host erhält; ein Server, der anderen Fragenden anders antwortet, wird nicht erkannt.- identity show IDENTITY-ID [–json]
Gibt eine Identität vollständig aus, einschließlich ihres Fingerabdrucks, ihres Algorithmus, ihrer Verwahrung (
localfür einen MTA-Schlüssel,clientfür den eigenen MUA-Schlüssel des Benutzers), ob sie das öffentliche Gesicht der Adresse ist (der Schlüssel, den Korrespondenten erhalten),wrap_key_id, der Zeitstempel, eines etwaigen Widerrufsgrunds, des Web-Key-Directory-Hashes des lokalen Teils, unter dem die Adresse ausgeliefert wird, und ihres Keyserver-Zustands: einer vonverified atZEIT,uploaded atZEIT, awaiting confirmation,upload requestedodernot uploaded (not requested).- identity generate ADDRESS –protocol
openpgp|smime[OPTIONS] Erzeugt Schlüsselmaterial für ADDRESS und speichert es, private Hälfte verpackt. Das neue Material wird das primäre für seine Fähigkeit; nichts Bestehendes wird umgeschrieben oder ersetzt, sodass das vorherige Material brauchbar bleibt, um zu entschlüsseln, was bereits damit gesendet wurde.
OpenPGP erzeugt einen
both-Datensatz unter Verwendung von[pepsi] CRYPTO_OPENPGP_ALGORITHM(ed25519, der Standardwert, oderrsamitCRYPTO_GENERATE_RSA_BITS, das 2048, 3072, 4096 oder 8192 sein muss). S/MIME erzeugt das Signier-/Verschlüsselungspaar unter Verwendung vonCRYPTO_SMIME_ALGORITHM(p256, der Standardwert,p384oderrsa), jeweils mit einem selbstsignierten Zertifikat für den sofortigen Gebrauch.- –name NAME
Anzeigename für die OpenPGP-User-ID (
Name <address>) oder den Zertifikatsbetreff. Ohne ihn ist die User-ID die bloße Adresse.- –days N
Lebensdauer des erzeugten Materials. Standardwert ist
[pepsi-crypto] IDENTITY_VALIDITY_DAYS(730, zwei Jahre).- –no-publish
Die öffentliche Hälfte nicht über das Web Key Directory ausliefern und nicht hochladen. Standardmäßig wird eine neue Identität veröffentlicht — an einen Schlüssel, den niemand abholen kann, kann nicht verschlüsselt werden —, und ihr Keyserver-Upload wird angefordert, wenn
[pepsi-keys] VKS_PUBLISHeingeschaltet ist.
Die Erzeugung auf Anforderung ist immer erlaubt, auch für eine Adresse, die bereits den eigenen MUA-Schlüssel des Benutzers oder einen widerrufenen Schlüssel hat; nur die automatische Erzeugung verweigert eine Adresse mit irgendeiner Identität.
- –csr
Gibt zusätzlich eine PKCS#10-Zertifikatsanforderung über jeden erzeugten Schlüssel aus, sodass eine echte CA ein Ersatzzertifikat für denselben Schlüssel ausstellen kann, ohne ihn neu zu erzeugen. Nur S/MIME; OpenPGP kennt kein solches Objekt.
- –shared
Erzwingt ein einziges S/MIME-Zertifikat, das beide Schlüsselverwendungen trägt, was auch immer
CRYPTO_SMIME_SHARED_KEYsagt. Mit einem Elliptische-Kurven-CRYPTO_SMIME_ALGORITHMabgelehnt, den Standardwertp256eingeschlossen, daher braucht esCRYPTO_SMIME_ALGORITHM = rsa: Ein EC-Schlüssel, der sowohl ECDSA als auch ECDH macht, ist algorithmusübergreifende Schlüsselwiederverwendung, die mehrere S/MIME-Clients ablehnen.- –split
Erzwingt die getrennten Signier- und Verschlüsselungszertifikate. Schließt –shared aus; ohne beide gilt der konfigurierte Standardwert.
- identity import ADDRESS –protocol P –purpose PURPOSE –public FILE [OPTIONS]
Speichert anderswo erzeugtes Material. PURPOSE ist
sign,encryptoderbothund muss beschreiben, was das Material tatsächlich kann , denn jede spätere Abfrage passt darauf. Die öffentliche Hälfte ist ein übertragbarer OpenPGP-Schlüssel oder ein X.509-Zertifikat (DER oder PEM, erkannt);-liest die Standardeingabe. Der Fingerabdruck wird aus dem Material selbst abgeleitet: der OpenPGP-Fingerabdruck oder der SHA-256 des Zertifikats-DER.- –private FILE
Die private Hälfte — ein OpenPGP-Transferable-Secret-Key oder ein PKCS#8-Schlüssel —, die vor dem Speichern verpackt wird, als MTA-Schlüssel (
custody = local). Ohne sie wird nur die öffentliche Hälfte behalten. Bei OpenPGP wird der Datensatz dann als eigener MUA-Schlüssel des Benutzers erfasst (custody = client), der nie primär ist (–primary wird für ihn ignoriert): Pepsi kann ihn veröffentlichen und an ihn verschlüsseln, aber nie mit ihm signieren oder entschlüsseln. Er kommt der automatischen Schlüsselerzeugung für die Adresse zuvor und wird zum öffentlichen Gesicht der Adresse; an ihn verschlüsselte Mail wird ungeöffnet an den Mail-Client weitergereicht. Ein rein öffentlicher S/MIME-Import behältcustody = local– typischerweise ein von einer CA ausgestelltes Zertifikat über einen Schlüssel, der bereits im Speicher liegt (siehe identity csr).- –algorithm NAME
Festzuhaltender Algorithmusname. Informativ; Standardwert
imported.- –primary
Macht dies zu dem Material, das für neue Nachrichten seiner Fähigkeit verwendet wird.
- –no-publish
Die öffentliche Hälfte nicht veröffentlichen. Andernfalls wird der Keyserver-Upload angefordert, wenn
[pepsi-keys] VKS_PUBLISHeingeschaltet ist.
- identity export IDENTITY-ID [–private] [–pem]
Schreibt das Material in seiner eigenen Binärform auf die Standardausgabe — OpenPGP-Pakete oder X.509-DER —, sodass es direkt in ein anderes Werkzeug geleitet werden kann. Ein öffentlicher OpenPGP-Schlüssel wird ohne Zertifizierungen Dritter geschrieben, so wie er veröffentlicht wird.
- –private
Exportiert die private Hälfte statt der öffentlichen und entpackt sie dafür zunächst. Scheitert, wenn der Datensatz keine hält, und nennt, welches von „nie besessen“ und „gelöscht“ zutrifft.
- –pem
Verpackt X.509-Material in einen PEM-Block. OpenPGP-Material hat keine PEM-Form und wird mit einem Hinweis auf
gpg --enarmorabgelehnt.
- identity csr IDENTITY-ID
Gibt eine PKCS#10-Zertifikatsanforderung über den bestehenden privaten Schlüssel einer Identität aus, mit der Schlüsselverwendung, die ihr
purposeimpliziert. Das ist der Weg, auf den es ankommt, sobald eine Identität im Einsatz ist: Das selbstsignierte Zertifikat bringt die Organisation in Gang, und derselbe Schlüssel — bereits veröffentlicht, bereits zum Empfang verschlüsselter Mail verwendet — wird später einer echten CA vorgelegt, ohne ihn neu zu erzeugen. Nur S/MIME-Identitäten, und nur solange die private Hälfte noch gehalten wird. Dieselbe Anforderung ist ohne Terminal verfügbar:POST /api/v1/identities/{id}/csrund die Identitätsseite der Konsole bitten pepsi-setup apply darum alsidentity-csr-Aufgabe, und das ausgestellte Zertifikat wird mitPOST /api/v1/identities/{id}/certificate(identity-certificate) installiert, das prüft, dass es über dem eigenen Schlüssel der Identität liegt (siehe pepsi-httpd(1) und pepsi-setup(1)).- identity revoke IDENTITY-ID [–reason TEXT] [–upload]
Zieht eine Identität zurück. Der Datensatz wird
revokedund hört auf, primär zu sein; die öffentliche Hälfte bleibt erhalten, sodass vor dem Widerruf erstellte Signaturen weiterhin geprüft werden können. Die private Hälfte einessign-Datensatzes wird hier und jetzt zerstört; einencrypt- oderboth-Datensatz behält seine private Hälfte, und der Befehl sagt das. TEXT wird mit dem Datensatz festgehalten.Für eine OpenPGP-Identität, deren private Hälfte noch gehalten wird, baut der Befehl zuerst ein Widerrufszertifikat — signiert von dem Schlüssel, den es ausmustert, mit TEXT als Grund — und speichert es als öffentliche Hälfte der Identität, in derselben Anweisung, die den Datensatz widerruft (und die private Hälfte eines
sign-Datensatzes vernichtet). Das Web Key Directory liefert den Schlüssel dann als widerrufen aus, nach jedem verwendbaren Schlüssel der Adresse, sodass der Client eines Korrespondenten, der ihn auffrischt, erfährt, dass er tot ist; und wenn der Schlüssel zu einem Keyserver hochgeladen worden war, wird der Widerruf sofort dorthin hochgeladen, oder durch identity publish –retry, falls das fehlschlägt. Lässt sich das Zertifikat nicht erstellen (etwa kein Schlüsselverschlüsselungsschlüssel), wird nichts widerrufen, und der Befehl schlägt fehl. Der E-Mail-Befehlretirevon pepsi-stage-encrypt(1) und dierevoke-identity-Aufgabe der Konsole widerrufen auf dieselbe Weise.Für eine S/MIME-Identität (ihr Aussteller widerruft sie), den eigenen MUA-Schlüssel eines Benutzers (die private Hälfte liegt in seinem Mail-Client) oder einen Schlüssel, dessen private Hälfte bereits vernichtet wurde, lässt sich kein Zertifikat erstellen; eine solche Identität wird einfach nicht mehr ausgeliefert, und der Befehl gibt aus, dass Korrespondenten, die sie haben, nicht benachrichtigt werden.
–upload sendet den Widerruf an den konfigurierten Keyserver, auch wenn der Schlüssel nie dorthin hochgeladen wurde; ein hochgeladener Schlüssel erhält ihn ohne das Flag. Einem Keyserver kann man sagen, dass ein Schlüssel widerrufen ist, nie, ihn zu vergessen.
- identity forget-private IDENTITY-ID [-y, –yes]
Zerstört den privaten Schlüssel einer Identität dauerhaft und lässt die öffentliche Hälfte zurück. Das ist der einzige Weg, auf dem ein Entschlüsselungsschlüssel den Speicher verlässt, und er ist unumkehrbar: Alles, was noch in
pepsi.workqueueeingereiht ist, alles in einem verschlüsselten Archiv und jede später aus einer Sicherung erneut zugestellte Nachricht wird unlesbar. Bereits zugestellte Mail ist nicht betroffen. Der Befehl gibt genau das aus und bittet um Bestätigung; –yes überspringt die Frage, und ohne Terminal und ohne –yes lautet die Antwort nein, sodass ein unbeaufsichtigter Lauf kein Schlüsselmaterial zerstören kann, bloß weil niemand da war, um zu widersprechen.- identity set-primary IDENTITY-ID
Macht dies zu dem Material, das für neue Nachrichten seines Tripels (Adresse, Protokoll, Zweck) verwendet wird. Nur eine
active-Identität darf primär gemacht werden. Die vorherige primäre desselben Tripels wird zurückgestuft.- identity publish IDENTITY-ID [–wkd] [–vks] [-y, –yes]
Bedient die öffentliche Hälfte der Identität über das Web Key Directory. Das ist der umkehrbare Kanal — unser eigener Server, unsere eigene Domain — und ihn benennt –wkd; er ist zugleich der Standardwert, sodass das Flag nur existiert, um den Kanal ausdrücklich zu machen. Das Material bleibt so oder so brauchbar.
–vks hält zusätzlich die Upload-Anforderung fest (
vks_wanted), lädt den Schlüssel zum konfigurierten Keyserver hoch und bittet ihn, den Bestätigungslink an die Adresse zu mailen. Weil die Anforderung vor dem Versuch festgehalten wird, wird ein fehlgeschlagener Upload von identity publish –retry erneut versucht statt vergessen. Das ist unumkehrbar: Einem Keyserver kann später gesagt werden, dass der Schlüssel widerrufen ist, aber nie, ihn zu vergessen, und die Adresse wird zu einem dauerhaften öffentlichen Eintrag. Der Befehl gibt genau aus, was nicht zurückgenommen werden kann, und bittet um Bestätigung; –yes überspringt die Frage, und ohne Terminal und ohne –yes lautet die Antwort nein. Nur OpenPGP — für S/MIME gibt es keinen Keyserver, dessen Veröffentlichungskanal ist derSMIMEA-Eintrag, den dns ausgibt.- identity publish –retry [–dry-run]
Arbeitet statt einer einzelnen jede veröffentlichte, aktive OpenPGP-Identität ab, deren Upload angefordert wurde (
vks_wanted) und die auf dem Keyserver noch nicht bestätigt ist. Das ist die Form, die periodisch laufen sollte:pepsi-keys-publish-retry.timerführt sie stündlich aus. Sie hängt nicht von[pepsi-keys] VKS_PUBLISHab: Diese Option entscheidet nur, ob von Hand erstellte Schlüssel als angefordert beginnen, und die eigene Anforderung eines Benutzers wird befolgt, gleich was sie sagt. Ein automatisch erzeugter Schlüssel steht nie auf der Liste, es sei denn, sein Eigentümer hat darum gebeten.Sie existiert, weil die Veröffentlichung ein zweistufiges Protokoll ist: Ein Hochladen liefert ein Token, nur das Token autorisiert die Bestätigungsmail, und nur ein gefolgter Link bewegt den Server dazu, den Schlüssel nach Adresse auszuliefern. Ein hochgeladener, aber nie bestätigter Schlüssel ist gespeichert und dennoch unauffindbar. Jede Runde fragt zuerst den Keyserver, ob die Adresse bereits ausgeliefert wird, und lädt andernfalls hoch und fordert die Verifikation an. Ein Bestätigungslink, dem pepsi-stage-vks-confirm(1), ein Mensch oder ein früherer Lauf gefolgt ist, dessen Datenbankschreibvorgang nicht ankam, beendet die Schleife daher ebenso. Identitäten werden um
VKS_RETRY_INTERVALgestreckt, höchstensVKS_BATCHje Lauf, und nachVKS_MAX_ATTEMPTSaufgegeben, wobei der Grund für identity show auf dem Datensatz zurückbleibt. –dry-run listet auf, was veröffentlicht würde, und ändert nichts. Nur für Betreiber.Ihre zweite Arbeitsliste sind die Widerrufe: jede widerrufene OpenPGP-Identität, deren Schlüssel hochgeladen worden war und deren Widerrufszertifikat der Keyserver noch nicht angenommen hat (
vks_revoked_at), nach denselben Zählern verteilt und gedeckelt. Wie auch immer der Schlüssel widerrufen wurde — mit diesem Befehl, dem E-Mail-Befehlretireoder der Konsole —, dieser Job ist der Weg, auf dem sein Widerruf den Keyserver erreicht.- identity unpublish IDENTITY-ID
Hört auf, die Identität über das Web Key Directory zu bedienen, und vergisst ihre Keyserver-Buchführung, sodass der Wiederholungsjob sie in Ruhe lässt und eine spätere Neuveröffentlichung von einem sauberen Blatt beginnt.
Es entfernt nichts von einem Keyserver, denn nichts kann das. Wenn die Identität hochgeladen worden war, sagt der Befehl das und verweist auf identity revoke –upload, was der einzige Weg ist, der Welt mitzuteilen, dass der Schlüssel tot ist (die Buchführung, die er vergisst, ist das, was den Widerruf sonst ohne das Flag dorthin senden würde).
- identity delete IDENTITY-ID [-y, –yes]
Entfernt den Datensatz vollständig, öffentliche Hälfte inbegriffen. Bestätigt wie forget-private. Bevorzugen Sie revoke, das die öffentliche Hälfte behält, sodass alte Signaturen prüfbar bleiben; eine gelöschte Identität hinterlässt überhaupt nichts.
- identity retire
Führt den Ausmusterungsdurchlauf über jede Identität aus: Alles jenseits seines
expires_atwirdexpired, privates Signier-Material wird zerstört und mit einem Stempel versehen, und Entschlüsselungsmaterial (einschließlich dem eines gemeinsamenboth-Datensatzes) bleibt unangetastet.pepsi-keys-retire.timerführt ihn täglich aus; identity revoke wendet dieselbe Regel inline für eine Identität an. Nur für den Betreiber.- identity rotate-due [–dry-run]
Der planmäßige Lauf des Forward-Secrecy-Profils, aus, sofern
[pepsi-crypto] ENCRYPTION_ROTATION_DAYSnicht gesetzt ist (siehe pepsi.conf(5) und das Kapitel zur Schlüsselverwaltung im Handbuch). Zuerst wird jeder vom Server gehaltene (custody = local) entschlüsselungsfähige Schlüssel ersetzt, der älter als so viele Tage ist: Ein neuer Schlüssel wird erzeugt, wie es identity generate täte, und wird zum primären, über WKD veröffentlicht, wenn der alte es war, und für den Keyserver eingereiht, wenn der alte es war; der alte Schlüssel wird über denselben Pfad wie identity revoke widerrufen (Grundsuperseded), sodass ein OpenPGP-Schlüssel sein Widerrufszertifikat erhält und das Web Key Directory ihn als widerrufen ausliefert; anders als ein von Hand widerrufener Schlüssel öffnet er weiterhin an ihn verschlüsselte Mail, bis seine private Hälfte vernichtet ist. Ein OpenPGP-Schlüssel wird ganz ersetzt (ein Schlüssel signiert und entschlüsselt); von einem aufgeteilten S/MIME-Paar wird nur das Verschlüsselungszertifikat ersetzt, und neue SMIMEA-Einträge werden fällig (dns). Auditiert alskey.identity.rotate. Zweitens wird die private Hälfte jedes ausgemusterten (widerrufenen oder abgelaufenen) vom Server gehaltenen Entschlüsselungsschlüssels vernichtet, der vor mehr alsRETIRED_PRIVATE_GRACE_DAYS(standardmäßig 30) ausgemustert wurde – es sei denn, eine noch in der Warteschlange liegende Nachricht, in beliebiger Stage oder beliebigem Status (wartend, geparkt, fehlgeschlagen), ist an ihn verschlüsselt, beurteilt anhand der Empfängerbezeichner des äußersten Chiffrats der gespeicherten Nachricht; ein solcher Schlüssel wird behalten, mit Nennung der Warteschlangen-IDs, und beim nächsten Lauf erneut versucht. Das Vernichten ist dieselbe Operation wie identity forget-private und wird alskey.identity.forget-privateauditiert. Der eigene Schlüssel eines Benutzers (Client-Verwahrung) wird nie rotiert oder getilgt, und ein reiner Signierschlüssel wird dadurch nie getilgt. Idempotent;--dry-runmeldet, was fällig ist, und ändert nichts.pepsi-keys-rotate.timerführt es täglich aus. Nur für den Betreiber.
95.1.50.1.4.2. Peer-Befehle¶
- peer list [–address ADDRESS] [–json]
Listet zwischengespeicherte Peer-Schlüssel auf: ID, Adresse, Protokoll, Quelle, Gültigkeit, ob die Abfrage, die ihn erzeugt hat, DNSSEC-validiert war, ob er gepinnt ist, und den Fingerabdruck. Ein Datensatz, den pepsi-keydisc(1) ausgemustert hat, weil die Sperrliste seines Ausstellers ihn nannte, lautet
revokedund endet mit-- revoked DATE: REASON(welcher Verteilungspunkt ihn listete, der Grundcode und das Datum des Eintrags;revoked_atundrevoked_reasonim JSON). Ein solcher Datensatz ist für niemanden ein Schlüssel – pepsi-stage-encrypt(1) behandelt die Adresse als eine ohne Schlüssel – und bleibt aufgeführt, bis eine Entdeckung ihn ersetzt (ein neu ausgestelltes Zertifikat aus derselben Quelle darf das) oder peer remove ihn verwirft.- peer show ADDRESS [–protocol PROTOCOL] [–json]
Zeigt die für ADDRESS zwischengespeicherten Schlüssel nach der Passungsregel: Eine exakte Adressübereinstimmung gewinnt immer, und ein
*@domain-Datensatz wird nur herangezogen, wenn es keine exakte gibt (er wird in der Ausgabe als domainweiter Rückfall gekennzeichnet). PROTOCOL ist standardmäßigopenpgp. Ein widerrufener Datensatz wird mit demselben-- revoked-Hinweis wie in peer list gezeigt; er wird aufgeführt, nicht verwendet.- peer unclaimed [–address ADDRESS] [–all-sources] [–json]
Listet die Adressen auf, die diese Installation bedient und die keine Identität von uns besitzen, wohl aber einen geernteten oder per Gossip erhaltenen Peer-Schlüssel — die Schlüssel, die ein Fremder einschleusen kann, indem er uns eine Nachricht mit gefälschtem
From:schickt. Schlüssel werden aus demFrom:-Header geerntet, den der Absender schreibt, und die eingehende Authentifizierung ist fail-open, sodass ein solcher Datensatz auf einer Installation, die DMARC für ihre eigene Domain nicht durchsetzt, einen unserer eigenen Benutzer nennen kann. Wo wir eine Identität besitzen, ist der Datensatz wirkungslos (unser eigener Schlüssel hat Vorrang); wo nicht, entscheidet er, womit Mail an diesen Benutzer verschlüsselt wird. Das ist gewollt, denn es ist auch der einzige Weg, auf dem ein Benutzer, der GnuPG in seinem eigenen Client betreibt, hier seinen echten Schlüssel bekommt. Dies ist daher eine Arbeitsliste, kein Alarm: Bestätigen Sie jeden Schlüssel mit seinem Inhaber und importieren Sie ihn dann als Identität (identity import ohne –private), wonach er wirkungslos ist, oder entfernen Sie ihn (peer remove).Bedient heißt, die Domain ist eine von
[pepsi-ingress] ACCEPTED_DOMAINSoder[pepsi-crypto] LOCAL_DOMAINS; ein passwd-Konto ist nicht erforderlich. Keine Identität heißt keine aktive Identität, die verschlüsseln kann — dieselbe Regel, die der Vorrang in der Verschlüsselungs-Stage anwendet —, sodass eine Adresse, deren einzige Identität abgelaufen ist, widerrufen wurde oder nur signieren kann, aufgelistet wird; die SpalteIDSzählt ihre Identitäten in jedem Zustand. Geerntet ist die Quelleinboundoderinbound-signed(der eigeneAutocrypt:-Header des Absenders oder ein angehängter Schlüssel, Letzteres aus einer Nachricht, die die DKIM-Signatur seiner Domain abdeckte) odergossip(dasAutocrypt-Gossip:eines Dritten); –all-sources schließt auch entdeckte, manuelle und per API gesetzte Schlüssel ein, also die Menge, dieGET /api/v1/peers/unclaimedmeldet. Ein*@domain-Datensatz wird nie aufgelistet. Nur lesend und nur für den Betreiber. Der Exit-Status ist 0, ob etwas gefunden wurde oder nicht; mit –json ist ein leerer Bericht[], worauf eine periodische Prüfung testen sollte.- peer import ADDRESS –protocol P –file FILE [–pin]
Speichert den Schlüssel eines Korrespondenten von Hand (
-liest die Standardeingabe). Der Datensatz wird mit der Quellemanualfestgehalten, die jeden Entdeckungsmechanismus überragt, und ist die einzige Quelle, die eine*@domain-Adresse tragen darf — eine Datenbank-Einschränkung, keine Konvention, sodass keine Entdeckungsantwort für eine Adresse je auf eine ganze Domain verallgemeinert werden kann. Ein*@domain-Schlüssel authentifiziert die Domain (praktisch ihr Gateway), nicht einen einzelnen Absender: Eine Signatur, die sich gegen ihn verifizieren lässt, zeigt, dass der Schlüsselinhaber der Domain signiert hat, nicht, welcher Benutzer der Domain die Nachricht geschrieben hat, und an ihn zu verschlüsseln erreicht das Gateway statt der Person. Nennt das Zertifikat überhaupt keine Adresse, sagt der Befehl das beim Speichern: Eine mit einem solchen Schlüssel erstellte Signatur wird für jedeFrom:-Adresse der Domain alsvalidgemeldet. Tragen Sie einen nur für ein Partner-Gateway ein, dem Sie zutrauen, für jeden seiner Benutzer zu signieren.Ein Schlüssel, der mit einem bereits gespeicherten kollidiert, ersetzt ihn nur, wenn er alles Dortige überragt; ein gepinnter Datensatz wird nie verdrängt, und der Befehl sagt, welches von gespeichert, aufgefrischt, ersetzt und behalten geschah. (Die einzige Ausnahme von „nur wenn er überragt“ ist die Neuestes-gewinnt-Regel der Autocrypt-Stufe, an der ein
manual-Schlüssel in keiner Richtung beteiligt ist — siehe pepsi-keydisc(1).)Einen bereits gespeicherten Schlüssel (gleicher Fingerabdruck) zu importieren führt die Datei mit dem gespeicherten Zertifikat zusammen, statt es zu ersetzen, sodass ein älterer Export keinen Widerruf rückgängig machen kann, den die gespeicherte Kopie trägt.
Ein Schlüssel, dessen private Hälfte bekannt ist, wird abgelehnt: einer auf der Liste bekanntermaßen kompromittierter Schlüssel (Befehle für die Liste kompromittierter Schlüssel: badkeys, die schwachen Debian-OpenSSL-Schlüssel und die Moduli, die ein früheres
peer screenfaktorisiert hat) oder ein RSA-Schlüssel, dessen Modulus seine Primfaktoren preisgibt (ROCA, nahe beieinanderliegende Primzahlen, ein kleiner Faktor).- –pin
Pinnt den importierten Schlüssel, sodass die Entdeckung ihn nie ersetzt.
- peer pin PEER-KEY-ID, peer unpin PEER-KEY-ID
Setzt oder löscht den Pin auf einem gespeicherten Schlüssel.
- peer refresh [–address ADDRESS] [–expire PEER-KEY-ID] [–expiring-within-days DAYS] [–limit N]
Validiert zwischengespeicherte Peer-Schlüssel neu. Es frischt immer nur Schlüssel auf, die bereits existieren: Es entdeckt nie einen Schlüssel für eine Adresse, die keinen hat. Pepsi schlägt eine Adresse nach, wenn es Mail für sie hat, weshalb die Entdeckung von der Pipeline getrieben wird (pepsi-keydisc(1)) und nicht von diesem Befehl.
Drei Gestalten, ausgewählt durch die Flags:
- –address ADDRESS
Führt die gesamte Entdeckungs-Auffächerung für eine Adresse in diesem Prozess aus — jede Methode in
[pepsi-keydiscovery] SOURCESauf einmal, mit der Rang-Gnadenfrist-Abbruchregel — und speichert das Gefundene mit der richtigen Quelle und dem richtigen DNSSEC-Kennzeichen. Eine Zeile je Methode wird ausgegeben: das Protokoll und der Fingerabdruck (mit(dnssec)markiert für eine AD-validierte DANE-Antwort),no keyoder der Fehler. Das erledigt außerdem die Entdeckungsanfrage der Adresse, sodass jede darauf geparkte Nachricht freigegeben wird. Eine durchALLOW_DOMAINS/DENY_DOMAINSausgeschlossene Adresse wird abgelehnt statt abgefragt.- –expire PEER-KEY-ID
Löscht die Cache-Frist eines Datensatzes, sodass die nächste Nachricht für diese Adresse neu abholt. Überhaupt keine Netz-E/A, und schließt –address aus.
- (kein Flag)
Durchlauf: Jeder fällige Schlüssel — sein
refresh_afterist verstrichen, oder sein eigener Ablauf fällt in –expiring-within-days (Standardwert7) — wird erneut geprüft, bis zu –limit Schlüsseln (Standardwert100), nur über die Methode, aus der er gelernt wurde: einvks-Schlüssel beim Keyserver, einwkd- oderwkd-direct-Schlüssel bei derselben Methode des Web Key Directory, eindane-Schlüssel im DNS, einldap-Schlüssel im Verzeichnis — und nur, solange diese Methode noch inSOURCESsteht. Schlüssel, die aus keiner Netzwerkmethode stammen (inbound,inbound-signedundgossip, aus Mail geerntet;manual/api, von Hand eingetragen), werden nie über das Netz aufgefrischt, ebenso wenig gepinnte Schlüssel oder*@domain-Datensätze; solche Schlüssel werden nicht einmal ausgewählt, sodass sie nie –limit verbrauchen. Die Anzahl der neu validierten wird ausgegeben. Das ist der natürliche Inhalt eines periodischen Timers, undpepsi-keys-refresh.timerführt ihn täglich aus (mit--limit 200). Dem Keyserver wird daher nur von Korrespondenten erzählt, deren Schlüssel er ursprünglich geliefert hat, einmal jeCACHE_TTL;ALLOW_DOMAINS/DENY_DOMAINSgelten,[stage-encrypt] DISCOVERYnicht.
- peer prune [–retain-days DAYS] [–dry-run]
Löscht abgelaufene Peer-Schlüssel und veraltete Entdeckungsanfragen — zwei Tabellen, eine Aufgabe. Ein Peer-Schlüssel, der vor mehr als DAYS (Standardwert
7) abgelaufen ist, wird entfernt, sofern er nicht gepinnt ist. Der Ablauf ist derjenige, den der Schlüssel selbst angibt — die aktuelle Selbstsignatur eines OpenPGP-Primärschlüssels, ein X.509-notAfter—, festgehalten, wann immer ein Schlüssel gelernt wird, ob durch Entdeckung, Ernten oder Gossip (ein von Hand importierter Schlüssel hält keinen fest, und ein Schlüssel, der keinen angibt, wird nie bereinigt); auf derpepsi.key_request-Seite haben sowohl ein erledigter Datensatz, dessen Negativeintrag über dasselbe Fenster hinaus gealtert ist, als auch ein ausstehender Datensatz, der so lange über seine Frist hinaus aufgegeben wurde, nichts mehr zu sagen und gehen ebenfalls. –dry-run meldet, wie viele Schlüssel einen Ablauf tragen und ungepinnt sind, und entfernt nichts.- peer screen [–dry-run]
Gespeicherte Schlüssel finden, deren private Hälfte bekannt ist, und sie aus dem Cache entfernen. Zwei Tests laufen über jeden Peer-Schlüssel und die öffentliche Hälfte jeder nicht widerrufenen Identität:
Batch-GCD über alle ihre RSA-Moduli (Bernsteins Produkt- und Restbäume): Zwei Schlüssel, die von einem Generator mit zu wenig Entropie erzeugt wurden, können eine Primzahl teilen, und dann faktorisiert ein
gcdbeide. Kein Test eines einzelnen Schlüssels kann das sehen; es ist eine Eigenschaft des Paars. Ein faktorisierter Modulus wird in der Liste bekanntermaßen kompromittierter Schlüssel festgehalten (pepsi.compromised_key, Listescreen), sodass derselbe Schlüssel bei der Verwendung abgelehnt und nicht erneut gespeichert wird, weder durch die Schlüsselentdeckung noch wenn eine Nachricht ihn trägt (pepsi-stage-autocrypt-learn(1));die Liste bekanntermaßen kompromittierter Schlüssel selbst (Befehle für die Liste kompromittierter Schlüssel), für Schlüssel, die gespeichert wurden, bevor die Liste sie kannte.
Ein Peer-Schlüssel, der einen der beiden Tests nicht besteht, wird gelöscht, auch ein gepinnter (ein Pin sagt, wessen Schlüssel es ist, und ein faktorisierter Schlüssel gehört jedem), und jeder wird im Audit-Log als
key.peer.compromised(Schweregradwarning) festgehalten. Unsere eigenen Identitäten werden gemeldet, nie verändert: Der private Schlüssel einer faktorisierten Identität ist berechenbar, die Abhilfe (sie widerrufen, eine neue erstellen) ist Sache des Betreibers, und die Prüfung schreibt einenkey.identity.compromised-Datensatz mit Schweregraderrorund sagt das auf der Standardausgabe. –dry-run meldet und ändert nichts. Exakte Duplikate (ein Schlüssel unter zwei Adressen gespeichert) sind kein gemeinsamer Faktor. Die Arithmetik braucht Zeit quadratisch zur Gesamtgröße der Moduli: Sekunden für Tausende von Schlüsseln, Minuten für Zehntausende.pepsi-keys-refresh.serviceführt sie täglich aus, nachpeer refreshundpeer prune.- peer remove PEER-KEY-ID
Löscht einen gespeicherten Schlüssel. So lässt ein Betreiber auch den neueren Autocrypt-Schlüssel eines Korrespondenten durch, den
ACCEPT_ROTATION = expiredzurückgehalten hat (einkey.peer.rotate.held-Audit-Datensatz; siehe pepsi-stage-autocrypt-learn(1)): Ist der alte Datensatz weg, speichert die nächste Nachricht mit dem neuen Schlüssel ihn als ersten Schlüssel.
95.1.50.1.4.3. S/MIME-Fähigkeitsdatensätze¶
Ob der S/MIME-Client eines Korrespondenten CMS-AuthEnvelopedData (AES-256-GCM) liest, wird je Peer in pepsi.smime_capability gehalten, weil ein X.509-Zertifikat keine eigene Inhaltsverschlüsselungsfähigkeit angibt. pepsi-stage-encrypt(1) und pepsi-stage-reencrypt(1) wählen den Container danach: Unter dem Standard [pepsi] CRYPTO_ALLOW_DOWNGRADE = negotiate erhält ein als cbc festgehaltener Empfänger AES-256-CBC-EnvelopedData, und jeder andere Empfänger — einschließlich eines ohne Datensatz — erhält AuthEnvelopedData. Datensätze stammen aus zwei Quellen:
gelernt — pepsi-stage-autocrypt-learn(1) liest das
SMIMECapabilities-Attribut nach RFC 8551 der signierten Mail eines Korrespondenten und hält es für das Zertifikat fest, das die Signatur erstellt hat (nur wenn sich diese Signatur verifizieren lässt), sodass eine Angabe niemanden außer dem Schlüsselinhaber beschreibt;konfiguriert — mit den Befehlen unten, für eine Adresse oder
*@domain. Ein konfigurierter Datensatz gewinnt gegenüber einem gelernten.
Thunderbird kann AuthEnvelopedData nicht lesen und zeigt eine leere Nachricht, wenn es eine erhält. Seine Signaturen kündigen kein AES-GCM an, daher wird ein Thunderbird-Korrespondent, der eine signierte Nachricht gesendet hat, automatisch festgehalten. Einer, der nie eine signierte Nachricht gesendet hat, erhält mit der ersten an sein Zertifikat verschlüsselten Nachricht neben dem Chiffrat einen Klartexthinweis, der ihn bittet, eine leere Nachricht zu melden und signiert zu antworten (pepsi-stage-encrypt(1), „Der Hinweis bei der ersten Nachricht“); peer capability set ADDRESS cbc erledigt das sofort. Der Hinweis wird einmal je Zertifikat gesendet, und die Tabelle hält auch das fest: Ein notice-Datensatz trägt den Fingerabdruck und notice_sent_at, aber keine Fähigkeit. Ein Korrespondent, der mit einem Zertifikat signiert und an ein anderes verschlüsselt, braucht ebenfalls einen konfigurierten Datensatz, da ein gelernter Datensatz nur das signierende Zertifikat abdeckt. Alle vier Befehle sind nur für den Betreiber.
- peer capability list [–address ADDRESS] [–json]
Listet die Datensätze auf, oder die, die ADDRESS betreffen: ihren konfigurierten Datensatz, den
*@domain-Datensatz ihrer Domain und die gelernten und Hinweis-Datensätze der für sie zwischengespeicherten Zertifikate. Ein gelernter oder Hinweis-Datensatz zeigt die Adressen, deren zwischengespeicherte Schlüssel dieses Zertifikat sind; die SpalteREADSsagtaead,cbcoder, bei einem Hinweis-Datensatz,told.- peer capability set ADDRESS aead | cbc
Konfiguriert den Datensatz für ADDRESS (oder
*@domain) und ersetzt einen etwaigen vorhandenen. Auditiert alskey.peer.capability.- peer capability unset ADDRESS
Entfernt den konfigurierten Datensatz; ein gelernter, falls vorhanden, gilt wieder. Auditiert.
- peer capability forget FINGERPRINT
Entfernt den für ein Zertifikat gelernten Datensatz (hexadezimaler SHA-256, Doppelpunkte erlaubt). Die nächste signierte Nachricht seines Inhabers hält ihn erneut fest. Auditiert.
95.1.50.1.4.4. Befehle für die Liste kompromittierter Schlüssel¶
Pepsi schlägt jeden Schlüssel, den es beurteilt, in pepsi.compromised_key nach: einen Schlüssel, an den verschlüsselt werden soll, einen Schlüssel zum Verifizieren, einen Schlüssel in einer S/MIME-Kette und einen Schlüssel, bevor die Schlüsselentdeckung oder eine Nachricht ihn speichert. Ein dort gefundener Schlüssel wird wie einer unter [pepsi] CRYPTO_MIN_RSA_BITS abgelehnt: Jeder kann mit ihm signieren und lesen, was an ihn verschlüsselt ist. Die Tabelle enthält zwei Listen, unterschieden durch einen Quellnamen:
die badkeys-Sperrliste (https://badkeys.info): jeder RSA- und EC-Schlüssel, den der Debian-OpenSSL-Fehler (CVE-2008-0166) erzeugen konnte, in RFCs, Testsuites und Dokumentation veröffentlichte Schlüssel und aus Firmware und Softwarepaketen extrahierte Schlüssel, als gekürzte SHA-256-Hashes des öffentlichen Werts jedes Schlüssels (kein Schlüsselmaterial). Ihre Quelllisten behalten die Namen von badkeys (
debianssl,forti,rfc, …). Dieransomware-Liste von badkeys, Schlüssel von Ransomware-Betreibern, die kein Korrespondent verwendet, wird ausgelassen;screen: die RSA-Moduli, diepeer screenhier faktorisiert hat.
Die Liste wächst nur. Eine Aktualisierung fügt Neues hinzu und entfernt nichts, da ein Schlüssel, dessen private Hälfte einmal veröffentlicht wurde, kompromittiert bleibt. Ein als falsch erkannter Eintrag wird verworfen: Er lehnt nichts mehr ab, und die nächste Aktualisierung fügt ihn nicht wieder hinzu. Alle vier Befehle sind nur für den Betreiber.
- blocklist update [–force]
Fragt
[pepsi-keydiscovery] BADKEYS_URL/badkeysdata.json(Standardwert https://update.badkeys.info/v0), ob sich die Liste geändert hat, und sendetETagundLast-Modifieddes letzten Laufs zurück; eine unveränderte Liste kostet diese eine Anfrage. Eine neue Liste wird heruntergeladen (etwa 50 MB im Jahr 2026), nur von unterhalb vonBADKEYS_URL, gegen den SHA-256 geprüft, den die Metadaten nennen, und auf ihre Ordnung, und ihre neuen Einträge werden in einer Transaktion hinzugefügt. Der erste Import schreibt etwa drei Millionen Datensätze (etwa 240 MB mit dem Index) und dauert unter einer Minute. Zwei Prüfungen stehen für die Signatur, die die Metadaten nicht tragen; sie lehnen die Liste ab, wenn sie weniger Einträge hat als die letzte oder wenn sie mehr als ein Viertel dessen hinzufügen würde, was vorhanden ist (jenseits von 50 000 Einträgen; der erste Import ausgenommen). –force importiert eine solche Liste dennoch und ruft eine unveränderte erneut ab. Jeder Lauf, sein Ergebnis (imported,unchanged,refused,failed) und was er aus welcher Quellliste hinzugefügt hat, wird inpepsi.compromised_key_importfestgehalten.pepsi-keys-blocklist.timerführt es zehn Minuten nach seinem Start und dann täglich aus;systemctl mask --now pepsi-keys-blocklist.timerstoppt das (dasWants=vonpepsi.targetstartet einen bloß deaktivierten Timer wieder).- blocklist status [–json]
Wann die Liste zuletzt geprüft wurde und das Datum der Liste, die sie hält, die Einträge je Quellliste (und wie viele verworfen sind) und die letzten zehn Läufe mit dem, was jeder hinzugefügt hat. pepsi-status(1) warnt, wenn die letzte Prüfung mehr als drei Tage alt ist oder der letzte Lauf fehlschlug oder abgelehnt wurde.
- blocklist dismiss –import N | –list NAME
Nimmt Einträge außer Dienst: die, die ein Lauf hinzugefügt hat (N aus
blocklist status), oder die einer Quellliste (ein badkeys-Listenname, ihre Nummer oderscreen). Auditiert (key.blocklist.dismiss). Ein verworfener Eintrag bleibt in der Tabelle, sodass eine Aktualisierung ihn nicht wieder hinzufügen kann.- blocklist restore –import N | –list NAME
Macht
dismissrückgängig. Auditiert (key.blocklist.restore).
95.1.50.1.4.5. Liste der Certificate-Transparency-Logs¶
Bei jeder TLS-Client-Verbindung, die Pepsi gegen die öffentlichen Wurzeln verifiziert, prüft es die Signed Certificate Timestamps des Server-Zertifikats gegen eine Liste von Certificate-Transparency-Logs und warnt vor einem Zertifikat, das nicht protokolliert wurde ([pepsi] CT_CHECK, pepsi.conf(5)). Die Liste ist eine öffentliche Datei, [pepsi] CT_LOG_LIST (Standardwert /var/lib/pepsi/ct-log-list.json), im Format der v3-Log-Liste von Google; keine Datenbank ist beteiligt. Beide Befehle sind nur für den Betreiber.
- ct-logs update [–force]
Ruft
[pepsi] CT_LOG_LIST_URLab (Standardwert https://www.gstatic.com/ct/log_list/v3/log_list.json) und sendetETagundLast-Modifieddes letzten Laufs zurück (inCT_LOG_LIST.metaaufbewahrt), sodass eine unveränderte Liste eine Anfrage kostet. Eine neue Liste wird geparst, bevor irgendetwas geschrieben wird, abgelehnt, wenn sie verwendbare Logs von weniger als zwei Betreibern nennt oder älter als die vorhandene Liste ist, und ersetzt andernfalls die Datei atomar (Modus 0644). –force ruft eine unveränderte Liste erneut ab und installiert eine ältere.pepsi-keys-ct-logs.timerführt es fünf Minuten nach seinem Start und dann täglich aus;systemctl mask --now pepsi-keys-ct-logs.timerstoppt das, und Zertifikate werden nicht mehr geprüft, sobald die Liste mehr als 70 Tage alt ist.- ct-logs status [–json]
Pfad, Datum, Alter und Anzahl der Logs der Liste und ob sie zu alt ist, um verwendet zu werden.
95.1.50.1.4.6. Vertrauensanker-Befehle¶
- ca list [–json]
Listet die Vertrauensanker mit ihrer ID auf, ob sie aktiviert sind, ob sie für ein Blatt bürgen, das keine Mailbox nennt (
NAMELESS), ihre Bezeichnung, ihren Geltungsbereich (SCOPE: die Domains,(constrained)für einen nicht eingegrenzten Anker, dessen ZertifikatnameConstraintsträgt, sonstany) und ihr Subject; danach eine Warnung, die jeden aktivierten Anker nennt, der für jede Mail-Domain bürgt. Das JSON trägtpermitted_domainsundconstrained.- ca add FILE [–label TEXT] [–accept-nameless]
Fügt ein CA-Zertifikat (DER oder PEM;
-liest die Standardeingabe) als Vertrauensanker hinzu. Ein Zertifikat ohnebasicConstraints CA:TRUEwird abgelehnt: Keine Kette könnte je bei ihm enden. Idempotent bezüglich des SHA-256 des Zertifikats — denselben Anker zweimal hinzuzufügen aktualisiert nur die Bezeichnung.--accept-namelesssetzt die unten beschriebene Freischaltung an einem neuen Anker,--domain(wiederholbar) seinen Geltungsbereich (siehe ca scope); der Geltungsbereich eines vorhandenen Ankers wird nur mit ca scope geändert.- ca scope CA-ID –domain DOMAIN… | –any
Begrenzt die Mail-Domains, für die einem Anker vertraut wird, oder hebt (
--any) die Grenze auf. Jede DOMAIN deckt sich selbst und jede Subdomain ab (example.orgdecktalice@example.orgundbob@sub.example.orgab, nieexample.net); sie wird als kleingeschriebene A-Labels gespeichert, und ein führender Punkt wird abgelehnt. Der Geltungsbereich wird während der Pfadvalidierung als Namensbeschränkung eines Vertrauensankers nach RFC 5937 angewendet – ein erlaubterrfc822Name-Teilbaum je Domain – auf jede Mailbox (rfc822Name,SmtpUTF8Mailbox, Subject-emailAddress) jedes Zertifikats unter dem Anker und auf die zu verifizierendeFrom:-Adresse, zusätzlich zu allennameConstraints, die das Ankerzertifikat selbst trägt (ein Name muss beide erfüllen). Ein Unterzeichner außerhalb davon verkettet nicht zu diesem Anker: Seine Signatur lautetvalid-untrusted, sofern nicht ein anderer Anker für ihn bürgt. Eine Sperrliste, die der Anker (oder ein Zwischenzertifikat darunter) signiert hat, mustert nur Zertifikate innerhalb seines Geltungsbereichs aus. Ein für eine Partner-CA hinzugefügter Anker sollte die Domains dieses Partners tragen; vor einem aktivierten Anker ohne Geltungsbereich und ohne eigenenameConstraintswarnen ca list, pepsi-status(1) und pepsi-setup check. Auditiert alskey.ca.scope.- ca accept-nameless CA-ID yes | no
Ob ein Blatt unter diesem Anker, das keine Mailbox nennt — kein
rfc822Name, keineSmtpUTF8Mailboxnach RFC 9598, keineemailAddress—, dennoch eine Signatur für dasFrom:, unter dem sie eintraf,validmachen darf. Standardmäßig aus: Ein solches Zertifikat widerspricht keinerFrom:-Zeile, sodass die Bindung es nicht scheitern lassen kann, aber es bürgt auch für keine Adresse, und pepsi-stage-decrypt(1) meldet eine Signatur darunter daher alsvalid-untrusted(withheld=no-identity), statt ein Zertifikat als jeden Absender verifizieren zu lassen. Schalten Sie es für eine CA ein, deren eigener Ausstellungsprozess jedes Blatt außerhalb des Bandes an die Mailbox seines Inhabers bindet. Auditiert alskey.ca.accept-nameless.Ein Anker wird hier allein aufgrund seiner
basicConstraintsangenommen, doch der Pfadaufbau wendet seine Einschränkungen wie die jeder anderen CA an (RFC 5937): Ein namensbeschränkter Anker bürgt nur für Namen innerhalb seinernameConstraints, unter einer CA, diepathlen:0angegeben hat, wird keine Sub-CA angenommen, und einrequireExplicitPolicyoderinhibitAnyPolicy, das er trägt, wird beachtet. Eine Kette, die eine davon verletzt, schlägt mitpolicy-rejectedfehl. Ebenso eine über eine CA, die eine kritische Erweiterung trägt, die Pepsi überhaupt nicht verarbeiten kann (RFC 5280 §4.2) — eine solche CA wird nie als Aussteller verwendet.- ca enable CA-ID, ca disable CA-ID
Übergibt einen Anker an den Verifizierer oder hört damit auf, während der Datensatz fürs Protokoll erhalten bleibt.
- ca remove CA-ID
Löscht einen Anker.
Pepsi liefert bewusst keine Standard-Ankermenge aus. Eine Signatur, die sich zu einer CA kettet, die niemand gewählt hat, wird als nicht vertrauenswürdig statt als schlecht gemeldet, sodass ein leerer Speicher auf „wir können dafür nicht bürgen“ abfällt — und ein Betreiber, der einen Anker hinzufügt, trifft eine Entscheidung, statt eine zu erben.
95.1.50.1.4.7. Befehle für den zweiten Faktor¶
Eine Adresse kann einen zweiten Faktor haben: ein TOTP-Geheimnis (RFC 6238, SHA-1, sechs Ziffern, 30-Sekunden-Schritte), das ihr Inhaber in einer Authenticator-App aufbewahrt. Sobald er existiert, muss ein unprivilegierter Aufrufer (eine setuid-Installation) für jede Änderung an den Identitäten dieser Adresse einen aktuellen Code vorlegen – identity generate, import, revoke, forget-private, set-primary, publish, unpublish, delete – sowie für identity export --private und identity csr, und zwar als Option –otp CODE der identity-Gruppe (pepsi-keys identity --otp 123456 revoke 7). Die Inhaberschaft wird vor dem Code geprüft, sodass ein Benutzer keine Fehlschläge gegen die Registrierung eines anderen Benutzers anrechnen lassen kann. Der Betreiber (root, pepsi-crypto, eine Installation ohne setuid) wird nie gefragt. Derselbe zweite Faktor schützt die Schlüsselbefehle per E-Mail und die Web-Konsole; siehe pepsi-stage-encrypt(1) und das Kapitel zur Schlüsselverwaltung im Handbuch.
Ein Code wird einmal angenommen (eine Wiederholung innerhalb seiner eigenen 30 Sekunden wird abgelehnt), ein Schritt Uhrenabweichung in jede Richtung wird toleriert, ein falscher oder wiederholter Code zählt als Fehlschlag und ein richtiger setzt den Zähler zurück, und zehn Fehlschläge in Folge sperren den zweiten Faktor, bis der Betreiber ihn zurücksetzt.
- otp status [ADDRESS] [–json]
Zeigt die Registrierung einer Adresse: wann sie registriert und zuletzt verwendet wurde sowie die aufeinanderfolgenden Fehlschläge (oder
LOCKED). Der Betreiber darf ADDRESS weglassen, um jede Registrierung aufzulisten. Zeigt nie ein Geheimnis.- otp enroll ADDRESS [–otp CODE]
Erzeugt ein neues Geheimnis für ADDRESS und gibt es einmal aus, als base32 und als
otpauth://-URI (qrencode -t ansiutf8macht daraus einen QR-Code zum Scannen). Ersetzt eine bestehende Registrierung und beginnt wieder bei null Fehlschlägen; der Inhaber braucht dafür einen aktuellen Code der alten, der Betreiber nicht – so übergibt der Betreiber einem ausgesperrten Benutzer ein neues Geheimnis.- otp remove ADDRESS [–otp CODE]
Entfernt den zweiten Faktor; der Inhaber braucht einen aktuellen Code.
- otp reset ADDRESS
Nur für den Betreiber: Entfernt den zweiten Faktor unabhängig von seinem Zustand und entsperrt damit die Adresse. Ihr Inhaber registriert sich erneut (per E-Mail oder mit
otp enroll).- otp status –console LOGIN [–json], otp enroll –console LOGIN, otp reset –console LOGIN
Nur für den Betreiber: dasselbe für das Konto LOGIN der Administrationskonsole (ein Konto von
POST /api/v1/accounts, keine Adresse). Einmal registriert, braucht jede Passwort-Anmeldung am Konto (POST /api/v1/auth/login, das Anmeldeformular der Konsole) neben dem Passwort einen aktuellen Code, den pepsi-setup apply für pepsi-httpd(1) in einerconfirm-login-Aufgabe prüft, sodass der Applier installiert sein muss. Das Geheimnis wird unter dem SubjektconsoleLOGIN gehalten; mitresetlässt der Betreiber einen Administrator, dessen zweiter Faktor gesperrt oder verloren ist, wieder herein.
Das Geheimnis wird wie ein privater Schlüssel unter dem Schlüsselverschlüsselungsschlüssel verpackt gespeichert, in einer Tabelle, die nur die Rolle pepsi-crypto lesen darf; wrap rotate verpackt es ebenfalls neu.
95.1.50.1.4.8. Befehle für den Schlüsselverschlüsselungsschlüssel (KEK)¶
- wrap rotate [–dry-run]
Verpackt jeden gespeicherten privaten Schlüssel und jedes Geheimnis eines zweiten Faktors unter der aktuellen
[pepsi-crypto] KEY_WRAP_KEY_IDneu. Die Rotation ist konstruktionsbedingt inkrementell, denn jeder Datensatz hält den Schlüssel fest, der ihn versiegelt hat: Konfigurieren Sie das neue Geheimnis alsKEY_WRAP_SECRETund behalten Sie das alte daneben alsKEY_WRAP_SECRET_<OLD-ID>, richten SieKEY_WRAP_KEY_IDauf die neue Id und führen Sie dies aus. Zwischen der Konfigurationsänderung und dem Durchlauf arbeitet die Installation weiter — neues Material wird unter dem neuen Schlüssel versiegelt, altes Material öffnet sich weiterhin unter dem ausgemusterten — und erst danach darf das ausgemusterte Geheimnis entfernt werden.Derselbe Durchlauf verpackt einen privaten Schlüssel neu, der bereits unter dem aktuellen Schlüssel liegt, aber im Verpackungsformat
0x01, dessen zugehörige Daten den Fingerabdruck des Schlüssels nicht binden (ein solcher Schlüssel öffnet sich weiterhin, wird aber nie so geschrieben); führen Sie ihn einmal auf einer Datenbank aus, die solche enthält, auch wenn der Schlüsselverschlüsselungsschlüssel unverändert ist.Datensätze, deren Schlüsselverschlüsselungsschlüssel kein konfiguriertes Geheimnis hat, werden gemeldet und unangetastet gelassen, statt den Lauf scheitern zu lassen; ebenso Datensätze, die nebenläufig neu verpackt wurden (jede Aktualisierung ist auf die alte Schlüssel-ID und den alten Blob abgesichert, sodass eine neuere Verpackung nie überschrieben wird).
- –dry-run
Listet auf, was neu verpackt würde, und ändert nichts.
95.1.50.1.4.9. DNS-Veröffentlichung¶
- dns ADDRESS
Gibt im Zonendatei-Format die DNS-Einträge aus, die jede veröffentlichte, aktive Identität von ADDRESS veröffentlichen: einen
OPENPGPKEY-Eintrag (RFC 7929) für OpenPGP-Material und einenSMIMEA-Eintrag (RFC 8162, in der TLSA-3 0 0-Form — von der Domain ausgestelltes Zertifikat, vollständiges Zertifikat, exakte Übereinstimmung) für S/MIME. Beide werden unter einem gehashten Eigentümernamen veröffentlicht, dem Hex der ersten 28 Oktette des SHA-256 des Local-Part. Der Hash verbirgt die Adresse nicht: In einer mitNSECsignierten Zone lassen sich die Eigentümernamen durch Abgehen der Zone auflisten, unterNSEC3lassen sie sich durch einen Offline-Wörterbuchangriff wiedergewinnen, und so oder so verwandelt eine Tabelle gängiger Local-Parts sie zurück in Adressen. Die Ausgabe sagt das in einem Kommentar: Online-Signieren mit minimal abdeckenden Einträgen (RFC 4470/7129) widersteht dem Abgehen, und eine Adressliste, die privat bleiben muss, wird nur per WKD veröffentlicht.Ein
OPENPGPKEY-Eintrag trägt den Schlüssel ohne Zertifizierungen Dritter, auch wenn die gespeicherte Identität mit solchen importiert wurde.Veröffentlichen Sie diese nur in einer DNSSEC-signierten Zone, was die Ausgabe als Kommentar wiederholt: Ein unsignierter Schlüsseleintrag ist ein Schlüssel von wem auch immer für die Zone antworten kann, was keine Verbesserung gegenüber überhaupt keinem Schlüssel ist.
Der DNS-Eigentümernamen-Hash ist groß-/kleinschreibungsempfindlich (RFC 7929 §3), anders als der Web-Key-Directory-Hash desselben Local-Part, der kleinschreibt. Die beiden werden absichtlich von verschiedenen Funktionen berechnet.
pepsi-setup(1) gibt dieselben Einträge für jede veröffentlichte Identität als Teil seiner DNS-Ausgabe aus, gedeckelt auf eine lesbare Anzahl; dieser Befehl ist der Weg, in einer großen Installation an eine bestimmte Adresse zu kommen.
95.1.50.1.4.10. Managed-PKI-Befehle¶
Mit einer Managed PKI stellt eine kommerzielle Zertifizierungsstelle jedem Benutzer einer Domain ein S/MIME-Zertifikat aus, und niemand muss eine Zertifikatsanforderung von Hand zur CA und das Zertifikat zurück tragen. Pepsi bestellt über die DigiCert CertCentral Services API, standardmäßig das Produkt Secure Email for Employee (secure_email_sponsor). Ein solches Zertifikat ist sponsor-validiert: Es nennt die Person (Vorname und Nachname) und die Mail-Adresse, und die Organisation, der das CA-Konto gehört, bürgt für die Person und bezahlt das Zertifikat.
Pepsi erzeugt jeden Schlüssel selbst und schickt der CA nur eine Zertifikatsanforderung, sodass kein privater Schlüssel den Host verlässt. Bevor das zurückkommende Zertifikat installiert wird, muss es die Adresse nennen, E-Mail-Schutz erlauben, die Schlüsselverwendungen tragen, die die Bestellung braucht, und über den eigenen Schlüssel der Bestellung ausgestellt sein. Dann wird es eine gewöhnliche S/MIME-Identität (custody = local), und die Zwischenzertifikate der CA werden mit ihr gespeichert, sodass jede Signatur, die sie erstellt, sie mitträgt. Das Kapitel zur Schlüsselverwaltung im Handbuch beschreibt den ganzen Ablauf.
Jede verwaltete Domain hat eigene Einstellungen und ein eigenes CA-Konto, und für eine Domain wird nichts bestellt, bis sie eingeschaltet ist und ihre Zugangsdaten gespeichert sind. Die Einstellungen, die Benutzer und die Bestellungen liegen in der Datenbank (pepsi.mpki_domain, mpki_user und mpki_order); die Zugangsdaten sind eine Datei (Dateien). Jeder mpki-Befehl ist dem Betreiber vorbehalten (root oder pepsi-crypto), weil die Einstellungen entscheiden, was der Organisation in Rechnung gestellt wird und wessen Namen ein Zertifikat trägt. Die Befehle, die Einstellungen, Benutzer, Bestellungen, die Zugangsdaten oder die Hinweise ändern, werden im Audit-Log festgehalten (mpki.domain.set, mpki.credential.set, mpki.credential.remove, mpki.user.add, mpki.user.set, mpki.user.delete, mpki.user.import, mpki.order.release, mpki.order.retry, mpki.order.cancel, mpki.notice.read).
- mpki domain list [–json]
Eine Zeile je verwalteter Domain: ob sie eingeschaltet ist, ihr Aufnahmemodus und ihre Richtlinie für Header-Namen, das Erneuerungsfenster, ein oder zwei Zertifikate, der Schlüsselalgorithmus, das Tageslimit und ob ihre Zugangsdaten-Datei vorhanden ist.
- mpki domain show DOMAIN [–json]
Jede Einstellung einer Domain, der Pfad ihrer Zugangsdaten-Datei und ob diese Datei existiert, und wer die Einstellungen zuletzt geändert hat.
- mpki domain set DOMAIN [OPTIONS]
Legt die Einstellungen einer Domain an oder ändert sie. Eine weggelassene Option behält ihren aktuellen Wert, bei einer neuen Domain ihren Standardwert. Eine neue Domain beginnt ausgeschaltet. Wenn der Befehl eine Domain einschaltet, die noch keine Zugangsdaten hat, weist er darauf hin.
- –enable, –disable
Schaltet die Managed PKI der Domain ein oder aus (standardmäßig aus). Solange eine Domain ausgeschaltet ist, wird für sie nichts bestellt, erneuert oder widerrufen. Das gilt auch für die Zertifikate von Benutzern, die in der Zwischenzeit gelöscht oder abgewählt werden: Sie werden widerrufen, sobald die Domain wieder eingeschaltet ist.
- –api-url URL
Die Basis-URL der API der CA, standardmäßig
https://www.digicert.com/services/v2. Sie muss mithttps://beginnen; einfacheshttp://wird nur fürlocalhostund127.0.0.1akzeptiert, für einen Ersatzdienst bei Tests.- –organization-id ID, –any-organization
Die ID, unter der die CA die validierte Organisation führt, die für die Zertifikate bürgt. Ohne sie (Standard, oder nach –any-organization) wird die einzige aktive Organisation des Kontos verwendet, und ein Konto mit mehreren Organisationen lehnt die Bestellung ab und listet sie auf.
- –product NAME
Der Produktname bei der CA. Standardwert
secure_email_sponsor.- –validity-years YEARS
Die zu bestellende Laufzeit, 1 bis 3 Jahre (Standardwert 1). Das Produkt akzeptiert womöglich weniger.
- –enrolment MODE
Wer ein Zertifikat erhält.
first-send(Standardwert): ein Benutzer, sobald er Mail über Pepsi gesendet hat.all: jeder Benutzer in der Liste.manual: nur die Benutzer, die ein Administrator auswählt (--select yes). In jedem Modus erhält ein Benutzer, dessen Auswahlnoist, keines.- –header-names POLICY
Was mit einem Namen geschieht, den Pepsi aus dem Anzeigenamen der ersten Nachricht eines Benutzers übernommen hat.
approve(Standardwert): Die Bestellung wartet, bis ein Administrator den Namen bestätigt.trust: Das Zertifikat wird sofort bestellt. Ein Anzeigename ist, was auch immer der Absender eingetippt hat, und die Organisation bürgt für den Namen, den das Zertifikat trägt; ändern Sie dies daher nur dort, wo ein Administrator den Anzeigenamen jedes Absenders festlegt.- –renew-days DAYS
Bestellt den Ersatz so viele Tage vor dem Ablauf des aktuellen Zertifikats, 1 bis 365. Standardwert 90.
- –certificates N
one(Standardwert): ein Zertifikat zum Signieren und Verschlüsseln.two: ein Signier- und ein Verschlüsselungszertifikat, getrennt bestellt. Ein einziges Zertifikat braucht einen RSA-Schlüssel.- –key-algorithm ALG
Der für jede Bestellung erzeugte Schlüssel:
rsa2048,rsa3072(Standardwert),rsa4096,p256oderp384. Die elliptischen Kurven brauchen--certificates two.- –daily-limit N
Höchstens so viele neue Aufnahmen der Domain gehen in einem Zeitraum von 24 Stunden an die CA (Standardwert 20). Eine Bestellung darüber hinaus wird zurückgehalten (
daily-limit), und ein Administrator wird benachrichtigt;0hält jede neue Aufnahme zurück. Erneuerungen zählen nicht und werden vom Limit nie zurückgehalten.- –notify ADDRESS, –no-notify
Schickt die Hinweise der Domain per Mail an ADDRESS oder hört damit auf (Standard: Die Hinweise werden nur von mpki notices aufgelistet). Die Mail braucht außerdem
[pepsi-mpki] NOTIFY_STAGE(Managed-PKI-Konfiguration).
- mpki domain check DOMAIN [–json]
Fragt die CA, ob die Domain bestellen kann, und bestellt nichts: ob die Zugangsdaten angenommen werden, ob das Produkt verfügbar ist, welche Organisation für die Zertifikate bürgt und ob die Domain im Konto aufgeführt und validiert ist (die CA validiert die Domain jeder Bestellung). Jedes Problem wird auf einer eigenen Zeile ausgegeben, und der Befehl endet mit Status 1, wenn es eines gibt.
- mpki credential set DOMAIN [–file FILE]
Speichert den API-Schlüssel der Domain, gelesen aus FILE oder von der Standardeingabe, was ihn aus der Shell-History und der Prozessliste heraushält. Er muss ein einzelnes Wort sein: der CertCentral-API-Schlüssel, den Pepsi im Header
X-DC-DEVKEYsendet. Der Schlüssel wird nachmpki-DOMAIN.secretin[pepsi-mpki] CREDENTIAL_DIRgeschrieben, mit Modus0640, über eine temporäre Datei und ein Umbenennen; als root ausgeführt, übergibt der Befehl die Datei der Gruppepepsi-crypto.- mpki credential remove DOMAIN
Löscht die Zugangsdaten-Datei. Die wartenden Bestellungen der Domain werden dann zurückgehalten (
no-credential), bis wieder Zugangsdaten gespeichert sind.- mpki user list [–domain DOMAIN] [–deleted] [–json]
Eine Zeile je Benutzer: die Adresse, der Name, woher der Name stammt (
header,ldapoderlocal; ein?dahinter bedeutet, dass noch niemand den Namen bestätigt hat), die Auswahl,wanted, wenn der Benutzer ein Zertifikat haben soll, und die neueste Bestellung mit ihrem Zustand und, bei einer zurückgehaltenen Bestellung, dem Grund. –deleted nimmt gelöschte Benutzer mit auf; –json gibt jeden Benutzer mit seinen fünf neuesten Bestellungen aus.- mpki user add ADDRESS –given-name NAME –surname NAME [–select SELECTION]
Legt einen Benutzer unter einem Namen an, für den der Administrator bürgt (Quelle
local, bestätigt), oder holt einen gelöschten Benutzer zurück. SELECTION istdefault(der Aufnahmemodus der Domain entscheidet),yes(immer aufgenommen, auch im Modusmanual) oderno(abgewählt). Ein bestehender Benutzer behält seine Auswahl, sofern –select keine andere nennt. Die Domain der Adresse muss zuerst konfiguriert sein (mpki domain set).- mpki user set ADDRESS [–given-name NAME] [–surname NAME] [–confirm] [–select SELECTION]
Ändert einen Benutzer. Ein neuer Vorname oder Nachname bestätigt den Namen, da der Administrator, der ihn eingetippt hat, für ihn bürgt; –confirm gibt den Namen so frei, wie er ist. Beides gibt beim nächsten Lauf eine Bestellung frei, die auf den Namen wartet. Ein bereits installiertes Zertifikat behält den alten Namen, bis es erneuert wird. –select no wählt den Benutzer ab: Der nächste Lauf storniert seine wartenden Bestellungen und widerruft seine installierten Zertifikate, hier und bei der CA.
- mpki user delete ADDRESS
Löscht einen Benutzer. Der nächste Lauf widerruft seine Zertifikate. Seine nächste Nachricht legt ihn nicht wieder an; nur mpki user add holt ihn zurück. Der Datensatz bleibt erhalten, als gelöscht markiert.
- mpki user import FILE –ldif | –csv [OPTIONS]
Legt Benutzer aus einem Verzeichnisexport an oder aktualisiert sie;
-liest die Standardeingabe. Es gibt keine LDAP-Verbindung: Ein Verzeichnis erreicht Pepsi als Datei, etwa als Ausgabe vonldapsearch -LLL … mail givenName sn.–ldif liest LDIF-Inhaltsdatensätze (RFC 2849) mit einfachen und base64-Werten, gefalteten Zeilen und Kommentaren. Die Namen stammen aus
givenNameundsnoder, wo eines der beiden fehlt, auscn, aufgeteilt wie ein Anzeigename. Ein Eintrag mit mehreren Mail-Werten ergibt einen Benutzer je Adresse. Ein Name aus dem Verzeichnis gilt als bestätigt (Quelleldap).–csv liest ein
address,given name,surnameje Zeile. Felder dürfen in doppelte Anführungszeichen gesetzt sein (""steht für ein Anführungszeichen), Leerzeilen und Zeilen, die mit#beginnen, werden übersprungen, und eine erste Zeile, deren erstes Feld kein@enthält, gilt als Kopfzeile. Die Namen gelten als von einem Administrator eingegeben (Quellelocal).Der Import ändert nie die Auswahl eines Benutzers, und er holt nie einen Benutzer zurück, den ein Administrator gelöscht hat; er meldet beides. Ein bekannter Benutzer, dessen Name abweicht oder noch nicht bestätigt ist, erhält den Namen aus der Datei, und zwar bestätigt. Adressen außerhalb der verwalteten Domains werden gemeldet und übersprungen. Ein Datensatz ohne vollständigen Namen legt einen Benutzer an, dessen Bestellung auf einen Namen wartet (
name-missing).- –domain DOMAIN
Importiert nur die Adressen von DOMAIN.
- –mail-attribute ATTR, –given-name-attribute ATTR, –surname-attribute ATTR
Die LDIF-Attribute, die die Adressen, den Vornamen und den Nachnamen enthalten. Standardwerte
mail,givenNameundsn.- –prune
Löscht außerdem die Benutzer von –domain, die aus einem Verzeichnisimport stammen (Quelle
ldap) und die die Datei nicht mehr aufführt, wodurch ihre Zertifikate widerrufen werden. Braucht –domain und –ldif. Der Befehl listet diese Benutzer auf und fragt zuerst nach; –yes überspringt die Frage, und ohne Terminal und ohne –yes wird überhaupt nichts importiert.- –dry-run
Gibt aus, was sich ändern würde, und ändert nichts.
- –json
Gibt den Plan und die Zählungen als JSON aus.
Die Ausgabe hat eine Zeile je Adresse, die sich ändert:
add,update(mit dem alten Namen),skip(hier gelöscht, außerhalb der verwalteten Domains oder keine Mail-Adresse) unddelete, danach die Zählungen.- mpki order list [–domain DOMAIN] [–address ADDRESS] [–open] [–limit N] [–json]
Bestellungen, die neueste zuerst, höchstens N (Standardwert 50): die ID, wann sie angelegt wurde, die Adresse, die Art (
new,renewoderrevoke), der Zweck (sign,encryptoderboth), der Zustand, der Grund einer Zurückhaltung, die Bestell-ID der CA und der letzte Fehler. Eine Bestellung istqueued(wartet darauf, eingereicht zu werden),held(wartet auf einen Administrator oder darauf, dass ihre Ursache verschwindet),submitted(die CA hat sie),issued(heruntergeladen, wird installiert),installedoderrevoked(erledigt),failed(aufgegeben, mit dem Grund) odercancelled. –open listet nur die Bestellungen auf, die noch laufen: queued, held, submitted und issued.- mpki order release ORDER-ID
Lässt eine zurückgehaltene Bestellung weiterlaufen; der nächste Lauf reicht sie ein. So kommt eine Bestellung über das Tageslimit hinweg (
daily-limit), und so geht sie weiter, nachdem dem CA-Konto eine Lizenz hinzugefügt wurde (no-licence): Diese beiden Zurückhaltungen warten auf einen Administrator. Die Zurückhaltungen, die der Lauf von selbst aufhebt (name-missing,name-unconfirmed,no-credential), kommen sofort wieder, solange ihre Ursache besteht.- mpki order retry ORDER-ID
Versucht eine fehlgeschlagene Bestellung beim nächsten Lauf erneut, ohne einen Tag auf die Ersatzbestellung zu warten. Eine Bestellung, die die CA hat und deren Schlüssel noch gespeichert ist, wird bei der CA erneut verfolgt. Andernfalls wird die Bestellung neu eingereicht, als neue Bestellung bei der CA über einen neuen Schlüssel; das ist der übliche Fall, da eine fehlgeschlagene Bestellung ihren Schlüssel aufgibt. Ein fehlgeschlagener Widerruf wird erneut gesendet.
- mpki order cancel ORDER-ID
Verwirft eine Bestellung im Zustand queued, held, submitted oder failed, und verwirft ihren Schlüssel. Eine Bestellung, die die CA schon erreicht hatte, wird nur hier storniert, und der Befehl weist darauf hin, sie auch im Portal der CA zu stornieren. Solange der Benutzer noch ein Zertifikat haben soll, legt der nächste Lauf eine neue Bestellung an; um endgültig aufzuhören, wählen Sie den Benutzer ab (mpki user set ADDRESS –select no). Ein installiertes Zertifikat wird nicht storniert, sondern widerrufen, durch dieselbe Abwahl.
- mpki notices [–domain DOMAIN] [–unread] [–read ID… | –read-all] [–json]
Die Hinweise für Administratoren, die neuesten zuerst (höchstens 200): die Zeit, der Schweregrad und ein Satz, markiert mit
[unread], bis jemand ihn liest. Ein Hinweis wird geschrieben, wenn eine Bestellung eingereicht, installiert, zurückgehalten (mit dem Grund und dem, was zu tun ist) oder zum dritten Mal wiederholt wird, wenn sie fehlschlägt oder widerrufen wird, und wenn ein Widerruf bei der CA auf Genehmigung wartet. –read markiert die angegebenen Hinweise als gelesen und –read-all jeden ungelesenen (von –domain, wenn angegeben); ein als gelesen markierter Hinweis ist für jeden Administrator gelesen, auch auf der Seite Hinweise der Konsole (siehe pepsi-httpd(1)).- mpki run [–domain DOMAIN] [–json]
Ein Durchlauf über jede eingeschaltete Domain oder nur über –domain. Das führt
pepsi-keys-mpki.timeralle fünf Minuten aus. Auf einem Host ohne eingeschaltete Domain ist der Durchlauf eine einzige Abfrage. Ein Durchlauf hat vier Schritte:Planen. Jeder Benutzer, der ein Zertifikat haben soll und kein aktuelles hat, erhält für jeden Zweck eine
new-Bestellung; ein Zertifikat, das innerhalb des Erneuerungsfensters abläuft, erhält einerenew-Bestellung. Eine Bestellung desselben Benutzers und Zwecks, die in den letzten 24 Stunden fehlgeschlagen ist, hält die nächste zurück, sodass ein Fehlschlag einmal am Tag erneut versucht wird. Eine neue Bestellung wird gleich zurückgehalten angelegt, wenn der Name fehlt oder unbestätigt ist oder das Tageslimit erreicht ist, und ein Hinweis sagt, warum. Bei einem Benutzer, der gelöscht oder abgewählt wird, werden die wartenden Bestellungen storniert und die installierten Zertifikate widerrufen: hier sofort und bei der CA durch einerevoke-Bestellung. Ein Benutzer, der lediglich nicht mehr ausgewählt ist (im Modusmanualoderfirst-send), behält sein Zertifikat, bis es abläuft, und es wird nicht erneuert.Freigeben der zurückgehaltenen Bestellungen, deren Ursache verschwunden ist: ein Name, der jetzt vollständig und bestätigt ist, oder Zugangsdaten, die jetzt existieren.
Abarbeiten jeder fälligen Bestellung. Bei einer wartenden Bestellung wird der Schlüssel erzeugt, verpackt im Datensatz der Bestellung gespeichert und dann die Anforderung gesendet; die Bestellung trägt
pepsi-ORDER-ID als Referenz im Portal der CA. Nach einer eingereichten Bestellung wird die CA anfangs jede Minute gefragt, dann immer seltener bis zu einmal pro Stunde. Ein ausgestelltes Zertifikat wird mit seiner Kette heruntergeladen, geprüft und installiert; die Identitäten, die es ersetzt (ein selbstsigniertes Zertifikat, das Zertifikat, das eine Erneuerung ersetzt), werden so ausgemustert, wie eine Schlüsselrotation sie ausmustert, sodass bereits an sie verschlüsselte Mail sich weiterhin öffnen lässt. Die wartenden Widerrufe werden gesendet.Versenden der Hinweise des Durchlaufs an die Benachrichtigungsadresse jeder Domain.
Ein Fehlschlag einer Bestellung hält den Durchlauf nicht auf. Ein vorübergehender Fehler (das Netz, eine Zeitüberschreitung, ein Serverfehler bei der CA) bei einer Bestellung, die die CA noch nicht hat, wird nach 5 Minuten wiederholt, mit Verdopplung bis 6 Stunden, und beim dritten Versuch mit einem Hinweis; nach 40 Versuchen, etwa einer Woche, schlägt die Bestellung fehl. Eine Ablehnung durch die CA lässt eine solche Bestellung sofort fehlschlagen, und ein Konto ohne freie Lizenz für die Adresse hält sie zurück (
no-licence). Eine fehlgeschlagene Bestellung wird einen Tag später durch eine neue ersetzt oder nach mpki order retry beim nächsten Lauf erneut versucht. Eine Bestellung, die die CA bereits hat, wird nie aufgegeben: Eine fehlgeschlagene Statusabfrage oder ein fehlgeschlagener Download, auch ein abgelehnter (zum Beispiel nach dem Ersetzen der Zugangsdaten), wird im Abstand von höchstens 40 Minuten wiederholt, und die Bestellung behält ihren Schlüssel. Nur der eigene Status der Bestellung bei der CA (abgelehnt, storniert, abgelaufen oder widerrufen) lässt sie fehlschlagen. Der Befehl gibt eine Zusammenfassung des Durchlaufs aus und endet mit Status 1, wenn ein Fehler aufgetreten ist. Durchläufe überschneiden sich nie: Ein Lauf, der startet, während ein anderer läuft, meldet das und tut nichts.
95.1.50.1.5. Keyserver-Konfiguration¶
Die Web-Key-Directory-Veröffentlichung braucht keine Konfiguration: Sie folgt dem published-Kennzeichen jeder Identität und wird von pepsi-httpd(1) bedient. Die Keyserver-Veröffentlichung schon, denn sie kann nicht rückgängig gemacht werden, und ihre Optionen leben in [pepsi-keys]:
VKS_PUBLISH(Standardwertno)Ob von Hand erstellte oder importierte Identitäten mit angefordertem Keyserver-Upload beginnen, sodass identity publish –retry sie hochlädt und es erneut versucht, bis die Adresse bestätigt ist. Ein Upload kann widerrufen, aber nie zurückgezogen werden, daher bleibt der Standardwert eine Entscheidung des Betreibers. Die Option steuert nicht den Wiederholungsjob und gilt nie für automatisch erzeugte oder registrierte Schlüssel; siehe Keyserver-Uploads werden je Identität angefordert. Ist sie ausgeschaltet, bleibt identity publish –vks (oder die eigene Anforderung eines Benutzers über die Web-Konsole oder per E-Mail) verfügbar.
VKS_SERVER(Standardwert: der erste[pepsi-keydiscovery] VKS_SERVERS-Eintrag)Wohin Uploads gehen; nur
https://. Ein Server, keine Liste: Denselben Schlüssel bei mehreren zu veröffentlichen vervielfacht eine unumkehrbare Handlung, und jeder muss dann mit Widerrufen aktuell gehalten werden.VKS_MAX_ATTEMPTS(Standardwert 5),VKS_RETRY_INTERVAL(Standardwert6 h),VKS_BATCH(Standardwert 50)Wie hartnäckig, wie oft und wie viele auf einmal identity publish –retry es versucht. Beachten Sie, dass Zeitdauern Kalendereinheiten ablehnen:
6 hparst,1 dnicht.
95.1.50.1.6. Managed-PKI-Konfiguration¶
Die Einstellungen je Domain liegen in der Datenbank (mpki domain set). Was die mpki-Befehle aus der Konfigurationsdatei lesen, steht in [pepsi-mpki], beschrieben in pepsi.conf(5); jede Option hat einen Standardwert:
CREDENTIAL_DIR(Standardwert:secrets.dneben der Konfigurationsdatei)Wo die Dateien
mpki-DOMAIN.secretliegen.TIMEOUT(Standardwert60 s)Die Frist einer einzelnen Anfrage an die CA.
NOTIFY_STAGE(Standardwert: keiner)Die Stage, an der Hinweismail in die Pipeline eintritt, zum Beispiel die Stage, die ausgehende Mail per DKIM signiert. Ohne sie wird kein Hinweis per Mail verschickt.
NOTIFY_FROM(Standardwertpostmaster@DOMAIN)Das
From:einer Hinweismail.
95.1.50.1.7. 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. Für unprivilegierte Aufrufer abgelehnt, wenn dieses Programm setuid installiert ist: Die Konfiguration benennt die Datenbankverbindung, jeden
${…}-expandierten Pfad und den Schlüsselverschlüsselungsschlüssel selbst.- -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.50.1.8. Exit-Status¶
- 0
Erfolgreicher Abschluss. Ein zerstörerischer Befehl, der an seiner Bestätigungsabfrage abgelehnt wurde, endet ebenfalls mit 0, ohne etwas geändert zu haben.
- 1
Ein Fehler ist aufgetreten: eine fehlerhafte Konfigurationsdatei, eine unzulässige Optionskombination, eine Adresse, die zum Konto eines anderen Benutzers auflöst, nicht parsbares Schlüsselmaterial, ein Schlüsselverschlüsselungsschlüssel, der fehlt oder einen Datensatz nicht öffnet, oder eine gescheiterte Datenbankverbindung oder -abfrage. Der Grund wird in das Journal geschrieben.
- 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.50.1.9. Dateien¶
Wenn –config nicht angegeben ist, wird die erste vorhandene Datei aus der folgenden Liste verwendet:
$XDG_CONFIG_HOME/pepsi.conf$HOME/.config/pepsi.conf/etc/pepsi/pepsi.conf/etc/pepsi.conf
secrets.d/pepsi-crypto.secretDer Schlüsselverschlüsselungsschlüssel, neben der Konfigurationsdatei und mit einer
@inline-secret@-Direktive in den[pepsi-crypto]-Abschnitt gezogen. Er wird aus der weltlesbaren Konfiguration herausgehalten, weil er das eine Geheimnis ist, das jeden gespeicherten privaten Schlüssel öffnet; pepsi-setup(1) gibt ihm bei jedem Lauf Modus0640und übergibt ihn dempepsi-crypto-Konto. Sichern Sie ihn separat — siehe das Kapitel Schlüsselverwaltung des Handbuchs für die Kosten seines Verlusts./run/pepsi-vmgenid-changedWird von Pepsis udev-Regel berührt, wenn sich die Generations-ID der virtuellen Maschine ändert (ein Klon oder eine Wiederherstellung aus einem Snapshot). identity generate, otp enroll und wrap rotate schauen nur auf ihre Zeit: Innerhalb von zehn Minuten nach einer Änderung protokollieren sie eine Warnung, die nennt, was sie erzeugen, da ein Prozess, der vor dem Snapshot lief, Zufallszahlen wiederholen kann. Siehe das Kapitel Operations des Handbuchs, Cloned and restored virtual machines.
secrets.d/mpki-DOMAIN.secretDer API-Schlüssel des CA-Kontos einer verwalteten Domain, eine Datei je Domain, in
[pepsi-mpki] CREDENTIAL_DIR. Die erste Zeile, die weder leer noch ein#-Kommentar ist, ist der Schlüssel. mpki credential set schreibt die Datei mit Modus0640und Gruppepepsi-crypto; nur pepsi-keys liest sie, und der Schlüssel geht nirgendwohin außer zur CA. Wer die Datei hat, kann Zertifikate bestellen, die die Organisation bezahlt, und sie widerrufen. Sichern Sie sie zusammen mit dem Rest vonsecrets.d.
Keine andere Datei wird gelesen oder geschrieben: Alles Schlüsselmaterial lebt in der Datenbank.
95.1.50.1.10. Beispiele¶
Die bedienten Adressen finden, deren Verschlüsselung von einem Schlüssel bestimmt wird, den jemand anderes geliefert hat, und einen bestätigten zum eigenen Schlüssel des Benutzers machen (ein MUA-Schlüssel: kein –private):
pepsi-keys -c /etc/pepsi/pepsi.conf peer unclaimed
pepsi-keys -c /etc/pepsi/pepsi.conf peer show bob@example.org
gpg --export bob@example.org > bob.pgp # the key bob confirmed to you
pepsi-keys -c /etc/pepsi/pepsi.conf identity import bob@example.org \
--protocol openpgp --purpose both --public bob.pgp
Eine OpenPGP-Identität erzeugen und prüfen, dass GnuPG die öffentliche Hälfte annimmt:
pepsi-keys -c /etc/pepsi/pepsi.conf identity generate alice@example.org \
--protocol openpgp --name 'Alice Example'
pepsi-keys -c /etc/pepsi/pepsi.conf identity list --address alice@example.org
pepsi-keys -c /etc/pepsi/pepsi.conf identity export 1 | gpg --import
Das S/MIME-Paar erzeugen und über jeden Schlüssel eine Zertifikatsanforderung für eine echte CA ausgeben:
pepsi-keys -c /etc/pepsi/pepsi.conf identity generate alice@example.org \
--protocol smime --csr
Das von jener CA ausgestellte Zertifikat über den bereits im Speicher liegenden Schlüssel installieren:
pepsi-keys -c /etc/pepsi/pepsi.conf identity import alice@example.org \
--protocol smime --purpose sign --public /tmp/alice-sign.pem --primary
Die Adresse im DNS veröffentlichen (nur signierte Zone):
pepsi-keys -c /etc/pepsi/pepsi.conf dns alice@example.org >> example.org.zone
Einen kompromittierten Signierschlüssel zurückziehen und dann bestätigen, dass die private Hälfte weg ist:
pepsi-keys -c /etc/pepsi/pepsi.conf identity revoke 1 --reason 'laptop stolen'
pepsi-keys -c /etc/pepsi/pepsi.conf identity show 1
Dem Schlüssel eines Korrespondenten von Hand vertrauen und ihn gegen spätere Entdeckung pinnen:
pepsi-keys -c /etc/pepsi/pepsi.conf peer import bob@example.com \
--protocol openpgp --file bob.pgp --pin
Einen Korrespondenten mit jeder aktivierten Methode nachschlagen und das Ergebnis speichern:
pepsi-keys -c /etc/pepsi/pepsi.conf peer refresh --address bob@example.com
Den Cache aus einem periodischen Timer ehrlich halten: neu validieren, was fällig ist, dann verwerfen, was veraltet ist:
pepsi-keys -c /etc/pepsi/pepsi.conf peer refresh
pepsi-keys -c /etc/pepsi/pepsi.conf peer prune
pepsi-keys -c /etc/pepsi/pepsi.conf peer screen
Sehen, wie aktuell die Liste kompromittierter Schlüssel ist, und eine Quellliste außer Dienst nehmen (sollten sich ihre Einträge als falsch erweisen):
pepsi-keys -c /etc/pepsi/pepsi.conf blocklist status
pepsi-keys -c /etc/pepsi/pepsi.conf blocklist dismiss --list forti
Einen S/MIME-Vertrauensanker hinzufügen und sehen, wem vertraut wird:
pepsi-keys -c /etc/pepsi/pepsi.conf ca add /etc/ssl/certs/our-ca.pem --label 'Our CA'
pepsi-keys -c /etc/pepsi/pepsi.conf ca list
Der CA eines Partners nur für die eigene Domain des Partners vertrauen:
pepsi-keys -c /etc/pepsi/pepsi.conf ca add partner-ca.pem --label Partner --domain partner.example
pepsi-keys -c /etc/pepsi/pepsi.conf ca scope 2 --domain partner.example --domain partner.example.net
Sehen, was das Forward-Secrecy-Profil heute rotieren und vernichten würde:
pepsi-keys -c /etc/pepsi/pepsi.conf identity rotate-due --dry-run
Den Schlüsselverschlüsselungsschlüssel rotieren, zuerst nachsehend:
pepsi-keys -c /etc/pepsi/pepsi.conf wrap rotate --dry-run
pepsi-keys -c /etc/pepsi/pepsi.conf wrap rotate
Alles ausmustern, was seine Gültigkeit überschritten hat (aus einem periodischen Timer):
pepsi-keys -c /etc/pepsi/pepsi.conf identity retire
Einen Schlüssel beim Keyserver veröffentlichen und dann prüfen, dass er ankam:
pepsi-keys -c /etc/pepsi/pepsi.conf identity publish 1 --vks
pepsi-keys -c /etc/pepsi/pepsi.conf identity show 1
Jede ausstehende Keyserver-Verifikation zum Abschluss bringen (was der stündliche Timer ausführt):
pepsi-keys -c /etc/pepsi/pepsi.conf identity publish --retry
Aufhören, einen Schlüssel zu veröffentlichen, und der Welt sagen, dass der hochgeladene tot ist:
pepsi-keys -c /etc/pepsi/pepsi.conf identity unpublish 1
pepsi-keys -c /etc/pepsi/pepsi.conf identity revoke 1 --upload \
--reason 'address closed'
Eine Managed PKI für eine Domain einrichten: sie konfigurieren, den API-Schlüssel des CA-Kontos von der Standardeingabe speichern und die CA fragen, ob die Domain bestellen kann:
pepsi-keys -c /etc/pepsi/pepsi.conf mpki domain set example.org \
--enable --notify it@example.org
pepsi-keys -c /etc/pepsi/pepsi.conf mpki credential set example.org < api-key.txt
pepsi-keys -c /etc/pepsi/pepsi.conf mpki domain check example.org
Die Benutzer aus dem Verzeichnis importieren, zuerst nachsehend:
ldapsearch -LLL -H ldap://ldap.example.org -b ou=people,dc=example,dc=org \
'(mail=*@example.org)' mail givenName sn > people.ldif
pepsi-keys -c /etc/pepsi/pepsi.conf mpki user import people.ldif --ldif \
--domain example.org --dry-run
pepsi-keys -c /etc/pepsi/pepsi.conf mpki user import people.ldif --ldif \
--domain example.org
Einen Namen freigeben, der aus der ersten Nachricht eines Benutzers übernommen wurde, dann einen Durchlauf starten, statt auf den Timer zu warten:
pepsi-keys -c /etc/pepsi/pepsi.conf mpki user list --domain example.org
pepsi-keys -c /etc/pepsi/pepsi.conf mpki user set alice@example.org --confirm
pepsi-keys -c /etc/pepsi/pepsi.conf mpki run --domain example.org
Einen Namen in einem Schritt korrigieren und freigeben, oder eine Rollenadresse abwählen, die sich selbst angelegt hat:
pepsi-keys -c /etc/pepsi/pepsi.conf mpki user set bob@example.org \
--given-name Robert --surname Example
pepsi-keys -c /etc/pepsi/pepsi.conf mpki user set noreply@example.org --select no
Nachsehen, was wartet, und eine vom Tageslimit zurückgehaltene Bestellung weiterlaufen lassen:
pepsi-keys -c /etc/pepsi/pepsi.conf mpki notices --unread
pepsi-keys -c /etc/pepsi/pepsi.conf mpki order list --open
pepsi-keys -c /etc/pepsi/pepsi.conf mpki order release 17
95.1.50.1.11. Siehe auch¶
pepsi-keydisc(1), pepsi-httpd(1), pepsi-stage-vks-confirm(1), pepsi-setup(1), pepsi-config(1), pepsi-whitelist(1), pepsi-settings(1), pepsi.conf(5), pepsi.state(7)
Das Kapitel Security des Handbuchs legt die Mechanismen dar, auf die sich dieses Programm stützt (The private-key custody boundary, A second factor for key management, What an S/MIME trust anchor vouches for, Which S/MIME container a correspondent gets, A correspondent’s key changing, Certificates from a commercial CA); sein Kapitel Threat model legt dar, was sie versprechen (End-to-end encryption: two custody modes, Keys of correspondents, Somebody holding a copy of the database).
95.1.50.1.12. Fehler¶
Melden Sie Fehler an den Pepsi-Issue-Tracker.