38. pepsi-stage-decrypt¶
Déchiffrer le courrier adressé à nos utilisateurs, et dire ce que vaut sa signature.
38.1. Rôle¶
pepsi-stage-decrypt est la moitié entrante de la cryptographie de bout en bout de Pepsi. Pour un message adressé à un destinataire que cet hôte sert, elle ouvre tout texte chiffré que le message porte, vérifie toute signature qu’il porte contre une véritable chaîne de confiance, note le verdict, et retire tout indicateur de sécurité que l’expéditeur aurait falsifié. Elle utilise les certificats que porte le message mais n’en stocke aucun. Elle ne fait aucune E/S réseau : lorsque la clé du signataire est inconnue, le message est mis en pause et un service pepsi-keydisc le libère. Ce qu’elle ouvre est classé en clair, à moins que pepsi-stage-reencrypt ne le scelle à nouveau avec la propre clé du client de messagerie du destinataire juste avant la remise. Référence : pepsi-stage-decrypt(1).
Les deux protocoles qu’elle lit sont des normes :
OpenPGP — la RFC 9580 (la refonte cryptographique, remplaçant la RFC 4880) pour la grammaire des paquets et les algorithmes, la RFC 3156 pour les conteneurs PGP/MIME (
multipart/encrypted,multipart/signedet le paramètremicalg). L’OpenPGP en ligne (non MIME) est lu également, mais jamais écrit.S/MIME — la RFC 5652 pour la Cryptographic Message Syntax, la RFC 5083 avec la RFC 5084 pour l”
AuthEnvelopedData(AES-GCM), la RFC 3565 pour l”EnvelopedDataAES-CBC, la RFC 5753 pour l’accord de clés ECDH, la RFC 9709 pour les clés de contenu dérivées avec HKDF sur l’identifiant d’algorithme, et la RFC 8551 pour le profil de message avec la RFC 8550 pour le traitement des certificats. Pour les certificats eux-mêmes, la RFC 5280 couvre la construction du chemin, l’usage étendu de cléemailProtectionet la liaisonrfc822Namequi rattache un certificat à une adresse, et la RFC 9598 la formeSmtpUTF8Mailboxque prend une adresse internationalisée.
Deux limites sont énoncées ici pour qu’on ne les prenne pas pour des défauts. La révocation de certificat échoue en douceur et n’a pas d’OCSP : l’étape elle-même ne récupère rien, mais pepsi-keydisc récupère dans pepsi.crl_cache les CRL (RFC 5280 §5) que nomment les certificats de pairs S/MIME en cache, et l’étape confronte les chaînes de signataires aux listes en cours. Un certificat listé rend la signature invalid (revoked). Une chaîne sans liste utilisable (aucune obtenable, périmée, non signée par la clé de l’émetteur, hors portée) est rapportée comme révocation « non vérifiée », jamais comme « non révoquée ». OCSP (RFC 6960) n’est jamais utilisé. Un signataire qui n’a envoyé aucun certificat intermédiaire est validé avec ceux que pepsi-keydisc a récupérés depuis les pointeurs caIssuers des certificats en cache, lorsque [pepsi-keydiscovery] CA_ISSUERS_FETCH est activé ; un certificat récupéré n’est jamais une ancre. Et un conteneur non authentifié n’est pas rapporté comme bon : l”EnvelopedData AES-CBC ne porte aucun MAC, il s’ouvre donc avec un verdict untrusted plutôt que good, tandis que l”AuthEnvelopedData AES-GCM, que Pepsi émet, est authentifié. Les deux sont listés dans Index des RFC.
Avertissement
Placez cette étape après l’étape ARC et avant les étapes de contenu. La chaîne entrante recommandée est init = arc → decrypt → aliases → (anti-spam / language / …) → local delivery. Un ensemble ARC scelle le message tel qu’il est arrivé ; déchiffrer d’abord ferait décrire à l”AMS scellé des octets que personne d’autre n’a jamais vus. pepsi-setup avertit lorsqu’il trouve une étape ARC atteignable depuis une étape de déchiffrement, et de nouveau lorsqu’aucune étape de remise locale n’est atteignable depuis l’une d’elles.
38.2. Fonctionnalités¶
Elle ne s’exécute que pour les destinataires que cet hôte sert, et n’essaie même pas pour les autres. Le déchiffrement réécrit le corps, ce qui invalide la signature DKIM de l’expéditeur. C’est sans conséquence pour un message sur le point d’être classé dans une boîte aux lettres ici, mais non pour un message relayé plus loin. Un message comportant les deux sortes de destinataires est scindé, de sorte que la copie redirigée soit celle qui est arrivée.
Chaque copie est ouverte avec les clés de son propre destinataire. Un texte chiffré adressé à plusieurs destinataires locaux est d’abord scindé en une ligne par destinataire, de sorte qu’un message destiné à Bob et à quelqu’un d’autre ne peut pas faire ouvrir par la clé de Bob la copie de l’autre destinataire.
Un verdict qui distingue ce qui compte.
validsignifie que la signature est saine et que la clé était ancrée ;valid-untrustedsignifie que la signature est saine mais que la clé n’a pu être rattachée à rien (une clé vue pour la première fois, une CA sans ancre ici). Le courrier signé d’un nouveau correspondant entre souvent dans cette classe, et elle n’est jamais rapportée commevalid.invalid,unverifiableetnonecomplètent l’ensemble, et un message portant plusieurs signatures prend le pire de celles qui couvrent le texte en clair ; une signature enveloppant du texte chiffré ne peut jamais rendre un messagevalid. Une signature OpenPGP à l’intérieur du texte chiffré qui nomme ses destinataires prévus sans nommer la clé qui l’a ouverte ne le peut pas non plus : elle a été signée pour quelqu’un d’autre et rechiffrée vers nous (wrong-recipient, voir À qui était destiné un message signé et chiffré). Ce que les verdicts et les étiquettes d’objet promettent à un utilisateur est exposé dans Ce que signifie un indicateur de sécurité.Les en-têtes protégés sont comparés aux en-têtes extérieurs. Lorsqu’un signataire a placé
From:,To:, un champ d’orientation des réponses (Reply-To:,Mail-Reply-To:,Mail-Followup-To:) ouSubject:à l’intérieur de l’entité signée (en-têtes injectés de la RFC 9788, ou unmessage/rfc822signé), unFrom:protégé qui nomme une autre adresse que leFrom:extérieur rendvalid-untrustedune signature autrement valide, sans étiquette[verified]nistate.signature_verified. Cela attrape un message signé renvoyé sous leFrom:de quelqu’un d’autre. Un champ d’orientation des réponses modifié, ajouté ou retiré en transit fait de même. L’exception est un champ qu’une liste de diffusion a ajouté alors que le signataire n’en avait protégé aucun : la signature reste alorsvalidsous[verified (except reply-to)]. UnSubject:qui n’a fait que gagner des segments entre crochets en tête (une étiquette de liste, un marqueur[external]) ne compte pas comme une différence. Un objet modifié au-delà est signalé et, sur une signature valide, c’est l’objet signé qui est affiché à la place, de sorte que le message reste[verified]sous l’objet qu’a écrit son signataire. UnSubject:protégé portant un indicateur falsifié ([verified] …ou un sosie de celui-ci, que l’assainisseur d’étiquettes d’objet retirerait mais ne peut pas retirer à l’intérieur d’une partie signée) rend aussi la signaturevalid-untrusted(withheld=protected-subject). UnTo:différent est seulement signalé (state.crypto.in.protected_mismatch,protected-mismatchdansX-Pepsi-Crypto). Voir Les en-têtes protégés face aux en-têtes extérieurs.``[verified]`` dit qui, et est accordé pour la ligne ``From:`` telle que la voit le lecteur. L’étiquette nomme l’adresse à laquelle le signataire est lié (
[verified: alice@example.org]). Lorsque l’étiquette est retenue, le verdict estvalid-untrustedetX-Pepsi-Cryptoen donne la raison. Elle est retenue lorsque le nom d’affichage montre une autre adresse, lorsque leFrom:nomme plusieurs boîtes aux lettres, lorsqu’un certificat ancré ne nomme aucune boîte aux lettres (sauf si l’opérateur a inclus cette ancre,pepsi-keys ca accept-nameless), et lorsque le domaine du signataire ressemble à un domaine servi ou à celui d’un correspondant connu. Cette comparaison utilise le même squelette de sosies que le nettoyeur d’étiquettes d’objet, construit à partir des données de confusables UTS #39, et l’A-label va alors dansX-Pepsi-Crypto. Les nomsSmtpUTF8Mailboxde la RFC 9598 sont lus et liés comme le dit cette RFC. Elle est aussi retenue lorsque la signature a été faite plus deMAX_SIGNATURE_AGE_DAYS(7) jours avant l’arrivée du message (withheld=old-signature) ou plus d’un jour après (future-signature) : un message signé capturé et rejoué sous de nouveaux en-têtes extérieurs garde une signature authentique mais n’est pas le message d’aujourd’hui de son signataire. L’heure d’arrivée est celle de cet hôte, jamais le champDate:; l’heure de signature est affichée commesigned-at=dansX-Pepsi-Crypto. Voir Ce à quoi [verified] lie le signataire.Un correspondant qui signe d’habitude est mémorisé. Chaque signature
validconsigne son adresseFrom:danspepsi.signed_sender; un message ultérieur de cette adresse sans signaturevalid, dans les limites deMISSING_SIGNATURE_WINDOW_DAYS(90), est traité selonON_MISSING_SIGNATURE:record(par défaut ;usually-signed=<date>dansX-Pepsi-Cryptoetstate.crypto.in.usually_signed),tag([unsigned, usually signed]) ouquarantine. La valeur par défaut ne fait que consigner, puisqu’un correspondant qui écrit depuis un téléphone ou un nouveau client ressemble exactement à cela. Voir Les correspondants qui signent habituellement.Une signature à l’intérieur d’un texte chiffré est toujours étiquetée. N’importe qui peut renvoyer un texte chiffré capturé, ou chiffrer pour une clé publiée, depuis sa propre adresse. À côté de
[decrypted], une signature saine dont la clé est non fiable ou inconnue reçoit donc l’étiquette[unverified signer], et une mauvaise l’étiquette[bad signature]. Les deux étiquettes sont activées par défaut (TAG_UNVERIFIED_SIGNER,TAG_BAD_SIGNATURE_ENCRYPTED), tandis qu’en dehors d’un texte chiffréTAG_BAD_SIGNATUREreste vide.Un bloc clearsigned vérifié qui montre du texte non signé est ``partial``. Un bloc clearsigned en ligne est remis tel qu’il est arrivé ; lorsqu’il porte une ligne d’en-tête d’armure autre que
Hash:(que le lecteur d’armure accepte sans la hacher) ou se trouve dans une partietext/html, le lecteur voit du texte que la signature ne couvre pas. Le bloc ne reçoit alors ni étiquette nistate.signature_verified; le client du lecteur peut encore le revérifier.Révocation S/MIME depuis les CRL en cache. Une chaîne de signataire est confrontée aux listes de révocation que pepsi-keydisc a récupérées ; un certificat révoqué rend la signature
invalid, et une chaîne sans liste utilisable se lit « non vérifiée ».Les deux chemins d’échec remettent par défaut. Le défaut est
ON_DECRYPT_FAILURE = passthrough, parce que l’utilisateur détient peut-être la clé dans son propre client, et faire rebondir du courrier que nous n’avons simplement pas pu ouvrir n’aide personne. C’estON_BAD_SIGNATURE = record, parce que les listes de diffusion qui réécrivent les corps, les redirecteurs et les clients à la canonicalisation cassée produisent tous de mauvaises signatures sur du courrier légitime.quarantineest disponible pour les deux,bouncepour une mauvaise signature etbounce-if-unproblematicpour un échec de déchiffrement. Aucun des deux rebonds ne répond jamais à la question du remplissage : un texte chiffré en échec ne rebondit que lorsqu’il est protégé en intégrité (OpenPGP,AuthEnvelopedDataS/MIME), une mauvaise signature seulement lorsqu’elle n’est pas issue d’unEnvelopedDataAES-CBC, et tout autre message de ce genre est abandonné (télémétriedecrypt-dropped).ON_DECRYPT_FAILURE = bounceest un alias du plus long mais non ambigubounce-if-unproblematic; le worker etpepsi-setupavertissent au sujet de la graphie courte et demandent la longue. Un DSN d’échec de déchiffrement ne nomme jamais la classe d’échec, et aucune recherche de clé n’est lancée pour une signature trouvée à l’intérieur d’un conteneur non authentifié (CBC), puisque le fait que la recherche atteigne ou non le domaine de l’expéditeur serait le même oracle.AES-CBC peut être laissé au client.
OPEN_ENVELOPED_DATA = no(yes par défaut) transmet sans l’ouvrir chaqueEnvelopedDataS/MIME, commeUNAUTHENTICATED_PLAINTEXT = require-signaturele fait d’unEnvelopedDatanon signé, de sorte que la clé de contenu d’un message AES-GCM capturé resoumis sous un conteneur CBC synthétique ne lui est jamais appliquée. Un conteneur dont la clé est dérivée à la manière de la RFC 9709 (id-alg-cek-hkdf-sha256) est ouvert sous l’une ou l’autre forme ; Pepsi annonce la dérivation dans ses propres signatures. L’option peut être réglée pour une adresse ou un domaine de destinataire via une surcouchepepsi-config; il n’y a pas d’interrupteur par correspondant, parce que l’expéditeur du conteneur n’est connu que par unFrom:extérieur qu’écrit l’attaquant.Le HTML déchiffré est remis en HTML sauf demande contraire.
DECRYPTED_MARKUP = keep(par défaut) laisse le contenu distant d’un message déchiffré authentifié aux propres réglages du client (Contenu distant) ;textréduit chaque texte en clair déchiffré en texte brut, comme c’est toujours le cas pour un texte non authentifié.Une signature réexpédiée ne nous est pas adressée. Une signature OpenPGP dont les Intended Recipient Fingerprints, ou une signature S/MIME dont l’attribut de destinataire Pepsi, omettent le certificat qui a ouvert le message est
invalid(wrong-recipient).Le contenu protégé est d’abord isolé. Avant toute recherche de clé, un message pour un destinataire local qui porte du texte chiffré à côté d’autres parties garde sa première unité chiffrée comme message et voit les autres parties déplacées dans des pièces jointes
application/octet-streaminertes (ISOLATE_ENCRYPTED). Cela arrête l’exfiltration directe EFAIL ici et dans un client qui déchiffre lui-même le message. Un message sans texte chiffré ne garde que son contenu signé à côté du contenu non signé (ISOLATE_SIGNED). Un message joint portant du texte chiffré à côté d’autres parties est réduit de la même manière à l’intérieur de la pièce jointe, sur trois niveaux de messages joints (nested), puisqu’un client l’ouvre et le déchiffre de lui-même. Les deux options sont activées par défaut, et le nombre de parties déplacées qui ont été remises ou abandonnées est consigné commedemoted/dropped.Les indicateurs falsifiés sont retirés, sans condition. Chaque en-tête
X-Pepsi-*est retiré de chaque message entrant, et les propres étiquettes d’objet de cette étape sont retirées du début duSubject, avant que les nôtres ne soient ajoutées.X-Pepsi-Cryptoest un en-tête privé et donc falsifiable par définition ; le retrait est toute la base sur laquelle un client peut y croire. (Pepsi-Originn’est délibérément pas dans cet espace de noms et survit ; leX-Pepsi-Warningde l’ingress sur le bloc d’en-têtes extérieur est conservé, puisque l’ingress retire les copies d’un expéditeur avant de l’ajouter.)Un signal que l’utilisateur voit réellement. L’étape ajoute
[decrypted][verified]en tête duSubject, dans l’ordre d’imbrication. Pour la plupart des utilisateurs, c’est le seul signal qu’ils verront, car peu de gens regardent les champs d’en-tête, et les utilisateurs de webmail presque jamais. Il peut être désactivé, et la formulation est configurable.Les certificats que le message transporte. Les certificats de signataire S/MIME et les parties
application/pgp-keyssont lus dans le message et proposés au vérificateur avant que l’étape ne décide d’attendre ou non une clé, parce que la plupart du courrier signé porte le certificat qui l’a signé. Ils sont utilisés puis abandonnés : stocker les clés du courrier entrant est le rôle de pepsi-stage-autocrypt-learn, qui s’exécute plus tard, après les étapes qui décident si le message est du spam. Un tel certificat ne peut qu’abaisser la valeur d’un verdict, jamais l’élever : une signature vérifiée contre lui estvalid-untrustedet ne positionne jamaisstate.signature_verified.Deux faits notés pour l’étape d’apprentissage. Le déchiffrement écrit le texte clair par-dessus les octets arrivés :
state.crypto.inporte doncencrypted(il y avait du texte chiffré) etouter_gossip(le bloc d’en-têtes à l’arrivée portait déjà un champAutocrypt-Gossip:, que n’importe quoi sur le chemin a pu écrire). Les deux sont des préconditions pour croire le gossip d’un message, et ni l’un ni l’autre ne peut plus être établi une fois le texte clair dans la ligne.Le courrier destiné à la propre clé de l’utilisateur est laissé à son client. Un message chiffré vers la clé MUA enregistrée d’un destinataire (
custody = client, une clé dont la moitié privée ne réside que dans le client de messagerie) est reconnu d’après les identifiants de destinataires du texte chiffré sans être ouvert, et transmis sans être ouvert, même lorsque l’une de nos propres clés pourrait l’ouvrir aussi. Il est notédecryption = for-client, n’est pas un échec de déchiffrement, et ne déclenche donc jamaisON_DECRYPT_FAILURE.Chaque clé non révoquée est essayée, y compris les clés expirées, sélectionnée par capacité (
purposeencryptouboth) plutôt que par forme. L’ancien courrier doit rester lisible : c’est pourquoi une clé de déchiffrement survit à sa propre expiration.
38.3. Où elle se situe¶
ingress → arc → decrypt → aliases → check-whitelist → anti-spam →
detect-language → autocrypt-learn → local delivery
Tout ce qui lit le corps veut du texte clair, et l’obtient parce que le déchiffrement vient tôt. Tout ce qui authentifie le message tel qu’il est arrivé, comme ARC, doit venir avant.
Le placement est aussi une question de performance. L’étape déclare Load::Full, de sorte que chaque message qui la traverse charge tout son corps depuis la base de données, même un message qui s’avère être du courrier ordinaire : le fait qu’un message soit protégé ne se voit pas dans les colonnes d’enveloppe, et Load est fixé par étape. Ce coût est abordable sur un chemin entrant qui se termine par une remise locale, mais ce n’est pas une étape à placer devant du trafic de relais en masse.
38.4. Attendre une clé¶
Lorsque la clé du signataire n’est ni dans le message ni dans le cache peer_key, le message est garé : une demande de découverte est mise en file et un service pepsi-keydisc libère le message lorsqu’elle se conclut, clé trouvée ou non. Ainsi le premier message d’un nouveau correspondant obtient un verdict réel plutôt qu”unverifiable. Une entrée fraîche de cache négatif court-circuite entièrement l’attente, de sorte que seul ce premier message attend jamais.
Le fait qu’un message garé soit stocké déchiffré dépend de la forme du message, et la différence n’est pas cosmétique. Une signature S/MIME imbriquée dans une enveloppe survit au déchiffrement comme une couche MIME ordinaire : le message est donc garé avec le texte clair écrit et déchiffré exactement une fois. Une signature OpenPGP ne vit qu’à l’intérieur du flux de paquets et disparaît dès que le texte clair en est sorti : écrire le texte clair détruirait précisément la preuve pour la vérification de laquelle la clé est récupérée ; un tel message est garé inchangé et déchiffré à nouveau à la reprise.
38.5. Configuration¶
[stage-<name>] : PROGRAM = pepsi-stage-decrypt, NEXT_STAGE (requis) et BOUNCE_STAGE, plus ENABLED, LOCAL_DOMAINS / TARGETS / RECIPIENT_DELIMITER / REQUIRE_ACCOUNT, ON_DECRYPT_FAILURE, ON_BAD_SIGNATURE, ON_MISSING_SIGNATURE, MISSING_SIGNATURE_WINDOW_DAYS, TAG_MISSING_SIGNATURE, MAX_SIGNATURE_AGE_DAYS, UNAUTHENTICATED_PLAINTEXT, DECRYPTED_MARKUP, OPEN_ENVELOPED_DATA, QUARANTINE_STAGE, SUBJECT_TAGS, TAG_DECRYPTED, TAG_VERIFIED, TAG_VERIFIED_EXCEPT_REPLY_TO, TAG_UNAUTHENTICATED, TAG_BAD_SIGNATURE, TAG_BAD_SIGNATURE_ENCRYPTED, TAG_UNVERIFIED_SIGNER, STRIP_SUBJECT_TAGS, STRIP_SUBJECT_KEYWORDS, ADD_RESULT_HEADER, ISOLATE_ENCRYPTED, ISOLATE_SIGNED, MAX_LAYERS, TRUST_ANCHOR_TTL, DISCOVERY et DISCOVERY_TIMEOUT. Toutes sont documentées dans pepsi.conf(5).
Ce sont des options de comportement, redéfinissables par adresse via la table pepsi.settings (indexée, pour le courrier entrant, sur un destinataire d’enveloppe). La politique cryptographique réside dans les options CRYPTO_* de [pepsi] et dans [pepsi-crypto], relève du seul administrateur système, et est délibérément inatteignable depuis pepsi.settings.
L’une d’elles ne s’applique pas dans ce sens : CRYPTO_ALLOW_DOWNGRADE régit ce qui peut être émis. SEIPDv1+MDC et l”EnvelopedData AES-CBC sont lisibles (sauf avec OPEN_ENVELOPED_DATA = no), car les refuser à l’entrée rendrait cet hôte incapable de recevoir du courrier de la majeure partie du monde sans protéger personne.
38.6. Privilège¶
L’étape est installée setuid pepsi-crypto, mode 4750 pepsi-crypto:pepsi, et elle est donc autonome plutôt que pliée dans le binaire pepsi unifié. C’est le même arrangement que pepsi-stage-encrypt, pour les deux mêmes raisons : le rôle de base de données pepsi-crypto est le seul à qui crypto_identity.private_wrapped est accordé et l’authentification par pair de PostgreSQL se fonde sur l”uid effectif, et la clé de chiffrement de clés est un fragment 0640 appartenant au même compte. Voir Gestion des clés pour le modèle de garde, et La frontière de garde des clés privées et Garde par la passerelle (custody = local, la clé de MTA) pour ce que cette frontière protège et ne protège pas.
38.7. État¶
L’étape écrit state.crypto.in : si le message est arrivé chiffré, ce qu’est devenu le texte chiffré (not-encrypted, decrypted, failed ou for-client), quelle identité l’a ouvert, le verdict de signature avec son signataire, son empreinte, sa source de clé, covers_plaintext, binding et bound_to, withheld ou unsigned_surface et son signed_at lorsque valid a été retenu ou que le verdict est partial, la liste ordonnée des couches, isolated, demoted, dropped et nested lorsque l’isolation a modifié le message, protected_mismatch lorsque des champs d’en-tête protégés signés diffèrent de ceux de l’extérieur (subject_promoted lorsque l’objet signé a été affiché à la place), signer_domain pour un domaine de signataire internationalisé ou sosie, et encrypted et outer_gossip pour pepsi-stage-autocrypt-learn. Elle positionne state.encrypted = true pour un message arrivé chiffré et state.signature_verified = true pour le seul verdict valid ; ce sont les deux clés que lisent pepsi-stage-check-whitelist et pepsi-stage-auto-whitelist. Sur un rebond de politique, elle écrit state.bounce avec un code d’état étendu 5.7.0.
38.8. Voir aussi¶
pepsi-stage-encrypt (la moitié sortante), pepsi-stage-arc, pepsi-keys, pepsi-keydisc (le service qui règle les mises en garage que crée cette étape), pepsi-stage-check-whitelist (qui conditionne une ligne de liste blanche au state.signature_verified que positionne cette étape), Gestion des clés, Interopérabilité des clients, Index des RFC, Modèle de sécurité (Le contenu protégé est isolé, Falsification d’en-têtes, Les rebonds et les réponses au courrier chiffré), Ce que signifie un indicateur de sécurité, pepsi.conf(5), pepsi.state(7)