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 (client pour la propre clé MUA de l’utilisateur, dont la moitié privée réside dans son client de messagerie), et, dans show, la garde, s’il s’agit de la face publique de l’adresse et son état sur le serveur de clés. list --served ajoute ce que le Web Key Directory et les enregistrements OPENPGPKEY/SMIMEA servent 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 --private est enregistrée comme la propre clé MUA de l’utilisateur), réécrire du matériel dans sa forme binaire propre (--pem pour 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 retire détruisent le matériel privé de signature et conservent le matériel de déchiffrement ; revoke signe 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 (--upload l’envoie à un serveur qui ne l’a jamais eue). forget-private est la manière explicite et confirmée (-y pour 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 fois RETIRED_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 (publish peut 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. refresh revalide 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. prune supprime les clés expirées et les demandes de découverte périmées (--dry-run pour regarder d’abord). show applique la règle de correspondance (une adresse exacte l’emporte toujours sur un repli *@domain saisi à la main). import stocke une clé avec la source manual, la seule source autorisée à nommer un domaine entier ; pour une clé *@domain qui ne nomme aucune adresse, il note qu’une signature faite avec cette clé est rapportée valid pour tout From: du domaine. import fusionne 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.timer exécute refresh, prune et screen chaque 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’audit error), 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_URL si 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. status indique quand la liste a été vérifiée pour la dernière fois ; dismiss met 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_URL et remplace le fichier de façon atomique, en refusant une liste plus ancienne que celle en place sauf avec --force ; status indique 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”EnvelopedData CBC. 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 (scope limite les domaines de messagerie dont une ancre se porte garante). Un certificat sans basicConstraints CA:TRUE est refusé, puisqu’aucune chaîne ne pourrait jamais s’y terminer. Être accepté ici n’est pas la même chose qu’être utilisable : les nameConstraints, pathLenConstraint et 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-run pour regarder d’abord ; il ré-enveloppe aussi une clé au format 0x01, 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 CODE pour chaque modification des identités de cette adresse ainsi que pour export --private et csr ; 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) et SMIMEA (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. domain contient les réglages de chaque domaine, credential la clé d’API de son compte d’AC (un fichier secrets.d), user les personnes et les noms que portent leurs certificats (import lit un export LDIF ou CSV d’un annuaire), order et notices ce 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).