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 systemdpepsi-keydisc@.service:@dane,@wkd-advanced,@wkd-direct,@vkset (dans un build avec la fonctionnalité Cargoldap)@ldap.SOURCESprend par défaut les quatre premières, quepepsi.targetdémarre. Un bind LDAP bloqué ne peut pas paralyser WKD. Pour désactiver une méthode, exécutezsystemctl mask --now pepsi-keydisc@vkset retirez la méthode deSOURCES(mask, parce quepepsi.targetredémarre une instance simplement désactivée). Une instance dont la méthode est absente de[pepsi-keydiscovery] SOURCESrefuse de démarrer, car la règle d’arrêt n’attend que les méthodes nommées parSOURCES.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) etSMIMEA(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@daneavertit donc au démarrage lorsqu’un résolveur deresolv.confn’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_BUNDLEremplace, 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 enregistrementsMXetA/AAAAdu 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 lignekey_requestré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 quepepsi-keys peer screena 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 refreshquotidien revérifie une clévksauprès du serveur de clés, une clé WKD auprès de la même méthode WKD, une clédanedans le DNS et une cléldapdans l’annuaire, et seulement tant que cette méthode figure dansSOURCES; 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 danspepsi.crl_cacheles CRL que nomment les certificats de pairs S/MIME en cache dans leurscRLDistributionPoints(http:///https://, au plus deux par certificat, sans redirections,CRL_MAX_BYTES). SousCA_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 à sonnextUpdate, 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 fonctionskeydisc_*etpepsi.crl_cache, et surpepsi.workqueueseulementSELECTplus unUPDATE (status, timeout)au niveau colonne, ce qui suffit à réveiller un message garé, et rien de plus. Il est le seul écrivain depepsi.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 comptepepsi-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).