76. pepsi-keys¶
Gérer le magasin de clés de bout en bout.
76.1. Rôle¶
pepsi-keys est l’outil de l’opérateur pour le magasin des clés que Pepsi utilise pour la cryptographie de bout en bout : pepsi.crypto_identity (les paires de clés des adresses que nous servons, moitié privée comprise et enveloppée au repos), pepsi.peer_key (les clés publiques et certificats mis en cache des correspondants distants) et pepsi.ca_trust (les certificats d’AC contre lesquels les chaînes S/MIME entrantes sont validées). Il se connecte via la section partagée [pepsi-postgres] et lit les options CRYPTO_* de [pepsi] ainsi que la section [pepsi-crypto]. Ce n’est pas une étape. Référence : pepsi-keys(1) ; la conception est expliquée dans Gestion des clés.
C’est l’un des binaires autonomes, hors de l’exécutable pepsi unifié, pour deux raisons : c’est le seul programme qui engendre du matériel de clé (le plier dedans lierait la génération de clés et la délivrance de certificats dans chaque worker d’étape), et un site peut l’installer setuid pour que les utilisateurs gèrent leurs propres identités, or un binaire multi-appel partagé ne peut pas porter ce bit.
76.2. Fonctionnalités¶
identity list / show — quel matériel existe pour une adresse : protocole, usage, statut, s’il est le principal pour sa capacité, s’il est publié, si la moitié privée est présente, purgée ou n’a jamais été détenue (
clientpour la propre clé MUA de l’utilisateur, dont la moitié privée réside dans son client de messagerie), et, dansshow, la garde, s’il s’agit de la face publique de l’adresse et son état sur le serveur de clés.list --servedajoute ce que le Web Key Directory et les enregistrementsOPENPGPKEY/SMIMEAservent réellement pour chaque adresse listée, récupérés comme le ferait un correspondant, et signale une empreinte que le magasin ne publie pas (Vérifier ce qui est réellement servi).identity generate — créer du matériel de clé et le stocker. OpenPGP produit une clé transférable (Ed25519 par défaut, RSA en option) ; S/MIME produit un certificat de signature et un certificat de chiffrement, chacun auto-signé pour un usage immédiat, ou un seul certificat portant les deux usages de clé sous
CRYPTO_SMIME_SHARED_KEY.--csrémet en outre une demande PKCS#10 sur chaque clé, de sorte qu’une véritable AC puisse délivrer un remplacement sans changer de clé.identity import / export / csr — stocker du matériel engendré ailleurs (une clé publique OpenPGP importée sans
--privateest enregistrée comme la propre clé MUA de l’utilisateur), réécrire du matériel dans sa forme binaire propre (--pempour X.509), ou construire une demande de certificat sur la clé existante d’une identité.identity revoke / retire / forget-private — le cycle de vie. La révocation et le balayage périodique
retiredétruisent le matériel privé de signature et conservent le matériel de déchiffrement ;revokesigne d’abord un certificat de révocation tant que la clé privée existe encore, certificat que le Web Key Directory sert ensuite et qui part vers le serveur de clés dès lors que la clé y avait été téléversée (--uploadl’envoie à un serveur qui ne l’a jamais eue).forget-privateest la manière explicite et confirmée (-ypour sauter la question) de détruire une clé de déchiffrement.rotate-due(pepsi-keys-rotate.timer, quotidien) remplace chaque clé de chiffrement détenue par le serveur qui est plus ancienne que[pepsi-crypto] ENCRYPTION_ROTATION_DAYS. Il détruit aussi les moitiés privées retirées une foisRETIRED_PRIVATE_GRACE_DAYSécoulés, sauf si un message en file est encore chiffré vers elles.identity set-primary / publish / unpublish / delete — choisir le matériel utilisé pour les nouveaux messages, inscrire ou retirer une adresse de la publication (
publishpeut aussi téléverser vers un serveur de clés), ou supprimer purement et simplement une ligne.peer list / show / import / pin / unpin / refresh / prune / remove — les clés de pairs mises en cache.
refreshrevalide les clés qui existent déjà et n’en découvre jamais une pour une adresse qui n’en a aucune. Chaque clé n’est revérifiée que par la méthode par laquelle elle a été apprise (les clés moissonnées, issues du gossip ou saisies à la main ne sont jamais revérifiées par le réseau), de sorte que le serveur de clés n’entend parler que des correspondants dont il a fourni les clés.prunesupprime les clés expirées et les demandes de découverte périmées (--dry-runpour regarder d’abord).showapplique la règle de correspondance (une adresse exacte l’emporte toujours sur un repli*@domainsaisi à la main).importstocke une clé avec la sourcemanual, la seule source autorisée à nommer un domaine entier ; pour une clé*@domainqui ne nomme aucune adresse, il note qu’une signature faite avec cette clé est rapportéevalidpour toutFrom:du domaine.importfusionne aussi la clé avec une copie déjà stockée de la même clé (de sorte qu’un export plus ancien ne peut pas annuler une révocation), et il refuse une clé dont la moitié privée est connue.pepsi-keys-refresh.timerexécuterefresh,pruneetscreenchaque jour.peer unclaimed — lister les adresses servies qui n’ont pas d’identité chez nous mais dont le chiffrement est néanmoins décidé par une clé moissonnée ou issue du gossip, c’est-à-dire une clé qu’un inconnu aurait pu implanter avec un
From:falsifié. La sortie est une liste de travail à confirmer avec chaque propriétaire (Repérer les utilisateurs qui apportent leur propre clé).peer screen — trouver les clés stockées dont la moitié privée est connue : un PGCD par lots sur chaque module RSA en cache et sur les moitiés publiques de nos identités, plus la liste des clés connues comme compromises (
pepsi.compromised_key: badkeys, les clés faibles OpenSSL de Debian). Une clé de pair défaillante est supprimée, épinglée ou non, et un module factorisé est ajouté à cette liste, de sorte que chaque vérification de clé le refuse ; une identité défaillante qui nous est propre est signalée (sévérité d’auditerror), jamais modifiée.blocklist update / status / dismiss / restore — la liste des clés connues comme compromises dans la base de données.
update(pepsi-keys-blocklist.timer, quotidien) demande de façon conditionnelle à[pepsi-keydiscovery] BADKEYS_URLsi la liste badkeys a changé et n’ajoute que ce qui est nouveau ; rien n’est jamais retiré. Une liste comportant moins d’enregistrements que la précédente, ou qui ferait croître la table de plus d’un quart, est refusée sauf avec--force.statusindique quand la liste a été vérifiée pour la dernière fois ;dismissmet hors service les entrées d’une exécution ou d’une liste source sans laisser la mise à jour suivante les rajouter (voir « A known-compromised key is never stored » dans Gestion des clés).ct-logs update / status — la liste des journaux Certificate Transparency contre laquelle chaque client TLS vérifie les SCT des certificats de serveur (
[pepsi] CT_LOG_LIST, un fichier, non une table).update(pepsi-keys-ct-logs.timer, quotidien) récupère de façon conditionnelle[pepsi] CT_LOG_LIST_URLet remplace le fichier de façon atomique, en refusant une liste plus ancienne que celle en place sauf avec--force;statusindique l’âge de la liste.peer capability list / set / unset / forget — l’enregistrement des capacités S/MIME par correspondant (
pepsi.smime_capability) qui décide si un destinataire reçoit de l”AuthEnvelopedData(AES-256-GCM, également en l’absence d’enregistrement) ou de l”EnvelopedDataCBC. Les enregistrements sont appris de la signature vérifiée d’un correspondant par pepsi-stage-autocrypt-learn ou configurés par adresse ou par*@domain; un enregistrement configuré l’emporte (Quel conteneur S/MIME reçoit un correspondant).ca list / add / scope / accept-nameless / enable / disable / remove — les ancres de confiance S/MIME (
scopelimite les domaines de messagerie dont une ancre se porte garante). Un certificat sansbasicConstraints CA:TRUEest refusé, puisqu’aucune chaîne ne pourrait jamais s’y terminer. Être accepté ici n’est pas la même chose qu’être utilisable : lesnameConstraints,pathLenConstraintet contraintes de politique propres à une ancre lient toute chaîne qui passe par elle (RFC 5937), et une AC portant une extension critique que Pepsi ne sait pas traiter est ignorée lors de la construction du chemin (RFC 5280 §4.2).wrap rotate — ré-envelopper chaque clé privée stockée, et chaque secret de second facteur, sous une nouvelle clé de chiffrement de clés, de façon incrémentale et avec
--dry-runpour regarder d’abord ; il ré-enveloppe aussi une clé au format0x01, dont l’enveloppement ne lie pas l’empreinte de la clé.otp status / enroll / remove / reset — le second facteur TOTP par adresse. Une fois inscrit, un appelant non privilégié d’une installation setuid doit passer
identity --otp CODEpour chaque modification des identités de cette adresse ainsi que pourexport --privateetcsr; dix échecs consécutifs le verrouillent jusqu’à ce que l’opérateur le réinitialise (Un second facteur pour la gestion des clés). Avec--console LOGIN, l’opérateur inscrit, affiche ou réinitialise le second facteur d’un compte de la console, dont les connexions par mot de passe exigent alors aussi un code valide.dns — imprimer les enregistrements
OPENPGPKEY(RFC 7929) etSMIMEA(RFC 8162) qui publient une adresse, sous les noms de propriétaire hachés que définissent ces normes. Ces enregistrements ne valent la peine d’être publiés que dans une zone signée par DNSSEC, et la sortie le dit.mpki domain / credential / user / order / notices / run — la PKI gérée : des certificats S/MIME qu’une AC commerciale (DigiCert CertCentral) délivre pour les utilisateurs d’un domaine.
domaincontient les réglages de chaque domaine,credentialla clé d’API de son compte d’AC (un fichiersecrets.d),userles personnes et les noms que portent leurs certificats (importlit un export LDIF ou CSV d’un annuaire),orderetnoticesce qui est en cours et ce qui attend un administrateur.run(pepsi-keys-mpki.timer, toutes les cinq minutes) commande, installe, renouvelle et révoque ; la clé est toujours engendrée ici, et l’AC ne reçoit qu’une demande de certificat (Certificats d’une AC commerciale : la PKI gérée).
76.3. Modèle de privilèges¶
Atteindre une clé privée exige deux choses gardées indépendamment : le rôle de base de données pepsi-crypto et la clé de chiffrement de clés. Ce rôle est le seul à qui la colonne crypto_identity.private_wrapped est accordée ; tout autre rôle de service détient un droit au niveau colonne qui l’omet. La clé de chiffrement de clés ne réside que dans secrets.d/pepsi-crypto.secret. Une base de données volée ne livre que du chiffré ; le secret seul ne livre rien.
pepsi-keys n’endosse ce rôle que pour la durée de chaque appel à la base : lancé en tant que root, il devient le compte (root n’a pas de rôle de base propre) et revient ensuite. L’authentification par pair de PostgreSQL se fonde sur l”uid effectif, non sur le gid, de sorte qu’un bit setgid accorderait le groupe qui garde le fragment de secret mais pas l’identité en base.
Le binaire est livré sans bit setuid, contrairement à pepsi-whitelist : un programme capable d’ouvrir chaque clé privée d’un déploiement est une prise bien plus grosse qu’une simple table de liste blanche. Un site qui veut que ses utilisateurs gèrent leurs propres identités l’installe setuid pepsi-crypto ; les identités appartiennent au login passwd auquel leur adresse se résout, et un appelant non privilégié du binaire setuid ne peut voir et modifier que les siennes. Sans le bit, chaque appelant se connecte sous sa propre identité et seuls les droits de la base de données décident, de sorte que le rendre setuid est une décision de site plutôt qu’un changement de code. Une installation setuid descend vers l’utilisateur appelant avant toute autre chose, retire les variables d’environnement qui pilotent la découverte de la configuration et libpq, et refuse -c aux appelants non privilégiés, puisque la configuration nomme la clé de chiffrement des clés. Les clés de pairs et les ancres de confiance valent pour tout le déploiement et sont réservées à l’opérateur, listage compris.
Chaque opération sur les clés, et chaque lecture de matériel privé (identity export --private, identity csr), est consignée dans le journal d’audit partagé (pepsi.event_log), celui-là même qu’écrit l’API d’administration.
76.4. Voir aussi¶
Gestion des clés, La frontière de garde des clés privées, Un second facteur pour la gestion des clés, Garde par la passerelle (custody = local, la clé de MTA), Clés des correspondants, pepsi-keydisc, pepsi-setup, pepsi-whitelist, pepsi-settings, Architecture, pepsi-keys(1), pepsi.conf(5).