95.1.7. pepsi-stage-decrypt

decrypt mail addressed to our users and verify what signed it

Section du manuel:

1

95.1.7.1.1. Nom

pepsi-stage-decrypt - l’étape entrante de déchiffrement de bout en bout et de vérification de signature du pipeline Pepsi.

95.1.7.1.2. Synopsis

pepsi-stage-decrypt [GLOBAL-OPTIONS] worker

95.1.7.1.3. Description

pepsi-stage-decrypt est un programme d’étape exécuté par pepsi-dispatch(1) comme un worker persistant lisant les identifiants de message sur l’entrée standard. Pour un message adressé à un destinataire que cet hôte sert, il 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é. Il lit les certificats que le message transporte afin de vérifier cette signature, mais n’en stocke aucun : apprendre les clés des correspondants est le travail de pepsi-stage-autocrypt-learn(1), et c’est une étape distincte parce qu’elle doit s’exécuter après le verdict de spam, qui n’existe pas encore ici.

Faire cela sur le serveur est ce qui supprime le besoin d’un greffon côté client : l’utilisateur lit du courrier ordinaire dans son client habituel. Le marché ne tient que parce que le message est sur le point de cesser d’être un objet SMTP pour devenir un fichier dans une boîte aux lettres — voir Localité. Ce fichier est en clair, à moins que le destinataire n’ait enregistré la propre clé de son client de messagerie et que pepsi-stage-reencrypt(1) ne se trouve devant la remise locale, scellant pour cette clé ce que cette étape a ouvert, une fois que les étapes ultérieures l’ont lu.

La moitié vérification est délibérément stricte sur une distinction. Une signature cryptographiquement saine vous dit que le message a été signé par une clé ; savoir si cette clé est celle de l’expéditeur est une question distincte. Les deux ne sont jamais rapportées comme la même chose (Verdicts).

95.1.7.1.4. Localité

L’étape ne s’exécute que pour les destinataires que cet hôte sert, et pour un message qu’il ne sert pas elle n’essaie même pas — une tentative de déchiffrement ratée ne devrait pas colorer le verdict, et de toute façon il n’y a aucune clé pour un tel message.

La raison est que le déchiffrement réécrit le corps. La signature DKIM de l’expéditeur ne vérifie alors plus, et un sceau ARC posé avant le déchiffrement (voir Placement) couvre la forme chiffrée. Pour un message sur le point d’être remis localement, c’est sans conséquence. Pour un message réacheminé plus loin, ce ne l’est pas : il arriverait au saut suivant avec une signature cassée, ce qui est un signal négatif plus fort que pas de signature du tout.

La localité est le même test qu’emploient les étapes de remise — LOCAL_DOMAINS, TARGETS et RECIPIENT_DELIMITER — à une différence près. Par défaut, seul le domaine doit correspondre, car cette étape n’a pas besoin de savoir dans quelle boîte écrire ; un domaine hébergé dont les utilisateurs détiennent des identités cryptographiques mais aucun compte shell est un déploiement ordinaire. Réglez REQUIRE_ACCOUNT = yes pour exiger en outre une entrée passwd dans TARGETS.

Un message ayant à la fois des destinataires locaux et étrangers est scindé : les destinataires étrangers sont détachés sur une ligne sœur à NEXT_STAGE portant le message exactement tel qu’il est arrivé, et cette ligne garde les locaux. L’état DSN par destinataire est découpé en phase par le même code qu’emploie toute autre scission de destinataires.

Un message portant du texte chiffré pour plusieurs destinataires locaux est scindé en un destinataire par ligne avant qu’aucune clé ne soit chargée, et chaque copie n’est ouverte qu’avec les clés de son propre destinataire. Une ligne est ouverte une fois et son texte en clair va à chaque destinataire qu’elle porte. Si elle était ouverte avec les clés de tous ces destinataires, n’importe qui pourrait prendre un texte chiffré capturé en route vers Bob, l’envoyer à Bob et à lui-même (ou à un second utilisateur local), puis le faire déchiffrer et remettre à cet autre destinataire. Un destinataire dont les propres clés ne peuvent pas ouvrir le texte chiffré le reçoit comme un échec de déchiffrement (ON_DECRYPT_FAILURE).

95.1.7.1.5. Placement

La chaîne entrante recommandée est

init = arc -> decrypt -> aliases -> (anti-spam / language / …) -> local delivery

ARC s’exécute d’abord. 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, si bien que le sceau serait une affirmation portant sur un message qui n’a jamais existé. pepsi-setup(1) avertit lorsqu’il trouve une étape ARC atteignable depuis une étape de déchiffrement.

L’inspection du contenu s’exécute après. La détection de langue, la barrière pay-to-send et la vérification de liste blanche sur l’en-tête From: lisent toutes le corps, et toutes ont besoin de texte clair.

Le placement est aussi une question de performance. L’étape déclare Load::Full, car le fait qu’un message soit protégé ne se voit pas dans les colonnes d’enveloppe et Load est fixé par étape. Chaque message qui la traverse charge donc tout son corps depuis la base, même un message qui s’avère être du courrier ordinaire non chiffré. C’est abordable sur un chemin entrant se terminant par une remise locale ; ce n’est pas une étape à placer devant du trafic de relais en masse.

95.1.7.1.6. Verdicts

state.crypto.in.signature.status vaut l’un de :

none

Le message ne porte aucune signature.

valid

Cryptographiquement saine et la clé était ancrée : une chaîne X.509 vers une ancre ca_trust configurée, ou une clé OpenPGP trouvée par WKD ou par DANE avec une réponse validée par DNSSEC, une clé que l’opérateur a ajoutée (pepsi-keys(1) ou l’API), ou notre propre identité pour l’expéditeur — et le signataire est lié à la ligne From: telle que la voit le lecteur (Ce pour quoi valid est accordé).

partial

Serait valid, mais le lecteur se voit montrer, à côté du texte signé, du texte que la signature ne couvre pas. C’est le cas du bloc clearsigned en ligne, qui est remis tel qu’il est arrivé : une ligne d’en-tête d’armure autre que Hash: entre le marqueur BEGIN PGP SIGNED MESSAGE et le texte (le lecteur d’armure accepte là n’importe quelle ligne Key: value et n’en hache aucune), ou un bloc qui est le corps d’une partie text/html, qu’un client rend comme du balisage où une telle ligne peut cacher le texte signé. Le bloc est laissé tel qu’il est venu, afin que le propre client du lecteur puisse le revérifier ; cette étape n’écrit aucune étiquette et ne positionne pas state.signature_verified. X-Pepsi-Crypto indique lequel (unsigned-surface=armor-headers ou html).

valid-untrusted

Cryptographiquement saine, mais la clé n’a pu être rattachée à rien : une clé vue pour la première fois, apprise du message lui-même, d’un en-tête Autocrypt ou du gossip, récupérée d’un serveur de clés (VKS, LDAP) ou de DANE sans validation DNSSEC, ou un certificat d’une AC pour laquelle ce déploiement ne détient aucune ancre. La majeure partie du courrier signé du monde est dans cet état. Également une signature ancrée à laquelle l’une des propres règles de cette étape a refusé valid — une signature sur du texte chiffré seulement, un From: ou un champ d’orientation des réponses protégé qui diffère, un certificat ne nommant aucune boîte aux lettres, un nom d’affichage montrant une autre adresse, un From: à plusieurs boîtes aux lettres, un domaine de signataire qui ressemble à un domaine connu, une signature faite bien avant l’arrivée du message ; withheld= dans X-Pepsi-Crypto et signature.withheld dans l’état indiquent laquelle.

Cela n’est jamais rapporté comme ``valid``. C’est précisément pour faire cette distinction que l’étape existe, et un indicateur de sécurité qui confond les deux est pire que pas d’indicateur du tout.

invalid

La signature ne se vérifie pas sur les octets qu’elle couvre, ou le certificat du signataire est expiré, révoqué, ou lié à une adresse autre que le From: du message. Un certificat S/MIME est jugé au moment où l’étape s’exécute, jamais au signingTime que revendique la signature, et un nom de boîte aux lettres qui n’est pas un simple local@domain ne correspond à aucune adresse From:. Une signature OpenPGP à l’intérieur du texte chiffré qui nomme ses destinataires prévus (l’Intended Recipient Fingerprint de la RFC 9580) sans nommer le certificat qui a ouvert le message est invalid elle aussi, avec le verdict de couche wrong-recipient : elle a été signée pour quelqu’un d’autre, qui l’a rechiffrée vers nous. Une signature S/MIME à l’intérieur du texte chiffré est soumise à la même règle par l’attribut signé privé que Pepsi écrit lorsqu’il signe et chiffre (voir pepsi-stage-encrypt(1)), qui nomme le SHA-256 de chaque certificat destinataire. Une signature qui ne nomme aucun destinataire n’est pas concernée ; aucun autre client S/MIME n’écrit cet attribut.

unverifiable

Aucune clé ni aucun certificat n’était disponible pour le signataire prétendu : rien n’a donc pu être établi dans un sens ou dans l’autre. C’est le verdict qui pousse l’étape à attendre une clé (Découverte de clés).

Un message portant plusieurs couches de signature prend le pire des verdicts des couches qui parlent pour lui. Une signature cassée rend le message invalid, si bonnes que soient les autres. Une couche qui ne couvre que du texte chiffré n’en fait partie que lorsque rien ne couvre le texte en clair (voir ci-dessous) : une telle couche ne peut jamais rendre le message valid, et dès qu’une couche couvre effectivement le texte en clair, elle est entièrement écartée, si mauvaise soit-elle.

Seul valid positionne state.signature_verified, l’indicateur auquel pepsi-stage-check-whitelist(1) subordonne une entrée de liste blanche.

95.1.7.1.6.1. Ce pour quoi valid est accordé

