95.1.51. pepsi-keydisc¶
find a correspondent’s public key or certificate
- Section du manuel:
1
95.1.51.1.1. Nom¶
pepsi-keydisc - découverte de clés asynchrone, un service par méthode.
95.1.51.1.2. Synopsis¶
pepsi-keydisc [GLOBAL-OPTIONS] serve METHOD
pepsi-keydisc [GLOBAL-OPTIONS] probe ADDRESS
95.1.51.1.3. Description¶
pepsi-keydisc trouve la clé OpenPGP ou le certificat S/MIME d’un correspondant, note d’où il vient et ce que vaut cette source, et le met en cache dans pepsi.peer_key (voir pepsi-keys(1)). Trouver une clé est facile ; le plus dur est de savoir s’il faut y croire. Chaque résultat porte donc sa source et indique si la consultation qui l’a produit était validée par DNSSEC ; la politique de l’étape qui utilise la clé décide ensuite de ce qui suffit.
La découverte est asynchrone et vit hors des étapes. Une étape qui a besoin d’une clé absente de son cache ne fait jamais d’E/S réseau propre : elle valide le travail qu’elle peut conserver, met le message en pause et met une demande en file dans pepsi.key_request ; une instance de pepsi-keydisc répond à la demande et, dans le même aller-retour qui stocke la clé, libère chaque message garé sur cette adresse
stage cache hit -> use the key
fresh negative -> the no-key path, at once
cache miss -> park: commit, pause, enqueue
pepsi-keydisc@... LISTEN key_request -> look up -> store the key AND
release every parked message
Ce qui est validé au moment du garage relève de la décision de l’étape, non de ce programme. En particulier, pepsi-stage-decrypt(1) gare un message S/MIME avec le texte clair déchiffré validé, parce que la signature imbriquée survit comme une couche MIME ordinaire. Il gare un message OpenPGP inchangé : une signature OpenPGP ne vit qu’à l’intérieur du flux de paquets, et valider le texte clair détruirait la preuve même que la clé doit permettre de vérifier.
Un serveur de clés lent n’immobilise donc jamais un worker d’étape : le problème est supprimé, pas seulement borné. La demande est indexée sur l”adresse : cent messages vers un même correspondant coûtent donc une seule consultation et sont libérés ensemble. Une demande qui se conclut sans clé libère ceux qui l’attendent exactement comme une demande qui a trouvé une clé : les services trouvent les clés, les étapes décident du courrier.
Ce n’est pas une étape. Il se connecte à la base de données partagée via la section [pepsi-postgres] et se configure entièrement par [pepsi-keydiscovery] (voir pepsi.conf(5)).
95.1.51.1.4. Une instance par méthode¶
Il y a un binaire et une section de configuration, mais un processus par méthode de découverte, démarré depuis l’unité gabarit systemd pepsi-keydisc@.service :
pepsi-keydisc@daneOPENPGPKEY(RFC 7929) etSMIMEA(RFC 8162) DNS, sous une partie locale hachée. Les deux sont refusés sans le bit AD DNSSEC du résolveur. Les résolveurs sont ceux de[pepsi] DNS_SERVERS(voir pepsi.conf(5)), sinon ceux deresolv.conf, et puisque Pepsi se fie à leur bit AD plutôt que de valider DNSSEC lui-même, l’instance journalise un avertissement au démarrage lorsque l’un d’eux n’est ni sur cet hôte ni joint par DNS over TLS ou HTTPS (quiconque se trouve sur le chemin pourrait falsifier une réponse validée), et lorsqu’ils ne valident pas : une sonde duSOAsigné deietf.orgqui revient sans le bit AD signifie que chaque recherche ne trouve rien.pepsi-keydisc@wkd-advancedLe Web Key Directory à
openpgpkey.<domain>, sous/.well-known/openpgpkey/<domain>/hu/<hash>.pepsi-keydisc@wkd-directLe Web Key Directory au domaine lui-même, sous
/.well-known/openpgpkey/hu/<hash>.pepsi-keydisc@vksLes serveurs de clés vérificateurs de
VKS_SERVERS, à/vks/v1/by-email/<address>.pepsi-keydisc@ldapL’annuaire LDAP configuré ; uniquement dans un build comportant la fonctionnalité
ldap.
pepsi.target démarre les quatre premières, qui constituent les SOURCES par défaut.
Le découpage isole les méthodes les unes des autres : un bind LDAP bloqué ne peut pas caler WKD, et pour désactiver une méthode, vous lancez systemctl mask --now pepsi-keydisc@vks (et la retirez de SOURCES) plutôt que de redémarrer quelque chose de partagé. Les deux méthodes Web Key Directory ont des rangs distincts et s’exécutent donc en même temps, comme instances distinctes. Elles ne forment pas une chaîne de repli : n’essayer la méthode directe que « si l’avancée échoue » accepterait silencieusement la réponse la plus faible chaque fois que la plus forte serait simplement lente.
C’est un écart délibéré au §3.1 de draft-koch-openpgp-webkey-service, qui exige que la méthode avancée soit essayée en premier et que la directe ne soit utilisée que là où le sous-domaine openpgpkey n’existe pas du tout. L’ordre du draft porte sur la confiance plutôt que sur la vitesse : le /.well-known/openpgpkey/ de l’apex est servi par ce qui fait tourner le site web du domaine, souvent une partie différente de son opérateur de courrier. Un domaine qui publie correctement sous openpgpkey.<domain> voit donc tout de même son apex consulté ici, et une réponse venue de l’apex est stockée au rang wkd-direct, au-dessus de LDAP, de VKS et de tout ce qui est moissonné dans le courrier. Là où cela compte, SOURCES peut lister wkd-advanced sans wkd-direct.
Une instance dont la méthode n’apparaît pas dans [pepsi-keydiscovery] SOURCES refuse de démarrer, avec un message nommant ce que SOURCES liste effectivement. Ce n’est pas de la pédanterie : la règle d’arrêt à délai de grâce par rang n’attend que les méthodes nommées par SOURCES, de sorte qu’une instance non listée répondrait à une demande que personne n’attend.
Moissonner des clés dans le courrier entrant (parties application/pgp-keys, certificats de signataire S/MIME, en-tête Autocrypt:) n’est pas un service de découverte et n’a pas d’instance. Cela s’exécute en ligne là où le message se trouve déjà, dans pepsi-stage-autocrypt-learn(1), ne coûte aucune E/S réseau et écrit par le même chemin, de sorte qu’une clé moissonnée libère elle aussi tout ce qui est garé sur cette adresse. inbound est par conséquent refusé dans SOURCES, de même qu”inbound-signed, l’échelon auquel cette même étape élève une clé lorsqu’une signature DKIM alignée et réussie à l’ingress la couvrait.
Il en va de même de gossip, les clés que cette même étape lit dans les champs Autocrypt-Gossip: à l’intérieur d’un message arrivé chiffré (Autocrypt Level 1 §5.3). C’est un second échelon en ligne plutôt qu’une variante d”inbound, parce que ces clés sont celles de tiers plutôt que celle de l’expéditeur, et que l’échelle doit pouvoir les distinguer.
Notez où se situe l”« en ligne » : pepsi-stage-decrypt(1) extrait les certificats que porte un message afin de vérifier sa signature, puis les abandonne ; il ne stocke rien. Un pipeline sans étape pepsi-stage-autocrypt-learn n’apprend jamais aucune clé depuis le courrier, quelle que soit la quantité de matériel qui arrive, et aucune configuration de [stage-decrypt] n’y change quoi que ce soit.
95.1.51.1.5. Quelle clé l’emporte en cas de conflit¶
Une clé dont l”empreinte est déjà stockée pour la même adresse et le même protocole n’est pas du tout un conflit : la ligne est mise à jour sur place (sa source, sa validité, son expiration et sa date d’effet Autocrypt sont reportées, la source ne pouvant que s’améliorer) et la réponse est refreshed. Cela se produit avant chacun des tests ci-dessous, de sorte que revoir une clé épinglée rafraîchit tout de même ce que l’on sait d’elle. Les certificats OpenPGP stocké et entrant sont fusionnés, non échangés, de sorte qu’une révocation ou une auto-signature plus récente que porte la copie stockée survit lorsqu’une copie plus ancienne arrive ensuite ; la fusion abandonne les signatures qui ne se vérifient pas et les composants que rien ne lie. La fusion a lieu quel que soit le rang de la source entrante : une révocation ou une auto-signature plus récente que seule porte une copie plus faible (le propre courrier d’un correspondant répétant une clé trouvée d’abord par WKD ou importée à la main) est écrite dans la ligne stockée, qui est alors marquée revoked si le certificat fusionné l’est, tandis que sa source, son rang et son épinglage restent inchangés. C’est sans danger parce que la fusion ne conserve que les signatures faites par la clé elle-même (ou par un révocateur qu’elle désigne) ; une source plus faible ne peut toujours pas remplacer une clé différente.
Lorsqu’une clé découverte diffère de tout ce qui est stocké pour cette adresse et ce protocole, le magasin décide en une seule étape côté serveur, dans cet ordre :
une ligne épinglée n’est jamais délogée, quoi qu’il arrive ;
une source strictement mieux classée remplace tout ce qui est stocké — de sorte que WKD déloge une clé moissonnée, une entrée d’opérateur déloge WKD, et une clé apprise par gossip ne déloge rien du tout ; au sein du niveau Autocrypt, l’échelon supérieur est
inbound-signedpar rapport àinbound, et ce seul remplacement est rapporté et audité comme une rotation (ci-dessous), puisque les deux sont les propres revendications du correspondant ;le plus récent l’emporte à l’intérieur du palier Autocrypt (ci-dessous) ;
sinon la clé stockée est conservée, la nouvelle n’est pas stockée, et la réponse est rapportée comme
rejected.
95.1.51.1.5.1. Le plus récent l’emporte dans le palier Autocrypt¶
La mise à jour de l’état des pairs d’Autocrypt Level 1 est le plus jeune l’emporte : un client stocke la clé du plus jeune message qu’il ait vu portant un en-tête Autocrypt:. La règle 2 seule ne peut exprimer cela : elle refuserait la deuxième clé Autocrypt jamais vue pour une adresse et garderait la première à jamais, de sorte qu’un correspondant qui réinstalle son client, change d’appareil ou renouvelle sa clé continuerait de recevoir du courrier chiffré vers une clé qu’il ne détient plus. Ce courrier illisible est exactement l’échec qu’Autocrypt cherche à éviter.
La règle 3 laisse donc une clé plus récente l’emporter, et elle est confinée de sorte qu’elle ne puisse jamais trancher qu’entre des prétentions de même nature. Elle s’applique lorsque toutes ces conditions sont réunies :
la source entrante est
inbound-signed,inboundougossip; etchaque clé actuellement stockée pour cette adresse et ce protocole se trouve aussi sur l’un de ces échelons — rien de ce qu’un propriétaire ou un opérateur a publié n’est jamais en jeu ; et
la source entrante se classe au moins aussi haut que la source stockée, de sorte qu”
inboundremplaceinboundet quegossipremplacegossip, mais que la présentation par un tiers ne puisse jamais retirer la ligne à ce que le propriétaire de l’adresse a dit de lui-même, et qu’une clé issue d’un message non signé ne puisse jamais la retirer à une clé qu’a apportée un message signé DKIM (inbound-signed), aussi récent que prétende être le message non signé ; etla date d’effet du message entrant est strictement plus récente que celle qui est stockée.
La date d’effet est l’en-tête Date: du message, plafonné de sorte qu’il ne puisse jamais être dans le futur, et l’heure de réception lorsque l’en-tête est absent ou inanalysable — la définition propre du Level 1. Des dates égales relèvent donc du premier arrivé (un message redistribué ne peut pas faire basculer la ligne), et une clé qui ne porte aucune date d’effet — toute méthode réseau — ne déloge jamais rien.
La règle a un prix, car un attaquant peut s’en servir. La moisson est indexée sur l’en-tête From:, que l’expéditeur écrit, et l’authentification entrante est fail-open : un From: falsifié peut donc déloger une clé qui n’était elle-même jamais que de la confiance au premier usage. C’est le compromis propre à Autocrypt : il défend contre la collecte passive, non contre un attaquant actif sur le chemin. La règle est bornée des quatre côtés ci-dessus : rien de ce qui est publié par le domaine (WKD, DANE), par un serveur de clés, par un annuaire ou par l’opérateur ne peut être touché, ni une ligne épinglée. Un opérateur qui ne veut pas de cette règle règle [pepsi-keydiscovery] MIN_TRUST au-dessus du palier, ou épingle les clés qui comptent avec pepsi-keys peer pin (voir pepsi-keys(1)). Notez qu’une adresse pour laquelle ce déploiement détient une identité reçoit sa réponse de cette identité et jamais du cache des pairs.
Un remplacement au titre de la règle 3 est rapporté comme rotated plutôt que replaced et écrit une ligne key.peer.rotate dans le journal d’audit dans la même instruction, de sorte qu’une rotation ne peut avoir lieu sans sa trace. Seul l’apprentissage entrant (pepsi-stage-autocrypt-learn(1)) peut en déclencher une. Cette étape envoie aussi un courrier aux destinataires locaux du message, et elle peut restreindre la règle avec ACCEPT_ROTATION = expired (chaque clé stockée doit être enregistrée comme révoquée ou expirée), auquel cas une rotation refusée est rapportée comme held et auditée comme key.peer.rotate.held. Les méthodes réseau n’atteignent jamais la règle 3.
Une clé inbound-signed qui arrive par-dessus une clé inbound stockée relève de la règle 2 par son rang, mais elle est tout de même rapportée et auditée comme une rotation, et ACCEPT_ROTATION = expired la retient comme toute autre. Quand le domaine expéditeur se porte garant d’une clé différente de celle que portait le courrier non signé de son utilisateur, c’est exactement le changement que les destinataires doivent apprendre. La propre clé du propriétaire arrivant par-dessus une clé issue du gossip reste un remplacement ordinaire selon la règle 2.
La même empreinte revue est un rafraîchissement, non un conflit, et la ligne reprend la meilleure des deux sources — de sorte qu’une clé vue d’abord non signée passe à inbound-signed la première fois qu’un message signé la porte, et n’en redescend jamais. Un tel rafraîchissement est rapporté à part : une clé stockée depuis gossip que le propre message de son propriétaire (source inbound ou inbound-signed) porte désormais est rapportée comme promoted et auditée comme key.peer.promote, jamais comme une rotation — la promotion hors du gossip du §5.3 d’Autocrypt Level 1.
95.1.51.1.6. Clés dont la moitié privée est connue¶
Une clé découverte n’est pas stockée si elle figure sur la liste des clés connues comme compromises, ou si son module RSA trahit ses facteurs premiers (ROCA, nombres premiers proches, un petit facteur). Cette liste est pepsi.compromised_key : la liste de blocage badkeys avec les clés faibles OpenSSL de Debian, que tient à jour pepsi-keys blocklist update, et les modules que le propre pepsi-keys peer screen de ce déploiement a factorisés (voir pepsi-keys(1)). Pour une telle clé, la méthode rapporte qu’elle n’a rien trouvé, avec un avertissement nommant l’adresse, et la demande se règle sur les réponses des autres méthodes. Le moissonnage dans pepsi-stage-autocrypt-learn(1) applique le même test. Ce rôle peut lire la liste et rien de plus ; seul pepsi-crypto l’écrit.
95.1.51.1.7. Une recherche qui échoue dans le DNS¶
Une demande qui se règle sans clé se lirait comme « pas de clé » quelle qu’en soit la raison, et le chiffrement opportuniste enverrait alors en clair. Un attaquant capable de faire échouer les enregistrements de clés du destinataire (un SERVFAIL falsifié, des réponses abandonnées, une réponse DNSSEC bogus) obtiendrait ainsi une rétrogradation. Chaque instance classe donc une recherche échouée avant de la rapporter :
Pour
dane, un échec de la requêteOPENPGPKEYouSMIMEAelle-même ; pourwkd-advancedetwkd-direct, un échec de résolution du nom d’hôte WKD (openpgpkey.domain, ou le domaine), que l’instance redemande parce que l’erreur du client HTTPS ne dit pas quelle couche a échoué.L’instance interroge ensuite les enregistrements
MX,AetAAAAdu domaine. Si aucun ne répond par un enregistrement, l’échec est unreachable (injoignable) ; si l’un d’eux répond, ce sont les enregistrements de clés qui échouent alors que le domaine répond (key-records).
Le rapport le plus fort d’un tour est conservé sur la demande (dns_report). Lorsque la demande se règle sans clé, ce rapport devient un verdict (key_request.dns_failure) : unreachable ; transient pour des enregistrements de clés qui échouent alors que le domaine répond ; et inconsistent une fois que cela s’est produit lors de trois tours consécutifs, chacun dans l’heure suivant le précédent — de sorte qu’un paquet perdu, ou un serveur qui abandonne une fois un type d’enregistrement inhabituel, est un réessai et non un verdict. Une demande qui se règle sur un échec DNS ne reste fraîche que 15 minutes plutôt qu”ERROR_TTL, parce que les messages qui l’attendent sont retenus, non envoyés (voir pepsi-stage-encrypt(1), « Échecs DNS des destinataires ») ; un tour qui trouve une clé, ou qui échoue pour toute autre raison, remet le compteur à zéro.
Ce qui n’est délibérément pas classé, et reste donc « pas de clé » : un échec WKD dont le nom d’hôte se résout (une erreur HTTPS, TLS ou 5xx — fréquente et inoffensive), un échec de serveur de clés ou LDAP, et un NXDOMAIN ou une réponse vide. Sans DNSSEC, un NXDOMAIN ou une réponse vide falsifiés sont indiscernables de vrais, et se lisent encore « pas de clé ».
95.1.51.1.8. Rafraîchissement des clés en cache¶
Une clé stockée est utilisée pendant CACHE_TTL puis revérifiée par le pepsi-keys-refresh.timer quotidien (pepsi-keys peer refresh, voir pepsi-keys(1)). Le rafraîchissement n’interroge à nouveau que la méthode qui a trouvé la clé, et seulement si cette méthode figure encore dans SOURCES : une clé vks est récupérée à nouveau auprès des serveurs de clés, une clé wkd auprès du Web Key Directory avancé et une clé wkd-direct auprès du direct, une clé dane dans le DNS et une clé ldap dans l’annuaire. Les clés qu’aucune méthode réseau n’a produites ne sont jamais rafraîchies par le réseau : les clés inbound-signed, inbound et gossip moissonnées dans le courrier, et les clés manual et api qu’un opérateur a saisies. Une clé moissonnée est mise à jour par le message suivant de son propriétaire. Les clés épinglées et les lignes *@domain ne sont pas rafraîchies non plus. Une clé moissonnée est en revanche une raison de chercher : pepsi-stage-encrypt(1) lance une demande de découverte ordinaire, au plus une fois par NEGATIVE_TTL, chaque fois qu’elle chiffre vers une clé située sur l’un de ces trois échelons, afin qu’une clé publiée par le propriétaire puisse prendre le relais.
C’est un choix de confidentialité. Exécuter tout l’éventail pour chaque clé due apprendrait au serveur de clés l’ensemble des correspondants du déploiement, une fois par jour, quelle que soit la méthode qui avait réellement trouvé leurs clés ; restreint à la méthode d’origine, le serveur de clés n’entend parler que des correspondants dont il a fourni les clés, et les propres domaines des correspondants seulement de leurs propres adresses. Le coût est la fraîcheur : une révocation publiée seulement sur un serveur de clés n’est pas vue pour une clé venue de WKD, de DANE ou d’un message. pepsi-keys peer refresh --address exécute encore tout l’éventail pour une adresse lorsqu’un opérateur le demande.
95.1.51.1.10. Listes de révocation¶
Les étapes qui vérifient les signatures S/MIME n’utilisent pas le réseau ; les données de révocation qu’elles consultent doivent donc être récupérées à l’avance, et c’est l’unique processus qui récupère quoi que ce soit pour les clés. Sauf si [pepsi-keydiscovery] CRL_FETCH = no, chaque instance exécute une seconde boucle à côté de sa boucle de découverte :
Moisson. Toutes les heures, elle lit chaque certificat de pair S/MIME en cache dans
pepsi.peer_key(les révoqués exceptés) et inscrit les URIhttp://ethttps://de son extensioncRLDistributionPoints– au plus deux par certificat – danspepsi.crl_cache. Un certificat qu’une méthode de découverte vient de stocker est inscrit aussitôt, de même que les points de chaque chaîne de certificats clients TLS que valide pepsi-ingress(1) (TLS_AUTH_CLIENT_CA), viacrl_cache_register, la seule écriture que ce rôle peut faire ici. SousCA_ISSUERS_FETCH, les points de chaque certificat intermédiaire récupéré pour un pointeurcaIssuers(ci-dessous) sont aussi inscrits, de sorte qu’une chaîne passant par un tel intermédiaire puisse être couverte entièrement ; cela n’apprend à l’AC rien que la récupération de son certificat ne lui ait déjà appris. Un point de distribution qui nomme uncRLIssuerou seulement certaines raisons de révocation est ignoré, de même que les URI LDAP. Un point qu’aucun certificat en cache n’a nommé depuis 30 jours est oublié.Récupération. Toutes les cinq minutes, elle réserve les points qui sont dus (chacun n’est récupéré que par une seule instance) et récupère chacun avec le même client durci qu’utilisent les recherches WKD et VKS : la vérification d’adresse anti-SSRF, l’échéance
METHOD_TIMEOUTsur toute la réponse, et un plafond d’octetsCRL_MAX_BYTES(1 Mio par défaut) appliqué pendant le flux. Cette récupération ne suit toutefois aucune redirection, et elle utilisehttp://simple lorsque c’est ce que nomme le certificat : une CRL est signée par son émetteur, et la RFC 5280 fait servir les points de distribution en HTTP. Une réponse n’est stockée que s’il s’agit d’une seule CRL encodée en DER dont lenextUpdateest présent et dans le futur et dont lethisUpdateest au plus une heure dans le futur (décalage d’horloge), et seulement si elle n’est pas plus ancienne que la liste déjà stockée (une vieille liste rejouée « dé-révoquerait » un certificat). Le point est récupéré à nouveau lorsque sonnextUpdatearrive, mais au moins chaque jour et au plus chaque heure ; une récupération échouée est réessayée aprèsERROR_TTLet laisse en place la liste stockée.Retrait. Après chaque stockage, l’instance vérifie si la liste peut être crue ici. C’est le cas lorsque la liste est en cours et que l’un de deux certificats l’a signée : une ancre de confiance activée (
cade pepsi-keys(1)) portant le nom de l’émetteur et autorisée à signer des CRL, ou un certificat d’AC intermédiaire de ce nom, récupéré pour un pointeurcaIssuers, qui se valide jusqu’à une ancre activée (chaque signature du chemin vérifiée, dans sa période de validité, une AC autorisée à signer des CRL, chaque contrainte de chemin respectée, en passant par d’autres intermédiaires récupérés si besoin). Si la liste peut être crue, chaque certificat en cache qui nomme ce point, a cet émetteur et se trouve dans la portée de la liste y est recherché. Un numéro de série listé marque la lignerevokeddanspepsi.peer_key(check_method = crl,revoked_at,revoked_reasonnommant le point, le code de raison de l’entrée et sa date), et le journal indique quel certificat de quelle adresse a été retiré. La ligne n’est pas supprimée : pepsi-keys peer list et peer show continuent de l’afficher avec la raison, son empreinte reste connue comme révoquée de sorte qu’un annuaire servant encore l’ancien certificat ne peut pas le faire revenir, et un certificat réémis trouvé plus tard la remplace (depuis la même source aussi, ce qu’une ligne active refuserait à rang égal ; une source plus faible ne le peut toujours pas). Dès ce moment, la ligne n’est une clé pour personne : chaque recherche l’ignore, de sorte que pepsi-stage-encrypt(1) prend la voieON_NO_KEYdu destinataire et consigne « revoked » comme raison, sans code de révocation qui lui soit propre. Une liste qu”aucun des deux n’a signée est stockée pour le vérificateur ci-dessous mais n’entraîne aucune action : un point de distribution est généralement enhttp://simple, et retirer des clés sur la foi d’une liste non vérifiée permettrait à quiconque se trouve sur ce chemin de faire envoyer en clair le courrier d’un correspondant. L’ensemble des ancres est celui de l’opérateur : une AC intermédiaire qui publie sa propre liste ne retire quelque chose que lorsque son certificat a été récupéré (CA_ISSUERS_FETCH) et s’enchaîne jusqu’à une ancre activée, ou lorsqu’elle est elle-même ajoutée avec pepsi-keys ca add. Un certificat stocké après la récupération d’une liste est vérifié à la récupération suivante, dans la journée.
Le stockage ne vérifie rien. Lorsqu’une liste est utilisée, le certificat d’émetteur contre lequel sa signature est vérifiée arrive avec le message en cours de vérification. pepsi-stage-decrypt(1) lit les listes en cours dans le cache (derrière son TRUST_ANCHOR_TTL), et le vérificateur n’utilise une liste pour un certificat que si la clé de l’émetteur l’a signée, qu’elle est en cours et que sa portée couvre le certificat (une liste partitionnée pour un autre point de distribution, une delta, une liste indirecte ou limitée à certaines raisons ne la couvre pas ; ni une liste comportant une extension critique que le vérificateur ne traite pas). Un numéro de série listé rend la signature bad avec la raison revoked.
La vérification de révocation échoue en douceur pour le courrier : un point injoignable, une liste périmée, invérifiable ou hors portée, ou un cache illisible laisse le verdict à « non vérifié » et chaque clé en cache en usage, exactement comme lorsque rien n’a été récupéré. Le seul consommateur strict est pepsi-ingress(1) : un certificat client TLS dont le chemin nomme un point de distribution n’est pas accepté tant qu’une liste en cours de ce cache ne le couvre pas. Il n’y a aucune requête OCSP : une récupération de CRL apprend à l’AC, au plus une fois par jour, que cet hôte détient un certificat qu’elle a émis ; une requête OCSP lui apprendrait lequel, au moment où arrive un message signé avec lui. (Une réponse qu’agrafe un serveur TLS ne coûte aucune requête et est évaluée sur cette session, pepsi-stage-relay-to-internet(1).)
95.1.51.1.11. Certificats intermédiaires¶
De nombreux signataires envoient leur certificat S/MIME sans les certificats d’AC intermédiaires situés entre lui et la racine, et un chemin que le vérificateur ne peut pas construire laisse la signature untrusted même lorsque la racine est une ancre configurée. Le certificat lui-même indique où est publié le certificat de son émetteur (l’entrée caIssuers de son extension authorityInfoAccess, RFC 5280 §4.2.2.1). Avec [pepsi-keydiscovery] CA_ISSUERS_FETCH = yes (par défaut no), chaque instance exécute une troisième boucle selon le calendrier de la boucle des CRL :
Moisson. Toutes les heures, elle inscrit dans
pepsi.ca_issuer_cacheles URIcaIssuershttp://ethttps://de chaque certificat de pair S/MIME en cache – au plus deux par certificat, jamais unldap://–, ainsi que ceux de chaque certificat déjà récupéré, un niveau plus haut, au plus trois niveaux au-dessus d’un certificat de pair. Une URL qu’aucun certificat n’a nommée depuis 30 jours est oubliée.Récupération. Toutes les cinq minutes, elle réserve les URL qui sont dues et récupère chacune avec le client durci et les règles de la récupération des CRL (la vérification d’adresse anti-SSRF, l’échéance
METHOD_TIMEOUTsur toute la réponse, sans redirections,http://simple là où le certificat le nomme), sous un plafond fixe de 64 Kio. La réponse peut être un seul certificat DER, un bundle CMScerts-onlyou du PEM ; ses certificats d”AC sont stockés, au plus quatre, et tout le reste est refusé et consigné danslast_error. Une réponse stockée est récupérée à nouveau au bout d’une semaine, une réponse échouée aprèsERROR_TTL.
pepsi-stage-decrypt(1) lit les certificats stockés (derrière son TRUST_ANCHOR_TTL) et les remet au vérificateur comme intermédiaires par lesquels un chemin peut passer. Ils ne sont jamais des ancres et ne nomment jamais un signataire : un chemin qui passe par l’un d’eux ne compte que si chacune de ses signatures se vérifie jusqu’à une ancre ca activée de pepsi-keys(1), de sorte qu’une réponse falsifiée peut ne pas aider mais ne peut pas rendre une signature valide. L’option est désactivée par défaut parce que chaque récupération apprend à une AC que cet hôte correspond avec l’un de ses abonnés ; si elle est désactivée, un signataire qui n’envoie pas d’intermédiaires se lit untrusted.
95.1.51.1.12. Commandes¶
- serve METHOD
Exécute l’instance de service d’une méthode jusqu’à interruption. METHOD vaut
dane,wkd-advanced,wkd-direct,vksouldap— le nom d’instance du gabarit systemd — et doit figurer dans[pepsi-keydiscovery] SOURCES.L’instance fait un
LISTENsur le canalkey_request, dont la charge utile est l’identifiant de demande, répond à chaque demande dont cette méthode est encore redevable, et effectue un balayage au démarrage et à chaque reconnexion de l’écouteur, de sorte que rien de ce qui a été soulevé en son absence ne soit perdu. Entre les notifications, elle cadence un court balayage de règlement : une fenêtre de grâce par rang est un instant, il faut donc que quelque chose regarde l’horloge, et un déploiement exécutant la moindre instance dispose donc de ce balayage. Une consultation isolée en échec est consignée sur la demande (ce qui sélectionne le courtERROR_TTLplutôt que le longNEGATIVE_TTL) et ne fait jamais tomber l’écouteur.- probe ADDRESS
Exécute une fois l”intégralité de l’éventail pour une adresse et affiche ce que chaque méthode a trouvé — le protocole, l’empreinte, la taille, et
dnssecpour une réponse DANE validée par AD — ou l’erreur rencontrée, ou qu’elle n’a rien trouvé.Délibérément en lecture seule : il ne stocke rien, ni la clé ni une entrée de cache négatif. Un opérateur qui diagnostique « pourquoi ce correspondant n’a-t-il pas de clé » veut voir la réponse de chaque méthode, et non qu’un diagnostic écrive une entrée négative qui supprimerait ensuite la vraie consultation pendant une journée. Pour consulter une adresse et stocker le résultat, utilisez
pepsi-keys peer refresh --address(voir pepsi-keys(1)).Une adresse exclue par
ALLOW_DOMAINS/DENY_DOMAINSest signalée comme telle et n’est pas interrogée.
95.1.51.1.13. Privilèges¶
Les services s’exécutent sous leur propre compte non privilégié, pepsi-keydisc — non l’utilisateur de service pepsi ni pepsi-crypto. Ce démon analyse du matériel de clé récupéré sur l’internet ouvert (un corps WKD hostile, une réponse de serveur de clés, un enregistrement DNS), ce qui en fait le processus le plus susceptible d’être compromis ici : pepsi-setup(1) lui donne donc le rôle de base de données le plus étroit du déploiement :
SELECT/INSERT/UPDATE/DELETEsurpepsi.peer_key— remplir le cache est tout son travail, et la règle de conflit doit pouvoir remplacer une ligne ;SELECT/INSERT/UPDATEsurpepsi.key_request— la file de travail à laquelle il répond ;EXECUTEsur les fonctionskeydisc_*et les deux helperscrypto_*qu’elles appellent ;sur
pepsi.workqueue,SELECTplus unUPDATE (status, timeout)au niveau colonne ;SELECT/INSERT/UPDATE/DELETEsurpepsi.crl_cache, les listes de révocation qu’il récupère. Il est le seul écrivain du cache ; les rôlespepsietpepsi-cryptone peuvent que le lire, de sorte qu’un worker d’étape compromis ne peut pas supprimer une liste en cours pour retenir une révocation ;SELECT/INSERT/UPDATE/DELETEsurpepsi.ca_issuer_cache, les certificats intermédiaires qu’il récupère, dont il est de même le seul écrivain ;SELECTsurpepsi.ca_trust, les ancres activées contre lesquelles la signature d’une liste récupérée est vérifiée avant que les certificats qu’elle liste ne soient retirés.
Rien d’autre.
Ces deux colonnes suffisent exactement à faire passer une ligne garée de paused à pending, ce qui se produit dans keydisc_resolve/keydisc_sweep. Avec un droit au niveau table, ce compte pourrait réécrire les destinataires d’un message ou son corps ; avec ces deux colonnes, il ne peut que réveiller un message. Il n’a aucune portée sur pepsi.crypto_identity, et donc aucune sur la moindre clé privée.
Le programme ne porte aucun bit setuid ou setgid et est plié dans le binaire multi-appel pepsi. Lancé en tant que root, il devient le compte pepsi-keydisc avant de se connecter (la configuration, et tout fragment @inline-secret@, est lue d’abord, en tant qu’utilisateur appelant), de sorte qu’il peut être lancé depuis un shell root pour des tests sans sudo -u.
95.1.51.1.14. LDAP est une fonctionnalité décidée à la compilation¶
Le client LDAP est derrière la fonctionnalité cargo ldap et est désactivé par défaut : il ajoute une dépendance, et un déploiement sans annuaire ne devrait pas en lier une. Un build sans la fonctionnalité refuse de démarrer pepsi-keydisc@ldap avec un message le disant, plutôt que de répondre silencieusement « pas de clé » à jamais, et pepsi-setup(1) rejette sur un tel build une configuration qui liste ldap dans SOURCES — comme il rejette celle qui liste ldap sans LDAP_URL et LDAP_BASE.
95.1.51.1.15. Options globales¶
Ces options globales précèdent la sous-commande (un indicateur placé à la fin est rejeté).
- -c FILE, –config FILE
Lit la configuration depuis FILE au lieu de parcourir les emplacements par défaut.
- -L LOGLEVEL, –log LOGLEVEL
Règle la verbosité de journalisation. LOGLEVEL est l’un de
error,warn,info,debugoutrace(par défaut :[pepsi] LOG, sinoninfo).- -v, –verbose
Affiche les messages de journal de toutes les sources, y compris les bibliothèques tierces.
- -h, –help
Affiche un résumé d’utilisation et quitte.
- -V, –version
Affiche la version et quitte.
95.1.51.1.16. Signaux¶
- SIGINT, SIGTERM
Cesser de prendre de nouvelles demandes et quitter. Rien n’est perdu : une demande sans réponse reste
pendingdanspepsi.key_requestet est reprise par le balayage de démarrage de l’instance suivante, ou se conclut d’elle-même à son échéance.
95.1.51.1.17. Code de sortie¶
- 0
Arrêt propre, ou un probe achevé.
- 1
Une erreur s’est produite : une configuration malformée, une méthode que
[pepsi-keydiscovery] SOURCESne liste pas,ldapdans un build sans la fonctionnalité, ou une connexion à la base de données échouée. Les échecs de consultation individuels ne sont pas des erreurs — ils sont consignés sur la demande et le service continue de tourner.- 78
Le schéma de la base de données n’est pas celui qu’attend cette version (non installé, plus ancien, plus récent ou modifié) : exécutez
schemade pepsi-setup(1).
95.1.51.1.18. Exemples¶
pepsi.target démarre l’ensemble de méthodes par défaut (dane wkd-advanced wkd-direct vks). Sans la cible, démarrez-les à la main
systemctl enable --now pepsi-keydisc@dane pepsi-keydisc@wkd-advanced \
pepsi-keydisc@wkd-direct pepsi-keydisc@vks
Désactiver une méthode sans toucher à la configuration des autres
systemctl mask --now pepsi-keydisc@vks
(puis réglez [pepsi-keydiscovery] SOURCES = dane wkd-advanced wkd-direct, afin que la règle d’arrêt cesse d’attendre une réponse qui ne viendra jamais). mask plutôt que disable : pepsi.target redémarre une instance simplement désactivée.
Découvrir ce que chaque méthode dit d’une adresse, sans rien changer
pepsi-keydisc -c /etc/pepsi/pepsi.conf probe bob@example.com
Exécuter une instance au premier plan, avec la journalisation complète, pour voir pourquoi une adresse ne donne aucune clé
pepsi-keydisc -c /etc/pepsi/pepsi.conf -L debug serve wkd-advanced
95.1.51.1.19. Voir aussi¶
pepsi-keys(1), pepsi-setup(1), pepsi.conf(5), pepsi.state(7), pepsi-dispatch(1), pepsi-config(1)
Le chapitre Sécurité du manuel énonce les mécanismes que met en œuvre ce programme (A correspondent’s key changing, A key lookup that fails in the DNS, Key-discovery SSRF, Key-discovery certificate authorities) ; son chapitre Modèle de menace énonce ce qu’ils promettent (Keys of correspondents).
95.1.51.1.20. Bogues¶
Signalez les bogues au gestionnaire de tickets de Pepsi.