77. pepsi-keydisc

Trouver la clé publique ou le certificat d’un correspondant, et noter ce que vaut sa source.

77.1. Rôle

pepsi-keydisc est la couche de découverte de clés : à partir d’une adresse e-mail, il trouve la clé OpenPGP ou le certificat S/MIME du correspondant, note sa provenance et si la résolution a été validée par DNSSEC, et le met en cache dans pepsi.peer_key. Ce n’est pas une étape. Il se connecte via [pepsi-postgres] et se configure entièrement par [pepsi-keydiscovery].

La découverte est asynchrone et hors des étapes. Une étape qui a besoin d’une clé absente de son cache ne fait aucune E/S réseau : elle valide le travail déjà accompli, met le message en pause et met une demande en file dans pepsi.key_request ; une instance de découverte répond à la demande et, dans le même aller-retour qui stocke la clé, libère chaque message garé sur cette adresse. Ainsi aucun worker d’étape n’attend jamais un serveur de clés, cent messages vers un même correspondant coûtent une seule résolution, et une demande qui se conclut sans clé libère ses messages en attente tout autant. Les services trouvent les clés, et les étapes décident du courrier. Référence : pepsi-keydisc(1).

Le chapitre Gestion des clés explique le classement de confiance selon lequel ces résultats sont jugés, et comment la couche de découverte se rapporte au magasin de clés dans son ensemble.