Le vérificateur lie la clé du signataire à la première boîte aux lettres du From: (un User ID OpenPGP, un rfc822Name S/MIME ou un SmtpUTF8Mailbox RFC 9598, ou l”emailAddress du sujet), et une clé qui nomme d’autres adresses est invalid (identity-mismatch). L’étiquette [verified] promet davantage : que le signataire est l’expéditeur tel que le lecteur voit la ligne From:. Une signature qui s’est vérifiée est donc rapportée valid-untrusted au lieu de valid lorsque :

  • le nom d’affichage montre une autre adresse — From: "Alice <alice@victim.example>" <x@attacker.example> signé par la propre clé ancrée de l’attaquant. Jugé d’après le champ lui-même et d’après ce que pepsi-ingress(1) a consigné (state.auth.display_name_mismatch), raison display-name ;

  • le From: nomme plus d’une boîte aux lettres — seule la première est liée, et un client qui en affiche une autre affiche un expéditeur dont rien ne s’est porté garant ; raison multiple-from ;

  • le certificat ne nomme aucune boîte aux lettres et s’enchaîne jusqu’à une ancre ca_trust — il ne contredit aucun From:, de sorte que la liaison ne peut pas le faire échouer, mais il ne se porte garant d’aucune adresse non plus, et serait sinon valid pour tout expéditeur. Raison no-identity. Un opérateur qui sait que le propre processus d’émission d’une AC lie chaque certificat feuille à la boîte aux lettres de son titulaire inclut cette ancre (ca add --accept-nameless, ca accept-nameless de pepsi-keys(1)) ; une clé trouvée en recherchant l’adresse (WKD, DANE, un épinglage, notre propre identité) est liée par la recherche et n’est pas concernée ;

  • le domaine du signataire ressemble à un domaine servi ou connu — son squelette (décomposé, diacritiques retirés, sosies ramenés à leur forme selon les données de confusables UTS #39, le même ramènement qu’utilise le nettoyeur d’étiquettes d’objet) est égal à celui d’un domaine de LOCAL_DOMAINS, d’une adresse du magasin de clés (crypto_identity, peer_key) ou d’une ligne de liste blanche from, alors que le domaine lui-même diffère. Raison lookalike-domain, et l’A-label du domaine est écrit dans X-Pepsi-Crypto (signer-domain=) où un lecteur peut voir ce que cache la forme rendue. Les domaines connus ne sont lus dans la base de données que pour un message qui serait sinon valid, et mis en cache pendant TRUST_ANCHOR_TTL ; le coût est un domaine internationalisé légitime dont le squelette se trouve égal à celui d’un domaine ASCII connu, qui est remis et vérifié mais non étiqueté ;

  • un From: ou un champ d’orientation des réponses protégé (Reply-To:, Mail-Reply-To:, Mail-Followup-To:) diffère, ou le Subject: protégé porte un indicateur falsifié (En-têtes protégés), raisons protected-from, reply-to et protected-subject ;

  • la signature a été faite bien avant l’arrivée du message : son heure de création (l’heure de création de la signature OpenPGP, l’attribut signingTime S/MIME) se situe plus de MAX_SIGNATURE_AGE_DAYS (7 par défaut) jours avant l’heure d’arrivée de la ligne, raison old-signature, ou plus d’un jour après, raison future-signature. Un message signé capturé et rejoué sous un nouveau Subject: ou Date: extérieur est la forme que cela attrape : la signature est authentique, mais elle ne dit pas que son signataire a envoyé ce message à ce moment-là. L’heure d’arrivée est celle que cet hôte a consignée, jamais le champ Date:, qu’écrit celui qui rejoue. Une signature sans heure de création (CMS sans signingTime) n’est pas jugée, et 0 désactive la vérification. Le courrier légitimement remis en retard (une file de modération de liste, un message réexpédié tel quel) ne perd que l’étiquette. X-Pepsi-Crypto montre chaque heure de création consignée (signed-at=) ;

  • la signature ne couvre que du texte chiffré (section suivante), raison ciphertext-cover.

Une signature valid consigne l’adresse à laquelle elle est liée (bound-to, signature.bound_to), qui est ce que nomme l’étiquette.

95.1.7.1.6.2. Une signature qui couvre du texte chiffré

Dans signed(encrypted(body)), la signature est calculée sur le texte chiffré, non sur quoi que ce soit qu’un lecteur verra jamais. Cela prouve que le signataire a transmis le bloc ; cela ne prouve pas qu’il l’a écrit, ni qu’il peut le lire — quiconque obtient un message chiffré peut l’envelopper dans sa propre signature et le réexpédier. Une telle couche est notée avec "covers_ciphertext": true dans state.crypto.in.layers et, quel que soit son propre verdict, elle n’est jamais autorisée à rendre le message ``valid`` : une bonne est rapportée valid-untrusted, elle ne gagne donc aucune marque [verified] et ne positionne pas state.signature_verified. Une mauvaise est rapportée invalid et acheminée sous ON_BAD_SIGNATURE seulement quand c’est tout ce qu’il y a — c’est-à-dire quand aucune couche ne couvre le texte clair.

Dès qu’une couche couvre bel et bien le texte clair, celles qui couvrent le texte chiffré sont entièrement écartées, quel que soit leur propre verdict. Une couche qui ne peut pas accorder un verdict ne doit pas pouvoir en détruire un : quiconque obtient le bloc chiffré peut le ré-envelopper, donc si un emballage corrompu imposait invalid, corrompre l’emballage serait strictement plus utile à un attaquant que de le retirer (ce qui laisse un encrypted(signed(body)) ordinaire qui se vérifie encore). La signature extérieure d’un triple emballage est de toute façon un artefact de saut à saut (dans la RFC 8551 §3.7, c’est un agent de liste de diffusion qui la pose), de sorte que son échec ne dit rien de l’auteur. La falsification n’est pas perdue : elle reste visible dans state.crypto.in.layers et dans X-Pepsi-Crypto, comme une observation plutôt que comme une entrée d’acheminement. Le même raisonnement couvre le cas plus courant d’une signature extérieure simplement unverifiable (pas de clé pour le redirecteur), de sorte que le triple emballage ci-dessous n’est pas puni pour un signataire qu’il se trouve que nous ne connaissons pas.

Ainsi, dans signed(encrypted(signed(body))) — le triple emballage que recommande la RFC 8551 §3.7 — la signature intérieure est celle qui parle pour le contenu, et c’est celle que cette étape rapporte. Cette forme est donc rapportée valid là où une simple signature extérieure ne l’est pas.

Chaque fois qu’il y a un verdict de signature, state.crypto.in.signature note aussi covers_plaintext : true lorsque le verdict a été accordé par une signature sur le texte en clair, false lorsqu’il provient d’une couche enveloppant du texte chiffré. pepsi-stage-autocrypt-learn(1) n’accepte que le premier cas comme preuve qu’un correspondant détient l’une de nos clés.

95.1.7.1.6.3. En-têtes protégés

Un signataire peut couvrir From:, To:, Reply-To:, Mail-Reply-To:, Mail-Followup-To: et Subject: en les plaçant à l’intérieur de l’entité qu’il signe : la forme à en-têtes injectés de la RFC 9788 (la forme protected-headers="v1" qu’écrit pepsi-stage-encrypt(1) sous PROTECT_HEADERS), ou un message/rfc822 signé dont le bloc d’en-têtes intégré les porte. Le lecteur voit les champs extérieurs, qu’aucune signature ne couvre ; l’étape compare donc les deux pour chaque signature sur le texte en clair :

  • Un From: protégé dont l’adresse diffère de celle du From: extérieur (comparées comme addr-specs de la première boîte aux lettres, sans tenir compte de la casse, noms d’affichage et commentaires ignorés) retient valid : la signature est rapportée valid-untrusted (withheld=protected-from), ne reçoit pas d’étiquette [verified] et ne positionne pas state.signature_verified. Le signataire s’est porté garant d’un message de quelqu’un d’autre ; un message signé renvoyé sous un nouveau From: extérieur (réexpédition subreptice) est la forme que cela attrape. Un bloc protégé comportant deux champs From: en désaccord, ou un champ sans adresse lisible, compte comme une différence. Seul le verdict positif est retenu ; invalid et unverifiable sont inchangés. Un logiciel de listes de diffusion qui réécrit le From: extérieur du courrier signé coûte donc à ce courrier son valid, jamais plus.

  • Un champ d’orientation des réponses — Reply-To:, Mail-Reply-To: ou Mail-Followup-To: — qui diffère retient valid de la même manière (withheld=reply-to). Ce sont les champs qu’une attaque par redirection des réponses modifie ou ajoute ; un champ extérieur que le signataire n’a pas protégé compte donc aussi comme une différence, de même qu’un champ signé qui a été retiré. Chacun est comparé comme un ensemble d’addr-specs et signalé sous son propre nom (protected-mismatch=). La seule exception est un champ qu’une liste de diffusion a ajouté — le bloc extérieur porte un List-Id: et le signataire n’a protégé aucun des trois : la signature reste valid et l’étiquette se lit [verified (except reply-to): …] (TAG_VERIFIED_EXCEPT_REPLY_TO, reply-to=unsigned dans X-Pepsi-Crypto), de sorte que le fait essentiel survit et que la réécriture du reply-to continue de fonctionner, au prix d’une étiquette de plus à comprendre, pour les seuls utilisateurs de listes. Le coût de la règle est un client qui protège certains en-têtes mais pas ces champs sur un message dont l’expéditeur en a défini un : un tel courrier perd valid, jamais plus. Sender: n’est pas comparé : les listes et les délégués le définissent légitimement, et les réponses ne vont pas vers lui.

  • Un Subject: qui ne diffère que par des segments entre crochets insérés en tête — une étiquette de liste, un marqueur [external], les propres étiquettes de cette étape sur un message qui a déjà fait un tour — n’est pas une différence. Les deux objets sont d’abord réduits à ce que voit un lecteur (décodage RFC 2047, espaces regroupées, propres étiquettes de cette étape et tout indicateur falsifié retirés de la tête) ; l’objet extérieur est alors accepté lorsque, une fois ses segments […] de tête et ses préfixes de type Re: mis de côté, le reste est l’objet signé, que les préfixes de réponse concordent dans l’ordre, et que chaque segment entre crochets écrit par le signataire est toujours là dans l’ordre — le côté extérieur peut en avoir davantage, avant ou après un Re:. Une différence plus importante est signalée, et lorsque la signature est par ailleurs valid, l”objet signé est affiché à la place de l’objet extérieur (subject=protected dans X-Pepsi-Crypto, state.crypto.in.subject_promoted), de sorte que le message garde [verified] sous l’objet qu’a écrit son signataire. Un marqueur écrit sans crochets, tel que EXTERNAL:, est ainsi retiré ; de même pour tout ce qui a été ajouté en route. La protection des en-têtes remplace par conception le Subject: extérieur, de sorte qu’un ... ou un [...] extérieur n’est pas une différence et que rien n’est promu par-dessus.

  • Un Subject: protégé qui porte un indicateur falsifié retient valid (withheld=protected-subject). L’assainisseur d’étiquettes d’objet (Étiquettes d’objet) est appliqué à l’objet protégé comme à l’objet extérieur ; l’objet extérieur est nettoyé, mais l’objet protégé ne peut pas l’être sans casser la signature, et un client qui affiche les en-têtes protégés l’affiche. Lorsque l’assainisseur le modifierait (une étiquette de sécurité ou un sosie de celle-ci en tête, un symbole d’indicateur, un contrôle bidi), la signature est rapportée valid-untrusted. Un déploiement Pepsi ne fait jamais suivre ses propres étiquettes : une réponse citant [verified: …] quitte pepsi-stage-encrypt(1) sans elle, de sorte qu’une telle réponse garde valid.

  • Les différences de To: sont seulement signalées. Les réexpéditeurs et les listes le modifient légitimement. Comparé comme un ensemble d’addr-specs.

Une signature dont l’entité couverte ne porte aucun de ces six champs n’est pas du tout comparée ; le certificat du signataire est tout de même lié au From: extérieur comme décrit sous invalid. Une couche qui couvre du texte chiffré n’a pas de bloc d’en-têtes en clair et n’est jamais comparée. Les noms des champs qui diffèrent sont consignés comme state.crypto.in.protected_mismatch et dans X-Pepsi-Crypto comme protected-mismatch (from, to, reply-to, mail-reply-to, mail-followup-to, subject). Hormis la promotion de l’objet ci-dessus, les copies protégées ne sont jamais promues dans le bloc d’en-têtes remis.

95.1.7.1.7. Traitement des échecs

Les deux chemins d’échec remettent par défaut, conformément à la posture fail-open délibérée de Pepsi sur le SPF, le DKIM et le DMARC entrants :

ON_DECRYPT_FAILURE = passthrough

Le message, toujours chiffré, est remis. L’utilisateur détient peut-être la clé dans son propre client, et renvoyer du courrier que nous n’avons simplement pas pu ouvrir n’aide personne. quarantine et bounce-if-unproblematic sont disponibles. La valeur bounce est un alias du plus long mais non ambigu bounce-if-unproblematic : le rebond n’est envoyé que pour les messages auxquels l’oracle CBC ne s’applique pas parce que le message n’est pas chiffré en CBC. Le worker et pepsi-setup(1) avertissent lorsque la graphie courte est utilisée.

ON_BAD_SIGNATURE = record

Une mauvaise signature est un verdict noté, jamais un échec de remise. 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 parfaitement légitime ; les mettre en quarantaine coûterait bien plus que cela n’attrape. quarantine et bounce sont disponibles ; bounce abandonne, au lieu de le faire rebondir, un message dont la signature est issue d’un texte chiffré sans protection d’intégrité (voir ci-dessous).

Notez que seule invalid est une « mauvaise signature » à cet effet. valid-untrusted et unverifiable sont l’état normal du courrier d’un correspondant dont personne ici n’a jamais entendu parler, et les acheminer quelque part reviendrait à acheminer la majeure partie de l’internet.

La politique de déchiffrement est consultée d’abord : un message qui n’a pas pu être ouvert n’a aucun verdict de signature sur lequel il vaille la peine d’agir.

95.1.7.1.7.1. Correspondants qui signent d’habitude

Une signature ne protège contre un From: falsifié que si son absence est remarquée. Chaque fois qu’une signature obtient valid – une clé ancrée liée à l’adresse From: –, l’étape consigne l’adresse, la clé de signature et l’heure dans pepsi.signed_sender. Seul valid y écrit, de sorte que personne ne peut créer ni rafraîchir l’enregistrement d’une adresse dont il ne détient pas la clé ancrée.

Un message ultérieur de cette adresse qui ne porte aucune signature valid (non signé, unverifiable, valid-untrusted ou partial), dans les limites de MISSING_SIGNATURE_WINDOW_DAYS (90 par défaut) après la dernière signature valide, est traité selon ON_MISSING_SIGNATURE :

record (par défaut)

X-Pepsi-Crypto reçoit usually-signed=<date of the last valid signature> et state.crypto.in.usually_signed le consigne, pour les règles Sieve et les extensions des clients ; rien d’autre ne change. Un correspondant qui écrit depuis un téléphone ou un nouveau client produit exactement cette forme, raison pour laquelle rien de plus fort n’est la valeur par défaut.

tag

Ajoute aussi TAG_MISSING_SIGNATURE (par défaut [unsigned, usually signed]) en tête du Subject.

quarantine

Achemine le message vers QUARANTINE_STAGE.

Une signature invalid relève d”ON_BAD_SIGNATURE, et un message que cette étape n’a pas ouvert (un échec de déchiffrement, du courrier pour la propre clé client de l’utilisateur, un texte en clair retenu sous UNAUTHENTICATED_PLAINTEXT) n’est pas jugé, puisque sa signature n’a pas pu être vue. MISSING_SIGNATURE_WINDOW_DAYS = 0 désactive la vérification ; les signatures valides sont tout de même consignées. Une erreur de base de données lors de la lecture ou de l’écriture de l’enregistrement est journalisée et traitée comme une absence d’enregistrement. Télémétrie decrypt-missing-signature.

95.1.7.1.7.2. Informer un expéditeur de l’échec du déchiffrement

Un rebond pour chaque déchiffrement échoué indiquerait à quiconque a envoyé le message s’il a pu être ouvert. Pour un texte chiffré sans protection d’intégrité, un EnvelopedData S/MIME en AES-CBC ou 3DES, c’est un oracle de déchiffrement. Un attaquant qui a capturé un message chiffré pour l’un de nos utilisateurs en renvoie des copies modifiées sous son propre expéditeur d’enveloppe ; qu’une copie rebondisse ou non indique si son remplissage CBC modifié était valide, et environ 2 000 copies déchiffrent un bloc de 16 octets (une attaque par oracle de remplissage). Le courrier AES-GCM envoyé sans la dérivation de clé de la RFC 9709 peut être réemballé en CBC sous le même transport de clé, de sorte que l’oracle l’atteindrait aussi. Aucun réglage de l’étape ne donne cette réponse.

ON_DECRYPT_FAILURE = bounce-if-unproblematic garde le rebond là où il ne trahit rien. Il ne fait rebondir un message que lorsque le texte chiffré qui a échoué est protégé en intégrité — chaque conteneur OpenPGP qu’accepte Pepsi, et l”AuthEnvelopedData S/MIME —, parce qu’alors chaque texte chiffré modifié échoue de la même manière et l’expéditeur apprend seulement qu’il l’a modifié. Le conteneur est lu dans le DER du texte chiffré, jamais dans l’étiquette smime-type, qu’écrit l’expéditeur. Le diagnostic du DSN dit seulement que le message n’a pas pu être déchiffré ; la classe d’échec (no-decryption-key, decryption-failed, malformed) va au journal et à X-Pepsi-Crypto pour l’opérateur, jamais dans le DSN, puisque la classe dans laquelle tombe un texte chiffré modifié serait elle-même un oracle de format. Tout autre message en échec (CBC, 3DES, ou un conteneur que personne n’a pu identifier) est abandonné et journalisé : un DSN, ou son absence, serait l’oracle. L’abandon coûte à l’expéditeur d’un message CBC légitime l’avis qu’il n’a pas été lu ; avec passthrough, ce message aurait plutôt été remis chiffré, raison pour laquelle passthrough reste la valeur par défaut.

ON_BAD_SIGNATURE = bounce reçoit le même traitement. Un gadget CBC peut faire paraître signé un texte en clair altéré ; pour un contenu issu d’un conteneur EnvelopedData, une mauvaise signature, et avec elle le rebond, dépend donc du remplissage. Un tel message est abandonné et journalisé à la place (télémétrie decrypt-dropped) ; une mauvaise signature issue d’un conteneur authentifié, ou sur un message qui n’était pas chiffré, rebondit toujours. pepsi-stage-reencrypt(1) applique la même règle à ON_NO_CLIENT_KEY = bounce, dont le rebond ne serait envoyé que pour un message qui s’est ouvert.

Le même raisonnement explique pourquoi l’étape ne lance aucune découverte de clé pour une signature à l’intérieur d’un contenu issu d’un texte chiffré sans protection d’intégrité (voir Découverte de clés).

Une clé de destinataire que cet hôte détient mais ne peut pas ouvrir — une clé de chiffrement de clés qui ne correspond pas au blob stocké, un fragment secrets.d disparu, un droit de base de données révoqué — aboutit aussi à decrypt-failure=no-decryption-key et prend la route ON_DECRYPT_FAILURE, exactement comme un message adressé à une clé que nous n’avons jamais eue. C’est délibéré (une identité cassée ne doit pas empêcher d’essayer les autres), mais c’est un déploiement cassé et non le fait de l’expéditeur, si bien que chacune de ces identités est journalisée au niveau error avec l’adresse et la raison. Il en va de même pour les destinataires qui détiennent des identités de déchiffrement sur un hôte où aucune [pepsi-crypto] KEY_WRAP_SECRET n’est configurée.

95.1.7.1.8. Erreurs de cet hôte

Tout le reste de ce qui tourne mal sur cet hôte est réessayé plutôt que mis en échec (voir pepsi-dispatch(1)) : lorsque la base de données ne peut pas répondre, le message est mis en pause et réessayé jusqu’au MAX_LIFETIME de l’étape. Cela vaut aussi pour la recherche des propres clés MUA des destinataires, qui n’est jamais interprétée comme « pas de telle clé », puisque cela ouvrirait du courrier destiné au client de l’utilisateur lui-même. La section de l’étape, la politique crypto [pepsi], [pepsi-keydiscovery] et, lorsqu’une clé de chiffrement de clés est configurée, le trousseau construit à partir d’elle sont vérifiés au démarrage du worker : un élément qui ne fonctionne pas fait refuser au worker de démarrer (sortie 78), de sorte que le dispatcher retient la file au lieu que chaque message échoue sur la même défaillance. Un message qui fait planter la cryptographie (une panique pendant son analyse) est mis en échec immédiatement : c’est le fait du message, et il ne ferait que planter de nouveau.

95.1.7.1.9. Isolation du contenu protégé

Avant de rechercher une clé ou d’ouvrir quoi que ce soit, l’étape réduit un message pour un destinataire local à son contenu protégé. Deux règles s’appliquent, chacune avec son propre interrupteur :

ISOLATE_ENCRYPTED = yes (par défaut)

Lorsque le message porte une unité chiffrée – un multipart/encrypted PGP/MIME, une partie application/pkcs7-mime qui est ou peut être du texte chiffré, ou un bloc en ligne -----BEGIN PGP MESSAGE----- – à côté de tout autre contenu, la première unité chiffrée devient le message et tout le reste est déplacé dans des pièces jointes inertes. L’unité conservée devient le corps sous les champs d’en-tête d’origine du message ; un bloc en ligne devient une partie text/plain ne contenant que l’armure, et le texte qui l’entourait devient une pièce jointe à part entière. Chaque partie déplacée est réécrite en application/octet-stream avec Content-Disposition: attachment, un nom de fichier assaini (celui de l’expéditeur, ou part-N.html, message-N.eml, encrypted-N.asc et autres), un Content-Description indiquant que Pepsi l’a déplacée et que la protection du message ne la couvre pas, et sans Content-ID, Content-Location ni Content-Base, de sorte que le corps ne puisse pas la réintégrer par référence. Une partie qui est déjà une telle pièce jointe est conservée octet pour octet. Nous le faisons pour éviter l’exfiltration directe EFAIL : un attaquant qui a capturé un texte chiffré l’enveloppe entre deux parties HTML qui ouvrent et ferment une URL d’image, et un client de messagerie qui rend la partie déchiffrée avec ses voisines envoie le texte en clair au serveur de l’attaquant. Aucun client ne rend en ligne une pièce jointe application/octet-stream, de sorte qu’il ne reste rien où insérer le texte en clair, tandis qu’une vraie pièce jointe arrive toujours. L’étiquette propre de l’expéditeur n’est pas digne de confiance à cet égard : les clients courants affichent en ligne une partie text/* même lorsqu’elle est marquée comme pièce jointe, de sorte que chaque partie déplacée est réécrite (la RFC 9787 section 6.2.2 exige de même qu’une partie déchiffrée trouvée à l’intérieur d’un autre contenu soit tenue à l’écart de tout le reste). Les autres textes chiffrés sont aussi déplacés, puisqu’un attaquant peut chiffrer les deux moitiés HTML pour la clé publique du destinataire ; un texte chiffré arrivé comme pièce jointe inerte ne devient jamais le message. Comme la réduction a lieu avant le déchiffrement, elle protège aussi le courrier que l’étape n’ouvre pas – un message pour lequel elle ne détient aucune clé, ou un message chiffré pour la propre clé MUA de l’utilisateur (Courrier pour la propre clé de l’utilisateur) –, dont le déchiffrement est alors fait par un client qui peut lui-même être vulnérable. Ce qui est remis est exposé sous Parties déplacées.

ISOLATE_SIGNED = yes (par défaut)

Lorsque le message ne porte aucun texte chiffré mais un contenu signé — un multipart/signed, un SignedData S/MIME opaque ou un bloc clearsigned en ligne — à côté d’un contenu non signé, le contenu non signé est abandonné (plusieurs unités signées sont conservées ensemble dans un multipart/mixed). Nous le faisons pour qu’un verdict de signature, et l’étiquette [verified], parle pour tout ce que voit l’utilisateur : une signature valide sur une partie ne doit pas prêter son verdict à un texte qu’un inconnu a placé à côté d’elle, avant ou après.

Un conteneur de signature dont le seul contenu est le texte chiffré (signed(encrypted(body)), le triple enveloppement de la RFC 8551) est une structure, non un autre contenu, et reste intact. Un message joint (message/rfc822, message/global) est un message différent, qu’un client ouvre – et déchiffre – de lui-même. Sous ISOLATE_ENCRYPTED, chaque message joint qui porte une unité chiffrée à côté d’un autre contenu est donc d’abord réduit selon la même règle : sa première unité chiffrée reste, tout le reste devient des pièces jointes inertes à l’intérieur de celui-ci, et il reste un message joint. Cela est suivi sur trois niveaux de messages joints ; un message imbriqué plus profondément qui porte encore du texte chiffré devient entièrement une pièce jointe .eml inerte. Le message joint réduit va ensuite là où va toute autre partie : à côté d’un texte chiffré de premier niveau, il est déplacé dans une pièce jointe .eml, qui contient la forme réduite, et sous ISOLATE_SIGNED il est abandonné. Une signature sur un conteneur contenant un tel message joint ne se vérifie pas, puisque le lecteur ne reçoit pas ce qui a été signé. L’entité conservée garde sinon ses propres octets, de sorte qu’une signature sur elle se vérifie toujours.

Les deux règles sont appliquées à nouveau à chaque texte en clair que l’étape récupère, de sorte qu’un texte chiffré imbriqué à côté de parties de l’attaquant à l’intérieur d’un autre texte chiffré, ou un texte en clair partiellement signé, est réduit de la même manière avant l’ouverture de la couche suivante, et les parties déplacées hors du texte en clair rejoignent les autres. Une réduction est consignée comme state.crypto.in.isolated (encrypted, signed) et comme isolated= dans X-Pepsi-Crypto ; combien de parties déplacées ont été remises et combien abandonnées, comme demoted/dropped aux deux endroits, et combien de messages joints ont été réduits, comme nested.

95.1.7.1.9.1. Parties déplacées

Ce que reçoit le destinataire dépend de deux choses : l’étape ouvre-t-elle le texte chiffré qu’elle a conservé, et ce texte en clair est-il signé ?

  • Ouvert, non signé. Le texte en clair est le corps et chaque partie déplacée le suit comme pièce jointe. Un texte chiffré déplacé est ouvert avec les mêmes clés (jusqu’à 16 par message) et remis sous forme de son texte en clair, là encore en pièces jointes inertes : un texte en clair à une seule partie garde le nom de fichier du texte chiffré sans son suffixe .pgp, .gpg, .asc ou .p7m (report.pdf.pgp arrive comme report.pdf), un texte en clair à plusieurs parties devient une pièce jointe par partie. Un texte chiffré qui ne peut pas être ouvert est remis comme pièce jointe chiffrée.

  • Ouvert, signé. La signature ne doit pas paraître se porter garante de ce que quelqu’un d’autre a placé à côté du message ; les parties en clair déplacées sont donc abandonnées, et un texte chiffré déplacé n’est conservé que lorsque son propre texte en clair porte une signature valid ou valid-untrusted faite par la même clé que celle du message. C’est le pendant chiffré d”ISOLATE_SIGNED : le contenu non signé n’est abandonné que là où contenus signés et non signés sont mêlés.

  • Non ouvert (pas de clé, un échec, ou la propre clé MUA de l’utilisateur). Un conteneur PGP/MIME ou S/MIME est remis seul, à la racine du message, là où les clients le cherchent (Thunderbird n’ouvre S/MIME qu’à cet endroit), et les parties déplacées sont abandonnées. Les vraies pièces jointes d’un expéditeur se trouvent à l’intérieur d’un tel conteneur, de sorte que ce qui est perdu n’est que ce qui a été ajouté autour, comme un pied de page de liste de diffusion. Un bloc en ligne garde les parties déplacées comme pièces jointes, parce que c’est ainsi que le PGP en ligne transporte des fichiers.

Un message dont la clé du signataire est en cours de recherche (voir Découverte de clés) n’est pas validé en texte en clair tant qu’il a des parties déplacées, puisque celles qui peuvent rester dépendent du verdict ; il est déchiffré à nouveau lors de sa reprise.

Les règles coûtent encore du contenu dans deux cas, raison pour laquelle chacune peut être désactivée : un pied de page de liste de diffusion ajouté en dehors d’une signature, ou autour d’un conteneur que cet hôte n’ouvre pas, est perdu ; et une note en clair à côté d’un fichier chiffré séparément n’est conservée que lorsque la note n’est pas signée. Le courrier pour des destinataires que cet hôte ne sert pas n’est jamais réduit (il est transmis tel qu’il est arrivé, voir Localité).

95.1.7.1.10. Courrier pour la propre clé de l’utilisateur

Un utilisateur peut enregistrer sa propre clé, dont la moitié privée ne réside que dans son client de messagerie (une clé MUA, crypto_identity.custody = client ; voir pepsi-stage-encrypt(1) et pepsi-keys(1)). Le courrier chiffré pour une telle clé est destiné au client de messagerie, et l’étape le reconnaît avant de tenter d’ouvrir quoi que ce soit : elle lit les identifiants de destinataires du texte chiffré (identifiants de clé PKESK OpenPGP, RecipientIdentifiers S/MIME) sans déchiffrer et les compare aux clés client non révoquées des destinataires. Un identifiant de clé joker (« destinataire caché ») ne correspond à rien et suit le chemin ordinaire.

En cas de correspondance, le message est transmis sans être ouvert, même lorsque l’une de nos propres clés MTA figure elle aussi parmi ses destinataires : l’utilisateur a enregistré sa propre clé pour obtenir une protection de bout en bout, et ouvrir une copie sur le serveur puis stocker le texte en clair dans la boîte aux lettres l’annulerait silencieusement. L’étape note state.crypto.in.decryption = for-client, for_client = true et client_fingerprint, positionne state.encrypted et ajoute for-client=yes à X-Pepsi-Crypto. Ce n’est pas un échec de déchiffrement : ON_DECRYPT_FAILURE n’est donc pas consulté, et le message avance vers NEXT_STAGE comme n’importe quel autre : les vérifications anti-spam et le reste du pipeline décident toujours de son sort. Un message ayant plusieurs destinataires locaux a déjà été scindé à raison d’un par ligne (voir ci-dessus), de sorte que la clé client d’un destinataire ne dit rien de la copie d’un autre.

La conséquence est que les fonctionnalités côté serveur ne peuvent pas voir l’intérieur d’un tel courrier. Les étapes qui lisent le contenu (la détection de langue, par exemple) voient du texte chiffré et se replient comme pour tout message indéchiffrable, et rien n’a été vérifié : state.signature_verified n’est donc jamais positionné et une entrée de liste blanche avec signature_required ne lui correspond pas.

95.1.7.1.11. Anti-falsification

Chaque champ d’en-tête X-Pepsi-* est retiré de chaque message que cette étape voit — y compris d’un message qu’elle ne va pas toucher, et d’un message pour lequel l’étape est désactivée. C’est seulement ensuite que le nôtre est ajouté. La seule exception est X-Pepsi-Warning sur le bloc d’en-têtes extérieur : pepsi-ingress(1) ne l’écrit qu’après avoir retiré chaque copie écrite par un expéditeur ; il est donc conservé pour le lecteur (une copie à l’intérieur d’un contenu déchiffré est retirée avec le reste).

X-Pepsi-Crypto est un en-tête privé, donc falsifiable par définition ; le retrait inconditionnel est toute la base sur laquelle un client peut y croire. L’en-tête de preuve d’origine Pepsi-Origin n’est délibérément pas dans cet espace de noms et survit.

Le même argument vaut pour le Subject. Avec STRIP_SUBJECT_TAGS = yes (la valeur par défaut), tout ce qui s’afficherait comme un indicateur de sécurité est retiré du début d’un objet entrant avant que le nôtre ne soit ajouté en tête ; sinon, un expéditeur extérieur écrit tout simplement [verified] lui-même. L’objet est jugé d’après ce qu’affiche un client de messagerie, non d’après ses octets :

  • les encoded-words RFC 2047 sont d’abord décodés, de sorte que =?UTF-8?B?W3ZlcmlmaWVkXQ==?= compte comme [verified] ;

  • le texte est comparé selon son squelette : décomposé en compatibilité (les crochets pleine chasse deviennent ASCII), sans accents, chaque caractère ramené à son prototype selon les données de confusables complètes de l’Unicode Technical Standard #39 (les sosies du cyrillique, du grec, de l’arménien, du cherokee et de toute autre écriture ; m se lit rn), petites capitales et substitutions de chiffres ramenées à la lettre qu’elles imitent, et en minuscules ;

  • sont retirés : le propre vocabulaire d’étiquettes de cette étape (chaque option TAG_*, les intégrés [decrypted], [verified], [decrypted, unauthenticated], [unverified signer], [bad signature] et [verified (except reply-to)], la forme à adresse [verified: …] entière quelle que soit la longueur de son adresse, et STRIP_SUBJECT_KEYWORDS), reconnu par squelette ; tout groupe entre crochets, ASCII ou Unicode, contenant un mot qui est, ou est à une lettre près, un mot de sécurité (verified, decrypted, encrypted, signed, signature, secure, trusted, authentic et leurs formes proches) ou un mot de nos propres étiquettes ; une revendication de tête à la manière de Verified: ; les symboles de coche, de cadenas, de clé et de bouclier ; et les caractères invisibles (caractères de largeur nulle, indicateurs d’ordre des octets, traits d’union conditionnels) ;

  • les contrôles bidirectionnels d’incorporation, de forçage et d’isolement sont retirés de tout l’objet, puisqu’ils peuvent faire s’afficher du texte situé n’importe où dans la ligne comme une étiquette en son début.

Les étiquettes sont retirées du début de l’objet, de derrière les préfixes Re:/Fwd: et de derrière des groupes entre crochets sans rapport tels qu’une étiquette de liste de diffusion ; un objet qui mentionne [verified] au milieu d’une phrase le garde. La règle penche du côté du retrait : un objet légitime qui commence par [Signed contract] perd ce préfixe. Le même nettoyage est appliqué à l’objet du propre bloc d’en-têtes d’un message déchiffré (un objet protégé remplace l’objet extérieur) et au courrier transmis sans être ouvert pour la propre clé de l’utilisateur. Un objet qui n’a besoin d’aucune modification est laissé octet pour octet.

95.1.7.1.12. Étiquettes d’objet

Avec SUBJECT_TAGS = yes (la valeur par défaut), les marques méritées sont ajoutées en tête du Subject dans l”ordre d’imbrication

encrypted(signed(body))   ->  [decrypted][verified] quarterly figures
signed(encrypted(body))   ->  [verified][decrypted] quarterly figures

Les deux formes s’ouvrent. La seconde ligne énonce la règle d’ordre ; notez que le second exemple ne gagne son [verified] que d’une signature intérieure, car une signature extérieure sur du texte chiffré n’atteint jamais le verdict valid pour lequel la marque est écrite (Une signature qui couvre du texte chiffré). Un message signed(encrypted(body)) sans signature intérieure est donc marqué du seul [decrypted].

Pour la plupart des utilisateurs, c’est le seul signal qu’ils verront jamais — personne lisant son courrier dans un client webmail n’inspecte les en-têtes — de sorte que faire le travail invisiblement le gaspillerait. Le prix est qu’un champ visible par l’utilisateur est modifié : cela affecte la recherche, l’enfilage et l’objet cité des réponses. Réglez SUBJECT_TAGS = no pour vous fier au seul en-tête.

[verified] n’est écrit que pour le verdict valid, et il nomme l’adresse à laquelle le signataire est lié, à l’intérieur du crochet fermant

[verified: alice@example.org] quarterly figures

[verified] seul dit seulement que quelqu’un disposant d’une clé ancrée a signé, et le lecteur devrait encore se fier à une ligne From: dont l’expéditeur écrit le nom d’affichage à sa guise ; avec l’adresse dans l’étiquette, l’unique champ que chaque client affiche dit qui a signé. (Un TAG_VERIFIED écrit sans crochet fermant reçoit l’adresse ajoutée après un deux-points.) Lorsqu’une liste de diffusion a ajouté le Reply-To: (ou Mail-Followup-To:) extérieur en dehors de la signature (En-têtes protégés), l’étiquette est à la place TAG_VERIFIED_EXCEPT_REPLY_TO, [verified (except reply-to): alice@example.org] : le fait essentiel survit, et l’unique champ que la signature ne couvre pas est nommé.

Une signature à l’intérieur d’un texte chiffré est étiquetée quel que soit son verdict. N’importe qui peut renvoyer un texte chiffré capturé, ou chiffrer pour une clé publiée, depuis une adresse à lui ; le lecteur verrait sinon [decrypted] et rien qui dise que le signataire n’est pas l’expéditeur, et une réponse qui cite renvoie le texte en clair à celui qui l’a envoyé. Une signature à cet endroit qui est saine mais non valid — une clé non fiable ou inconnue, une couverture partial — reçoit donc TAG_UNVERIFIED_SIGNER ([unverified signer]), et une mauvaise signature TAG_BAD_SIGNATURE_ENCRYPTED ([bad signature]), toutes deux activées par défaut (none fait taire l’une ou l’autre)

encrypted(signed(body)), untrusted key  ->  [decrypted][unverified signer] …
encrypted(signed(body)), bad signature  ->  [decrypted][bad signature] …

En dehors d’un texte chiffré, TAG_BAD_SIGNATURE est vide par défaut : une mauvaise signature est une propriété courante du courrier légitime (une liste réécrit les corps), de sorte qu’une étiquette activée par défaut décorerait d’une accusation une grande partie de la boîte de réception d’un utilisateur. Cet argument ne vaut pas à l’intérieur d’un texte chiffré — une liste ne peut pas réécrire un corps qu’elle ne peut pas lire —, raison pour laquelle les deux ont des valeurs par défaut distinctes. Une signature en clair non fiable ou invérifiable ne reçoit aucune étiquette.

Chaque forme qu’écrit cette étape, la forme à adresse comprise, est retirée d’un objet entrant avant que la nôtre ne soit ajoutée, quelle que soit la longueur de l’adresse qu’un expéditeur met dans une étiquette falsifiée.

95.1.7.1.13. L’en-tête de résultat

Avec ADD_RESULT_HEADER = yes (la valeur par défaut), un message qui portait une protection quelconque gagne un champ d’en-tête, ajouté tout en haut afin de ne perturber aucune signature existante

X-Pepsi-Crypto: encrypted=yes; decrypted=yes; protocol=openpgp;
  signature=valid; signer=alice@example.net;
  fingerprint=0123456789ABCDEF; key-source=wkd; trust=wkd;
  layers="encrypted,signed"

La grammaire est faite de paires key=value séparées par des points-virgules, dans un ordre fixe. Une valeur qui n’est pas un jeton nu (A–Z, a–z, 0–9 et . _ @ : + / -) est mise entre guillemets doubles ; un " incorporé devient ', et les caractères de contrôle sont remplacés par des espaces, de sorte qu’aucune valeur issue du message ne puisse terminer le champ ni en commencer un autre. Les valeurs longues sont repliées aux espaces.

Les clés sont :

encrypted

yes/no — le message est arrivé porteur d’un texte chiffré. Ce qui compte est le flux de paquets, non l’étiquette : un PGP MESSAGE armuré (ou un corps multipart/encrypted) qui ne contient qu’un paquet OpenPGP littéral ou signé s’ouvre sans aucune clé, son contenu est remis, et il est rapporté encrypted=no, sans étiquette [decrypted] et sans identité consignée comme l’ayant ouvert. Une signature à l’intérieur est tout de même vérifiée.

decrypted

yes/no — présent uniquement lorsque encrypted=yes.

for-client

yes lorsque le message est chiffré pour la propre clé MUA du destinataire et a été transmis sans être ouvert (Courrier pour la propre clé de l’utilisateur).

protocol

openpgp ou smime.

container

Le conteneur de chiffrement de contenu du texte chiffré ouvert, tel que le déchiffreur l’a lu dans les octets : auth-enveloped-data ou enveloped-data (S/MIME), seipdv2-aead ou seipdv1-mdc (OpenPGP). Seul enveloped-data est dépourvu de protection d’intégrité. Présent lorsqu’un texte chiffré a été ouvert.

signature

L’un des verdicts ci-dessus.

signer, fingerprint, key-source, trust, algorithm

La clé de signature, sa provenance et sa valeur. key-source et trust portent tous deux le mot de provenance du vérificateur (anchor, dane, wkd, pinned, autocrypt, attached ou unknown). Présents seulement lorsqu’ils sont connus.

binding

La relation entre la clé du signataire et l’adresse From: telle que l’a vue le vérificateur : matched, mismatched ou no-identity (la clé ne nomme aucune adresse). Présent lorsqu’une clé a été trouvée.

anchor

L’empreinte de l’ancre ca_trust à laquelle s’est terminée la chaîne du signataire. Présent pour une signature S/MIME ancrée.

bound-to

L’adresse à laquelle une signature valid est liée — l’adresse From: telle qu’écrite, que nomme l’étiquette. Présent seulement pour valid.

signed-at

L’heure de création que revendique la signature, sous forme d’horodatage UTC RFC 3339 (2026-10-20T09:00:00Z). Présent lorsque la signature en porte une. C’est la revendication du signataire, comparée seulement à l’heure d’arrivée de cet hôte (MAX_SIGNATURE_AGE_DAYS).

withheld

Pourquoi une signature qui s’est vérifiée est valid-untrusted plutôt que valid : ciphertext-cover, protected-from, protected-subject, reply-to, no-identity, display-name, multiple-from, lookalike-domain, old-signature ou future-signature (Ce pour quoi valid est accordé). Présent seulement dans ce cas.

unsigned-surface

Pourquoi un bloc clearsigned vérifié est partial : armor-headers ou html. Présent seulement dans ce cas.

reply-to

unsigned lorsque la signature est valid et que le Reply-To: extérieur (ou Mail-Reply-To:, Mail-Followup-To:) a été ajouté par une liste de diffusion en dehors d’elle (l’étiquette [verified (except reply-to)]). Présent seulement dans ce cas.

signer-domain

Le domaine du signataire sous forme d’A-label, lorsqu’il s’agit d’un nom de domaine internationalisé ou qu’il ressemble à un domaine connu. Présent seulement dans ce cas.

usually-signed

La date (UTC, YYYY-MM-DD) à laquelle une signature valid de l’adresse From: s’est vérifiée pour la dernière fois, sur un message qui n’en porte aucune (Correspondants qui signent d’habitude). Présent seulement dans ce cas ; un message ne portant que cette clé reçoit aussi l’en-tête.

failure

La raison lisible par une machine pour laquelle un verdict de signature n’est pas bon.

decrypt-failure

La raison lisible par une machine pour laquelle le déchiffrement a échoué.

unauthenticated

yes lorsque le texte en clair est issu d’un conteneur sans protection d’intégrité et qu’aucune signature valide ne le couvre (Texte en clair issu d’un conteneur malléable). Présent seulement dans ce cas.

sanitised

text lorsque le texte en clair a été réduit à un contenu qu’aucun client ne rend comme du balisage (UNAUTHENTICATED_PLAINTEXT = text, ou DECRYPTED_MARKUP = text pour tout texte en clair déchiffré). Présent seulement dans ce cas.

isolated

Quelles règles de Isolation du contenu protégé ont modifié le message (encrypted, signed), séparées par des virgules. Présent seulement lorsque l’une l’a fait.

protected-mismatch

Les champs d’en-tête protégés signés (from, to, reply-to, mail-reply-to, mail-followup-to, subject) qui diffèrent de ceux de l’extérieur, séparés par des virgules (voir En-têtes protégés). Présent seulement lorsque l’un diffère.

subject

protected lorsque le Subject: protégé du signataire a été affiché à la place d’un objet extérieur modifié en transit. Présent seulement dans ce cas.

demoted, dropped

Combien de parties que l’isolation a déplacées hors du message ont été remises comme pièces jointes, et combien ne l’ont pas été (voir Parties déplacées). Présents seulement lorsqu’ils ne sont pas nuls.

nested

Combien de messages joints portant du texte chiffré à côté d’un autre contenu ont été réduits (Isolation du contenu protégé). Présent seulement lorsqu’il n’est pas nul.

layers

Les couches de protection, de l’extérieur vers l’intérieur, séparées par des virgules.

La RFC 8601 n’enregistre aucune méthode smime ni pgp : une extension d”Authentication-Results signifierait donc inventer un nom de méthode dans un registre qui ne nous appartient pas, et d’autres implémentations seraient en droit d’ignorer ce nom ou de s’en méfier. Un en-tête privé à la grammaire documentée est le choix honnête, et son prix est le retrait inconditionnel décrit plus haut.

95.1.7.1.14. Texte en clair issu d’un conteneur malléable

Un conteneur S/MIME EnvelopedData (AES-CBC, ou 3DES là où [pepsi] CRYPTO_ALLOW_DOWNGRADE l’admet) ne protège rien d’autre que la confidentialité. Quiconque détient une copie du texte chiffré peut en réécrire le texte en clair bloc par bloc – les gadgets CBC d’EFAIL – et, connaissant ou devinant un bloc de texte en clair, construire un élément HTML dont l’URL englobe les blocs qui suivent, de sorte qu’un client qui rend le résultat envoie le texte en clair à l’attaquant. L’étape doit lire de tels conteneurs (la plupart du courrier S/MIME les utilise encore), et l’isolation n’aide pas, parce que la réécriture a lieu à l’intérieur de l’unique unité chiffrée conservée. Ce que l’étape ne fait pas, c’est remettre à un client du balisage dont elle ne peut pas se porter garante.

Un texte en clair issu d’un tel conteneur est couvert lorsqu’une signature valide à l’intérieur du conteneur parle pour lui – valid ou valid-untrusted ; la valeur de la clé importe peu, puisqu’une réécriture casse toute signature. Une signature autour du texte chiffré ne compte pas : un attaquant re-signe le texte chiffré réécrit avec une clé à lui. Un texte en clair couvert est remis tel quel. Un texte non couvert est traité comme l’indique UNAUTHENTICATED_PLAINTEXT :

text (par défaut)

Chaque partie qu’un client rendrait comme du balisage – text/html, text/enriched et les autres types text/*, application/xhtml+xml, à l’intérieur d’un message joint aussi – est réétiquetée text/plain en conservant son jeu de caractères et perd ses Content-ID, Content-Location et Content-Base ; un multipart/alternative proposant une alternative en texte brut est réduit à celle-ci. Le texte brut, les images, les fichiers et les signatures gardent leurs octets, et une partie dont le contenu ne change pas n’est pas réécrite, de sorte qu’une signature sur elle se vérifie toujours dans le client. Le texte arrive, rien ne se rend, et la mise en forme HTML du courrier CBC non signé est perdue. Le Subject est étiqueté TAG_UNAUTHENTICATED ([decrypted, unauthenticated]) à la place de TAG_DECRYPTED, et X-Pepsi-Crypto indique unauthenticated=yes; sanitised=text.

require-signature

Le message est transmis sans être ouvert, tel qu’il est arrivé, pour le propre client de messagerie de l’utilisateur, qui voit alors le conteneur S/MIME et applique ses propres défenses contre EFAIL. decryption indique withheld, aucune identité n’est consignée comme ayant ouvert le message, rien n’est étiqueté, et ON_DECRYPT_FAILURE n’est pas consulté : ce n’est pas un échec. Le courrier CBC non signé destiné à un utilisateur sans clé client arrive illisible, ce qui est le prix de ce réglage.

open

Le texte en clair est remis tel qu’il est sorti du conteneur, balisage compris, pour un site qui accepte l’exposition. Il est tout de même étiqueté TAG_UNAUTHENTICATED et consigné unauthenticated=yes.

OPEN_ENVELOPED_DATA = no va un pas plus loin et n’ouvre pas du tout un conteneur EnvelopedData, signé ou non : le message est transmis tel qu’il est arrivé, exactement comme avec require-signature (decryption indique withheld, ce n’est pas un échec), et aucune clé privée ne lui est appliquée. L’identifiant d’algorithme de chiffrement de contenu du conteneur n’est pas authentifié, de sorte qu’un attaquant qui détient un message AES-GCM destiné à l’un de nos utilisateurs envoyé sans la dérivation de clé de la RFC 9709 peut resoumettre son RecipientInfo sous un conteneur AES-CBC synthétique ; l’ouvrir applique la clé de contenu du message GCM à un texte chiffré fabriqué par l’attaquant. Avec l’option désactivée, cette clé ne sert jamais qu’au conteneur AEAD avec lequel elle est venue. L’option vaut par défaut yes (ouvrir) parce que la plupart des clients S/MIME n’envoient encore que de l”EnvelopedData. Comme toute option de cette section, elle peut être réglée pour une adresse ou un domaine de destinataire via une surcouche address: ou domain: (pepsi-config(1)), de sorte qu’un utilisateur dont les correspondants envoient tous de l”AuthEnvelopedData peut faire laisser le CBC à son client tandis que tous les autres le gardent ouvert. Il n’y a pas d’interrupteur par correspondant : l’expéditeur du conteneur n’est connu que par le From: extérieur, qui est précisément ce qu’un texte chiffré épissé ou réétiqueté permet à l’attaquant d’écrire.

95.1.7.1.14.1. Balisage dans le courrier déchiffré

Un texte en clair authentifié – issu d’un conteneur protégé en intégrité, ou couvert par une signature valide – est remis tel qu’il est sorti, HTML compris (DECRYPTED_MARKUP = keep, par défaut). Personne n’a pu le réécrire, mais il peut encore charger du contenu distant : une image, une feuille de style, une police depuis le serveur de l’expéditeur indiquent à l’expéditeur quand, et à peu près où, le message a été lu, et le CSS peut prendre l’empreinte du client. Le bloquer est le travail du client de messagerie, et cela compte plus ici que pour le courrier ordinaire : lorsque la passerelle a déchiffré un message, le client ne peut pas savoir qu’il était chiffré, et un client qui ne bloque le contenu distant que dans le courrier chiffré ne le bloque pas dans celui-ci. Le chapitre du manuel consacré aux clients de messagerie liste les réglages. DECRYPTED_MARKUP = text retire le choix au client : chaque texte en clair déchiffré est réduit exactement comme UNAUTHENTICATED_PLAINTEXT = text réduit un texte non authentifié, consigné comme sanitised=text, au prix de la mise en forme de chaque message chiffré ; une signature sur une partie qui a été réétiquetée ne se vérifie pas dans le client. Le coût retombe sur le lecteur, raison pour laquelle c’est une option qu’on peut donner à un utilisateur par adresse.

Un conteneur dont l’algorithme de chiffrement de contenu est id-alg-cek-hkdf-sha256 de la RFC 9709 est ouvert quel que soit son type : la clé que remet le RecipientInfo passe par HKDF-SHA256 sur l’identifiant d’algorithme réel (algorithme de chiffrement, IV ou nonce) avant usage, de sorte que la même clé remise sous un autre algorithme donne une autre clé de contenu. L’algorithme de la couche se lit, par exemple, aes-256-gcm+cek-hkdf-sha256. Pepsi dérive les clés de cette façon pour un correspondant dont les propres SMIMECapabilities signées nomment l’identifiant, et l’annonce dans ses propres signatures.

Le contenu issu d’un conteneur AEAD – l”AuthEnvelopedData S/MIME, chaque conteneur OpenPGP qu’accepte cette étape – n’est jamais concerné : un texte chiffré réécrit ne s’ouvre pas du tout. Le chemin que prend un texte en clair non couvert n’est visible que du destinataire, de sorte que la décision n’est pas un oracle de remplissage pour l’expéditeur ; une signature interne cassée d’un message réécrit est tout de même rapportée invalid et traitée par ON_BAD_SIGNATURE. Le conteneur est nommé dans X-Pepsi-Crypto (container=) et dans state.crypto.in.layers pour chaque texte chiffré ouvert.

95.1.7.1.15. Découverte de clés

L’étape ne fait aucune E/S réseau d’aucune sorte. Lorsque la clé du signataire n’est ni dans le message ni dans le cache peer_key, elle met en file une demande de découverte et gare le message ; un service pepsi-keydisc(1) le libère lorsque la demande se conclut, clé trouvée ou non, et l’étape s’exécute à nouveau. Une demande conclue sans clé libère le message tout autant, et il se vérifie alors en unverifiable. Lorsqu’une entrée fraîche de cache négatif existe, le message n’attend pas du tout. Cela empêche un spammeur qui signe avec une clé inconnue de faire attendre chaque message : le premier se gare, les autres non.

[pepsi-keydiscovery] INBOUND_TIMEOUT borne l’attente et se règle séparément du TIMEOUT sortant ; DISCOVERY_TIMEOUT dans la section propre à cette étape le redéfinit. DISCOVERY = no supprime entièrement la demande et laisse l’étape sur le chemin cache-seulement.

Aucune découverte n’est lancée pour une signature à l’intérieur d’un contenu issu d’un texte chiffré sans protection d’intégrité (EnvelopedData S/MIME, AES-CBC ou 3DES, tel que le déchiffreur l’a trouvé dans le DER). Un gadget CBC permet à un attaquant de faire paraître signé un texte en clair altéré seulement lorsque son remplissage est valide, et la recherche va vers le domaine du From:, que l’attaquant choisit ; la requête WKD ou DNS arriverait sur son serveur exactement lorsque le remplissage était valide. Ne pas rechercher la clé supprime entièrement ce signal. Les clés déjà en cache et les certificats que porte le message sont tout de même utilisés, de sorte que le coût se limite au courrier chiffré en CBC signé avec une clé qui n’est ni en cache ni jointe, lequel est remis comme unverifiable.

Le fait qu’un message garé soit stocké déchiffré dépend de la forme du message, et la différence compte :

  • 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 validé et déchiffré exactement une fois.

  • Une signature OpenPGP ne vit qu’à l’intérieur du flux de paquets : elle disparaît dès que le texte clair en sort. Valider le texte clair détruirait la preuve que la clé récupérée doit servir à vérifier : un tel message est donc garé inchangé et déchiffré à nouveau à la reprise.

Un message garé avec son texte clair validé demeure déchiffré dans pepsi.workqueue jusqu’à l’échéance de découverte. C’est la même exposition que la remise créerait un instant plus tard de toute façon ; c’est une fenêtre plus longue, non une nouvelle.

95.1.7.1.16. Les certificats que le message transporte

La plupart du courrier signé porte le certificat qui l’a signé : avant de rien décider, l’étape lit donc dans le message les certificats de signataire S/MIME et les parties application/pgp-keys et les propose au vérificateur. Elle refait de même sur le texte clair une fois le message ouvert, car un certificat joint à l’intérieur du chiffré est invisible jusque-là, et réévalue une fois si cela a donné quelque chose que la première passe n’avait pas.

Ces certificats sont utilisés puis abandonnés. Cette étape ne stocke rien : apprendre du courrier entrant — l’en-tête Autocrypt:, les clés jointes, et le gossip — relève de pepsi-stage-autocrypt-learn(1), qui s’exécute plus loin dans le pipeline, après les étapes qui décident si un message est du spam. C’est cette scission qui rend possible de respecter la règle anti-spam d’Autocrypt Level 1 §5.3 : cette étape s’exécute en premier sur le chemin entrant, par conception, avant qu’un tel verdict n’existe. Cela signifie aussi que rien n’est écrit dans le magasin de clés par le processus qui détient les clés privées.

Employer un certificat que le message transportait ne peut qu”abaisser la valeur d’un verdict, jamais l’élever : un tel matériel est de provenance non fiable, de sorte qu’une signature vérifiée contre lui revient valid-untrusted et ne positionne pas state.signature_verified , la clé d’état dont pepsi-stage-check-whitelist(1) fait sa condition. C’est le même échelon qu’aurait une clé moissonnée et stockée, de sorte que la faire passer par la base n’apporterait rien. Ce qui peut élever un signataire S/MIME, c’est un chemin vers une ancre (voir Ancres de confiance) : un certificat porté par le message, ou appris d’un message antérieur, qui s’enchaîne jusqu’à une ancre pepsi.ca_trust est valid sur l’autorité de l’ancre, jamais sur la sienne propre.

95.1.7.1.17. Deux faits consignés pour l’étape d’apprentissage

Le déchiffrement valide le texte clair par-dessus les octets arrivés : deux choses que seule cette étape peut voir sont donc écrites dans state.crypto.in pour que pepsi-stage-autocrypt-learn(1) les lise — encrypted, que le message portait bien du texte chiffré, et outer_gossip, que le bloc d’en-têtes à l’arrivée portait déjà un champ Autocrypt-Gossip:. Les deux sont des préconditions pour croire le gossip d’un message, et ni l’un ni l’autre n’est plus déterminable une fois le texte clair dans la ligne.

95.1.7.1.18. Les clés de nos propres utilisateurs ne sont jamais outrepassées

Les clés sont moissonnées sous l’adresse From:, que l’expéditeur écrit, et l’authentification entrante est délibérément fail-open. Un message prétendant venir de l’un des utilisateurs propres à ce déploiement sème donc pour cet utilisateur une ligne peer_key contenant la clé qu’il transportait — et une signature vérifiée contre elle se vérifierait sinon, positionnant state.signature_verified, dont pepsi-stage-check-whitelist(1) fait sa condition.

Avant que le magasin ne soit consulté, l’étape demande donc si l’expéditeur prétendu est quelqu’un pour qui elle détient une identité. Si c’est le cas, la clé publique de cette identité est le seul candidat : aucune ligne peer_key pour l’adresse n’est proposée au vérificateur, quel que soit son rang et quelle qu’ait été son arrivée. Tout sauf une identité revoked compte, les identités expirées comprises — une signature faite l’an dernier l’a été avec la clé de l’an dernier, et refuser de la regarder rapporterait le courrier de nos propres utilisateurs comme invérifiable à chaque renouvellement de clé.

La règle tient au fait de détenir une clé, non au fait de servir l’adresse : un utilisateur qui exploite son propre client OpenPGP et n’a jamais téléversé de clé ici n’a pas d’identité, de sorte que sa clé moissonnée ou issue du gossip est utilisée exactement comme celle de n’importe quel correspondant. Le prix en est l’image miroir — dès qu’une identité est détenue pour une adresse, une signature faite avec la clé personnelle distincte de cet utilisateur ne se vérifie plus. Voir Les clés de nos propres utilisateurs ne sont pas découvertes dans le manuel.

95.1.7.1.19. Ancres de confiance

Les ancres X.509 proviennent de la table pepsi.ca_trust (pepsi-keys(1) ca) et sont mises en cache par processus worker pendant TRUST_ANCHOR_TTL (cinq minutes par défaut). Une ancre ajoutée ou désactivée devient donc effective dans cette fenêtre ; redémarrez les workers pour l’appliquer aussitôt. Elles sont chargées paresseusement et seulement pour un message portant réellement une couche S/MIME, de sorte que le trafic ordinaire ne coûte aucune requête.

Les données de révocation ne sont pas récupérées par l’étape : une récupération de CRL serait une E/S réseau dans une étape, ce que la conception de la découverte existe pour éviter. À la place, pepsi-keydisc(1) récupère dans pepsi.crl_cache les CRL que nomment les certificats de pairs S/MIME en cache, et l’étape lit les listes en cours avec les ancres (à la demande, pour une couche S/MIME seulement, derrière le même TRUST_ANCHOR_TTL). Une liste ne compte 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 ; un numéro de série listé rend la signature invalid (échec revoked). Chaque chaîne couverte par de telles listes est rapportée not-revoked. Tout ce qui est moindre – aucune liste pour un certificat de la chaîne, une liste périmée ou invérifiable, un cache illisible – est rapporté comme révocation not-checked, ce qui est énoncé plutôt que de laisser entendre « non révoqué » : la vérification de révocation échoue en douceur.

Un chemin est construit à partir des ancres, des certificats que portait le message, des clés en cache de l’expéditeur et, sous [pepsi-keydiscovery] CA_ISSUERS_FETCH, des certificats d’AC intermédiaires que pepsi-keydisc(1) a récupérés depuis les pointeurs caIssuers des certificats en cache dans pepsi.ca_issuer_cache (lus comme les listes, à la demande et derrière TRUST_ANCHOR_TTL). Un certificat récupéré est recherché en dernier, seulement comme émetteur – jamais comme signataire, jamais comme ancre –, de sorte qu’il peut compléter la chaîne d’un signataire qui n’a envoyé aucun intermédiaire et ne peut rien faire d’autre. Un certificat d’expéditeur que le magasin de clés a appris de son courrier ne met pas non plus fin à la recherche : il est validé contre les ancres comme un certificat porté par le message, et son statut appris (valid-untrusted) n’est rapporté que lorsqu’aucun chemin n’atteint une ancre.

95.1.7.1.20. Configuration

L’étape lit sa propre section [stage-<name>] (PROGRAM = pepsi-stage-decrypt, NEXT_STAGE (obligatoire), 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, DISCOVERY_TIMEOUT), toutes documentées dans pepsi.conf(5). pepsi-setup(1) exige un BOUNCE_STAGE dès que ON_BAD_SIGNATURE vaut bounce ou que ON_DECRYPT_FAILURE vaut bounce-if-unproblematic, et un QUARANTINE_STAGE dès que l’un de ON_DECRYPT_FAILURE, ON_BAD_SIGNATURE et ON_MISSING_SIGNATURE vaut quarantine. Sans BOUNCE_STAGE, une voie de rebond fait au contraire échouer le message. Une ligne à plusieurs destinataires est scindée avant de rebondir, et chaque copie revient à cette étape, afin qu’un DSN rende compte de chaque destinataire et honore le NOTIFY de chacun. Un message acheminé vers le QUARANTINE_STAGE conserve son texte en clair déchiffré aussi longtemps qu’il y attend ; gc de pepsi-queue(1) fait rebondir, sans son contenu, un message qui attend encore [pepsi-queue] QUARANTINE_MAX_AGE_DAYS (14 par défaut) après son arrivée – sauf s’il est issu d’un texte chiffré EnvelopedData (AES-CBC), ou n’a pas pu en être ouvert : celui-là est abandonné, comme l’abandonnent les voies de rebond, puisque le fait même qu’il ait été retenu dépendait du remplissage. Ce sont des options de comportement, redéfinissables par adresse via la table pepsi.settings.

La politique cryptographique — choix des algorithmes, acceptation des condensats faibles, tailles de clé minimales — réside dans les options CRYPTO_* de [pepsi] et dans [pepsi-crypto]. Elles relèvent du seul administrateur système et sont délibérément inatteignables depuis pepsi.settings ou pepsi-stage-edit-settings(1).

L’une d’elles ne s’applique pas ici. CRYPTO_ALLOW_DOWNGRADE régit ce qui peut être émis : SEIPDv1+MDC OpenPGP et EnvelopedData CMS sont lisibles quoi qu’elle dise (seul le propre OPEN_ENVELOPED_DATA = no de cette étape laisse ce dernier sans l’ouvrir), 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. Seuls le 3DES et les condensats de signature faibles sont conditionnés à l’entrée, et chaque refus produit son propre verdict plutôt qu’un échec générique. La barrière 3DES n’est pas la même des deux côtés : un message S/MIME 3DES entrant n’est accepté que sous yes, un message OpenPGP entrant l’est aussi sous negotiate, car un certificat OpenPGP énonce ses propres capacités de chiffrement et un certificat X.509 n’en énonce aucune. Le Blowfish OpenPGP, l’autre algorithme à blocs de 64 bits, est conditionné exactement comme le 3DES OpenPGP. Le conteneur réellement employé est noté par couche, de sorte qu’un déploiement puisse voir quelle part de son courrier entrant est encore pré-AEAD.

95.1.7.1.21. Privilège

Le binaire est installé setuid pepsi-crypto, mode 4750 pepsi-crypto:pepsi, et n’est donc pas plié dans le binaire multi-appel pepsi unifié.

Les deux moitiés de la limite de garde des clés reposent sur cette identité. 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 ; la clé de chiffrement de clés réside dans secrets.d/pepsi-crypto.secret, mode 0640, appartenant au même compte. Un binaire setgid gagnerait le groupe — de quoi lire le fragment — et s’authentifierait tout de même auprès de la base de données en tant que pepsi, précisément le rôle à qui la colonne est refusée.

Le groupe dans le mode restreint l’exécution au compte du dispatcher et à root ; le programme refuse en outre de s’exécuter si son uid réel n’est ni root ni l’un des comptes pepsi, pepsi-crypto et pepsi-owner. Cette vérification à l’exécution ne s’applique que lorsque le binaire porte réellement le bit setuid — un build installé sans lui (un arbre de développement, cargo test) laisse n’importe qui l’exécuter, au motif qu’un tel appelant atteint la base de données en son propre nom et que les droits de PostgreSQL font alors autorité. -c est accepté de ces appelants (la forme de lancement documentée du dispatcher est PROGRAM -c cfg worker) et l’environnement est assaini avant le chargement de la configuration, car la couche de configuration est pilotable par XDG_CONFIG_HOME, HOME, PATH et la famille PG*.

Les clés de déchiffrement sont sélectionnées par capacité : chaque identité non révoquée de chaque destinataire local dont le purpose est encrypt ou both, y compris les expirées, car l’ancien courrier doit rester lisible.

95.1.7.1.22. Limites de ressources

MAX_LAYERS (4 par défaut) plafonne le nombre de couches chiffrées imbriquées déballées ; un message qui en a davantage est remis avec le reste non ouvert et decrypt-failure=unsupported consigné.

Un message OpenPGP est couramment compressé et le taux d’expansion relève du choix de l”expéditeur : pepsi-crypto refuse donc d’emblée un texte clair de plus de 64 Mio plutôt que de le tronquer — un texte clair partiel ne doit jamais être rapporté comme vérifié. Ce cas est rapporté avec sa propre raison d’échec, decrypt-failure=too-large, et non comme un échec de déchiffrement générique : « ce message est une bombe » et « nous n’avons pas pu ouvrir ceci » sont des faits différents pour un opérateur.

95.1.7.1.23. État

Entrées : state.dsn (honoré et découpé en phase avec la scission de localité), state.crypto.in (sur une ligne reprise, ce qu’a noté la passe qui l’a déchiffrée).

Sorties : state.crypto.in — si le message était chiffré, ce qu’est devenu le texte chiffré (decryption : not-encrypted, decrypted, failed, for-client ou withheld), quelle identité l’a ouvert, le verdict de signature et son détail (y compris covers_plaintext), la liste ordonnée des couches et, pour le courrier destiné à la propre clé d’un utilisateur, for_client et client_fingerprint, ainsi que isolated, demoted et dropped lorsque du contenu situé à côté des parties protégées a été déplacé ou abandonné, protected_mismatch lorsque des champs d’en-tête protégés signés diffèrent de ceux de l’extérieur, unauthenticated et sanitised pour un texte en clair issu d’un conteneur sans protection d’intégrité qu’aucune signature ne couvre (Texte en clair issu d’un conteneur malléable), et encrypted et outer_gossip pour pepsi-stage-autocrypt-learn(1) (voir Deux faits consignés pour l’étape d’apprentissage) ; en cas d’échec, failure (la raison), failed_unauthenticated lorsque le texte chiffré en échec n’avait aucune protection d’intégrité, et route lorsqu’une politique d’échec a acheminé le message. Également state.encrypted = true lorsque le message est arrivé chiffré, et state.signature_verified = true pour le seul verdict valid ; pepsi-stage-check-whitelist(1) et pepsi-stage-auto-whitelist(1) les lisent. Sur un rebond, state.bounce. La disposition de l’état est décrite dans pepsi.state(7).

Transitions : NEXT_STAGE pour un message remis ; QUARANTINE_STAGE ou BOUNCE_STAGE selon les politiques d’échec ; paused pendant l’attente de la découverte de clés ; pending à cette même étape après une scission de localité.

95.1.7.1.24. Commandes

worker

Exécuté comme worker persistant du dispatcher, lisant les identifiants de message sur l’entrée standard et écrivant une ligne de statut par message. C’est le seul mode ; il n’y a pas de forme ponctuelle. Pour traiter un seul message à la main, envoyez son identifiant dans un tube

echo 1234 | pepsi-stage-decrypt -c /etc/pepsi/pepsi.conf worker

95.1.7.1.25. Code de sortie

0

Le worker s’est terminé proprement (entrée standard fermée).

1

Une erreur s’est produite (mauvaise configuration, magasin de clés illisible, ou erreur de base de données). La raison est écrite dans le journal.

78

Le worker a refusé de démarrer : sa configuration ou son trousseau ne fonctionne pas (voir Erreurs de cet hôte). Le dispatcher remet en file ce qu’il lui avait confié et réessaie l’étape plus tard.

95.1.7.1.26. Voir aussi

pepsi-stage-encrypt(1), pepsi-stage-reencrypt(1), pepsi-stage-arc(1), pepsi-keys(1), pepsi-keydisc(1), pepsi-stage-check-whitelist(1), pepsi-stage-relay-to-maildir(1), pepsi-stage-relay-to-lmtp(1), pepsi-stage-bounce(1), pepsi-dispatch(1), pepsi-setup(1), pepsi.conf(5), pepsi.state(7)

Le chapitre Sécurité du manuel énonce les mécanismes que met en œuvre cette étape (The private-key custody boundary, Who a signed and encrypted message was for, Protected headers against the outer ones, Header forgery, Protected content stands alone, Bounces and replies to encrypted mail) ; son chapitre Modèle de menace énonce ce qu’ils promettent (What a security indicator means, End-to-end encryption: two custody modes).

95.1.7.1.27. Bogues

Signalez les bogues au gestionnaire de tickets de Pepsi.