52. pepsi-stage-autocrypt-learn¶
Apprendre les clés des correspondants à partir du courrier qu’ils nous envoient.
52.1. Rôle¶
pepsi-stage-autocrypt-learn est l’endroit où Pepsi apprend des clés publiques à partir du courrier entrant. L’étape lit l’en-tête Autocrypt: de l’expéditeur, une pièce jointe application/pgp-keys, le certificat qui a produit une signature S/MIME sur le message et, pour un message arrivé chiffré, les champs Autocrypt-Gossip: qui présentent les autres destinataires (Autocrypt Level 1 §5.3). Elle apprend et fait avancer ; elle n’abandonne, ne met en pause, ne fait rebondir ni ne réécrit jamais un message, aussi NEXT_STAGE est-il obligatoire. Référence : pepsi-stage-autocrypt-learn(1).
52.2. Fonctionnalités¶
Placement. Elle s’exécute après les contrôles de spam et avant la remise, car le Level 1 §5.3 dit que l’état de pair DEVRAIT être ignoré pour un message tenu pour du spam, et cela ne peut être honoré qu’une fois qu’un verdict de spam existe. pepsi-stage-decrypt s’exécute en premier sur le chemin entrant afin que tout l’aval voie du texte clair ; à ce moment, aucune étape n’a encore jugé si le message est indésirable.
Respecte le verdict de spam : l’étape n’apprend rien d’un message avec
state.spam = true, à moins queLEARN_FROM_SPAMn’en dispose autrement.Seulement la clé propre de l’expéditeur : depuis les en-têtes et les pièces jointes d’un message, l’étape n’apprend que la clé de l’expéditeur. Présenter un tiers est l’affaire du gossip, et une clé issue du gossip atterrit sur un échelon inférieur.
Seul un certificat qui a signé : un certificat S/MIME est appris lorsqu’un
SignerInfodu message se vérifie sous sa clé sur le contenu signé, jamais parce qu’unSignedDatale transporte. Il atterrit au ranginbound-signedlorsque DMARC a réussi à l’ingress ou qu’une signature DKIM alignée et valide couvrait le corps, et au ranginboundsinon ; un certificat issu d’un courrier non authentifié ne remplace jamais un certificat issu d’un courrier authentifié.Le gossip seulement depuis du texte chiffré : le gossip n’est cru que lorsque pepsi-stage-decrypt a noté que le message est arrivé chiffré et que son bloc d’en-têtes à l’arrivée ne portait aucun champ
Autocrypt-Gossip:propre. Ni l’un ni l’autre n’est visible depuis le texte clair validé : les deux sont donc lus dansstate.crypto.in.Jamais de clé pour une adresse que cet hôte sert : une clé de pair pour une adresse locale est celle avec laquelle notre propre courrier sortant vers cet utilisateur serait chiffré, de sorte qu’un champ de gossip qui en nomme une est une substitution de clé plutôt qu’une présentation.
Note qu’un correspondant détient notre clé : lorsqu’un message a été déchiffré avec l’une de nos clés MTA et porte une signature valide de son adresse
From:couvrant le texte en clair, une lignepepsi.peer_has_own_keyest écrite, de sorte que pepsi-stage-encrypt cesse de joindre cette clé sous forme de fichier (ATTACH_KEYS_AS_FILES). Cela se produit quels que soientLEARN_KEYSet le verdict de spam, puisque cela concerne notre clé, et non la sienne.Note ce que lit le client S/MIME d’un correspondant : les
SMIMECapabilitiesRFC 8551 que porte une signature vérifiée sont consignées par certificat de signature danspepsi.smime_capability, d’après quoi pepsi-stage-encrypt et pepsi-stage-reencrypt choisissent pour ce pair l”AuthEnvelopedDataAES-GCM ou l”EnvelopedDataAES-CBC ; un enregistrement défini à la main (pepsi-keys peer capability set) l’emporte sur un enregistrement appris. Voir Quel conteneur S/MIME reçoit un correspondant.Refuse les clés connues comme compromises : une clé de la liste de blocage badkeys ou de
pepsi.compromised_keyn’est jamais stockée, et l’étape n’apprend aucune clé d’un message qui propose plus de huit clés pour son expéditeur.Les changements de clé ne sont jamais silencieux : lorsque la clé d’un correspondant est remplacée selon la règle du plus récent, l’étape écrit une ligne d’audit
key.peer.rotateet, avecRESPONSE_STAGEdéfini, envoie un avis aux destinataires locaux du message. L’avis montre les deux empreintes en hexadécimal et en mots PGP, l’échelon de confiance de la nouvelle clé et la commandepinqui consigne une comparaison (L’épinglage par l’utilisateur lui-même).ACCEPT_ROTATION = expiredretient au contraire une nouvelle clé jusqu’à ce que la clé stockée soit morte. Une clé issue du gossip que son propriétaire annonce ensuite lui-même est promue à l’écheloninbound.Non privilégiée : elle n’écrit que du matériel de clé public, de sorte que, contrairement aux étapes cryptographiques, elle n’a besoin d’aucun bit setuid et est pliée dans le binaire multi-appel
pepsi.
52.3. Configuration¶
LEARN_KEYS (par défaut yes ; désactivé, l’étape n’apprend plus aucune clé), LEARN_GOSSIP (par défaut yes, et n’ayant de sens que tant que LEARN_KEYS est activé), LEARN_FROM_SPAM (par défaut no, conformément au SHOULD du §5.3 d’Autocrypt Level 1), ACCEPT_ROTATION (newest, la valeur par défaut, ou expired : ne remplacer la clé stockée d’un correspondant qu’une fois que chaque clé stockée pour l’adresse est révoquée ou expirée), le RESPONSE_STAGE facultatif (où sont injectés les avis informant les destinataires locaux que la clé d’un correspondant a changé ; sans lui, un changement est seulement journalisé et audité comme key.peer.rotate), les options de localité LOCAL_DOMAINS (par défaut [pepsi-ingress] ACCEPTED_DOMAINS), TARGETS et RECIPIENT_DELIMITER, qui servent à refuser le gossip concernant des utilisateurs locaux et à choisir les destinataires locaux à avertir, et un NEXT_STAGE obligatoire. Le message entier est chargé, puisque le matériel de clés s’y trouve. Voir Configuration.
[stage-autocrypt-learn]
PROGRAM = pepsi-stage-autocrypt-learn
NEXT_STAGE = local
52.4. Ce que vaut une clé apprise¶
Une clé apprise vaut délibérément peu. Les clés moissonnées siègent au rang inbound-signed (lorsqu’une signature DKIM réussie et alignée sur From: les couvrait ou, pour un certificat S/MIME qui a signé, lorsque DMARC a réussi) ou inbound, et celles issues du gossip au rang gossip. Ce sont les trois échelons inférieurs de l’échelle de confiance. Une telle clé ne peut jamais déloger une clé venue de la découverte ou d’un opérateur ; une signature vérifiée contre elle est rapportée au mieux valid-untrusted, de sorte qu’elle ne positionne jamais state.signature_verified ; et une ligne peer_key est entièrement ignorée pour une adresse dont cet hôte détient une identité. À l’intérieur de l’un de ces échelons, la règle est le plus récent l’emporte selon la date d’effet Autocrypt du message (une clé d’un échelon inférieur ne remplace jamais celle d’un échelon supérieur). Un correspondant qui réinstalle son client cesse donc de recevoir du courrier chiffré vers une clé qu’il ne détient plus. Cela protège contre un adversaire passif, ce qui est tout ce que revendique Autocrypt. Clés des correspondants énonce ce pour quoi on fait confiance à de telles clés.
52.5. Voir aussi¶
pepsi-stage-decrypt, pepsi-stage-encrypt, pepsi-keydisc, pepsi-keys, Gestion des clés, Quel conteneur S/MIME reçoit un correspondant, Clés des correspondants, pepsi-stage-autocrypt-learn(1).