77.2. Fonctionnalités

  • Un processus par méthode (pepsi-keydisc serve <method>), depuis le modèle systemd pepsi-keydisc@.service : @dane, @wkd-advanced, @wkd-direct, @vks et (dans un build avec la fonctionnalité Cargo ldap) @ldap. SOURCES prend par défaut les quatre premières, que pepsi.target démarre. Un bind LDAP bloqué ne peut pas paralyser WKD. Pour désactiver une méthode, exécutez systemctl mask --now pepsi-keydisc@vks et retirez la méthode de SOURCES (mask, parce que pepsi.target redémarre une instance simplement désactivée). Une instance dont la méthode est absente de [pepsi-keydiscovery] SOURCES refuse de démarrer, car la règle d’arrêt n’attend que les méthodes nommées par SOURCES.

  • Les deux méthodes WKD sont des rangs distincts : elles s’exécutent donc en instances distinctes et simultanées plutôt qu’en chaîne de repli. N’exécuter direct que « si advanced échoue » accepterait la réponse la plus faible chaque fois que la plus forte serait simplement lente.

  • DANE est conditionné par le bit AD. OPENPGPKEY (RFC 7929) et SMIMEA (RFC 8162) sont refusés d’emblée sans le bit AD DNSSEC du résolveur : une réponse DNS non validée n’est pas une réponse plus faible, c’est une absence de réponse. On se fie au bit AD sans le vérifier ; pepsi-keydisc@dane avertit donc au démarrage lorsqu’un résolveur de resolv.conf n’est pas sur la boucle locale ou ne positionne pas le bit AD sur une réponse de sonde signée.

  • Une récupération durcie pour WKD et VKS : HTTPS uniquement, validation de certificat sans mode non sécurisé, au plus une redirection HTTPS vers HTTPS et vers le même hôte, refus de se connecter aux adresses de boucle locale, privées ou lien-local, un plafond d’octets appliqué pendant le flux, une échéance à chaque étape, et conversion IDNA en A-label. Une clé renvoyée dont l’identifiant utilisateur ne nomme pas l’adresse interrogée est écartée (SSRF de la découverte de clés).

  • Quelles autorités de certification se portent garantes d’une réponse WKD ou d’un serveur de clés. [pepsi-keydiscovery] TLS_CA_BUNDLE remplace, pour ces récupérations, le magasin de racines du système par les certificats d’AC d’un unique fichier PEM (également pour le trafic vers les serveurs de clés de pepsi-keys et pepsi-stage-vks-confirm) ; un fichier illisible ou vide empêche l’instance de démarrer plutôt que de retomber sur les racines du système.

  • Une recherche qui échoue dans le DNS n’est pas « pas de clé ». Une requête OPENPGPKEY/SMIMEA échouée, ou un nom d’hôte WKD qui ne se résout pas, est classée en interrogeant aussi les enregistrements MX et A/AAAA du domaine : injoignable lorsque rien ne répond, transitoire lorsque seuls les enregistrements de clés échouent, et incohérente après trois tours de ce genre, chacun dans l’heure suivant le précédent. Le verdict est stocké sur la ligne key_request réglée, et pepsi-stage-encrypt retient ou réachemine le message au lieu de l’envoyer en clair (Une recherche de clé qui échoue dans le DNS).

  • Les clés dont la moitié privée est connue ne sont pas stockées. Une clé découverte qui figure sur la liste des clés connues comme compromises (pepsi.compromised_key : badkeys, les clés faibles OpenSSL de Debian, et ce que pepsi-keys peer screen a factorisé) ou dont le module RSA trahit ses facteurs premiers (ROCA, nombres premiers proches, un petit facteur) compte comme « pas de clé » pour cette méthode.

  • Les conflits sont tranchés côté serveur, et les certificats sont fusionnés. Lorsque la même empreinte est revue, la ligne est mise à jour sur place et les certificats sont fusionnés, de sorte qu’une révocation que porte la copie stockée survit à une copie plus ancienne ; une clé différente ne remplace la clé stockée que depuis une source strictement mieux classée, jamais une ligne épinglée (Clés des correspondants).

  • Le rafraîchissement n’interroge que la méthode qui a trouvé la clé. Le pepsi-keys peer refresh quotidien revérifie une clé vks auprès du serveur de clés, une clé WKD auprès de la même méthode WKD, une clé dane dans le DNS et une clé ldap dans l’annuaire, et seulement tant que cette méthode figure dans SOURCES ; les clés moissonnées, issues du gossip ou saisies à la main ne sont jamais rafraîchies par le réseau, de sorte que le serveur de clés n’apprend pas la liste complète des correspondants du déploiement.

  • Listes de révocation S/MIME. Sauf si CRL_FETCH = no, chaque instance récupère aussi dans pepsi.crl_cache les CRL que nomment les certificats de pairs S/MIME en cache dans leurs cRLDistributionPoints (http:///https://, au plus deux par certificat, sans redirections, CRL_MAX_BYTES). Sous CA_ISSUERS_FETCH, elle récupère aussi les CRL que nomment les certificats intermédiaires récupérés. Elle récupère à nouveau chaque liste à son nextUpdate, mais au moins chaque jour, et ne remplace jamais une liste stockée par une liste plus ancienne. pepsi-stage-decrypt confronte les chaînes de signataires à ces listes ; la vérification échoue en douceur en « non vérifié », et il n’y a pas d’OCSP. Une liste stockée retire les certificats en cache qu’elle révoque lorsqu’elle a été signée par une ancre de confiance activée portant le nom de l’émetteur, ou par un intermédiaire récupéré qui se valide jusqu’à une telle ancre. Un certificat retiré ne compte pas comme clé pour pepsi-stage-encrypt.

  • probe ADDRESS — exécuter tout l’éventail pour une adresse et afficher ce que chaque méthode a trouvé, sans rien stocker (pas même une entrée de cache négatif), à titre de diagnostic.

  • Le rôle de base de données le plus étroit du déploiement, provisionné par pepsi-setup : peer_key, key_request, les fonctions keydisc_* et pepsi.crl_cache, et sur pepsi.workqueue seulement SELECT plus un UPDATE (status, timeout) au niveau colonne, ce qui suffit à réveiller un message garé, et rien de plus. Il est le seul écrivain de pepsi.crl_cache, de sorte qu’un worker d’étape compromis ne peut pas supprimer une liste en cours pour retenir une révocation. Il n’a aucun accès à pepsi.crypto_identity. Il tourne sous son propre compte pepsi-keydisc, sans bit setuid ni setgid.

77.3. Voir aussi

pepsi-keys, pepsi-setup, Gestion des clés, Index des RFC, Clés des correspondants, Une recherche de clé qui échoue dans le DNS, pepsi-keydisc(1), pepsi-keys(1), pepsi.conf(5).