20. Extensions pour clients de messagerie

Pepsi consigne ce qu’il a vérifié ou déchiffré sur un message entrant à deux endroits : les étiquettes d’objet [decrypted] / [verified], que chaque client affiche, et le champ d’en-tête X-Pepsi-Crypto, qu’un client n’affiche que parmi les en-têtes bruts, sauf s’il dispose de l’une des extensions de ce chapitre. Les étiquettes ont une faiblesse que la passerelle ne peut pas supprimer : c’est l’expéditeur qui écrit l’objet, et le corps d’un message peut porter un bandeau qui ressemble à une étiquette. Pepsi retire les étiquettes falsifiées (Falsification d’en-têtes), mais un lecteur qui voit « verified » dans le corps d’un message non signé n’a aucun moyen de le distinguer de l’original.

Les deux extensions de ce chapitre comblent cette lacune pour les deux clients qu’elles couvrent. Chacune lit X-Pepsi-Crypto et X-Pepsi-Warning dans les en-têtes du message, à l’intérieur du client, et affiche le verdict de la passerelle à un endroit que le contenu du message ne peut pas atteindre : un volet de tâches dans Outlook, un bouton de barre d’outils avec un badge et une fenêtre surgissante dans Thunderbird. Rien de ce que l’expéditeur écrit dans l’objet ou le corps ne change ce qui y apparaît. Ce que la passerelle n’a pas dit est affiché exactement comme tel, sous la forme d’un « pas de verdict de la passerelle » neutre, et jamais comme un bon ou un mauvais verdict. Ce que signifie un indicateur de sécurité indique ce que promet chaque verdict.

Toutes deux sont de petits morceaux de JavaScript sans dépendance qui partagent un même analyseur (contrib/addin/pepsi-crypto.js). make check tient cet analyseur en accord avec la passerelle : chaque clé que l’étape de déchiffrement peut écrire dans X-Pepsi-Crypto, chaque verdict de signature et chaque valeur de X-Pepsi-Warning doivent lui être connus (tests/check-extensions.sh).

Aucune des deux extensions ne rapporte quoi que ce soit nulle part. Les en-têtes sont lus par le client et y restent. Les pages d’Outlook sont récupérées depuis la passerelle comme n’importe quel fichier statique, et cette récupération est tout ce que voit la passerelle ; lorsque la télémétrie est activée, elle est comptée sous la clé addin. Aucun contenu de message, aucune adresse et aucun verdict ne quitte le client.

20.1. Ce qui est affiché

Le verdict est un titre accompagné d’une explication, coloré selon la gravité, puis les éventuels avertissements, puis les faits consignés par la passerelle :

Titre

Quand

Verified: signed by … (vert)

signature=valid : une signature sur le contenu s’est vérifiée contre une clé à laquelle la passerelle fait confiance pour l’expéditeur, et le signataire correspond à l’adresse From:. Le volet affiche l’adresse à laquelle la signature est liée (bound-to), à défaut le signataire tel que la passerelle l’a consigné.

Decrypted by the gateway; sender not verified (bleu)

decrypted=yes sans signature reconnue. Ne dit rien de l’auteur de l’envoi.

Encrypted to your own key (bleu)

for-client=yes : transmis sans être ouvert pour une clé détenue dans le client. L’affichage propre au client s’applique.

No gateway verdict (gris)

Pas de champ X-Pepsi-Crypto : le message ne portait aucune protection, ou n’a jamais traversé d’étape de déchiffrement. Affiché de façon identique dans les deux cas, car l’extension ne peut pas les distinguer et ne doit pas deviner.

No protection recorded (gris)

Un champ X-Pepsi-Crypto qui ne consigne ni chiffrement ni signature.

Signed, but not credited to the sender (orange)

signature=valid-untrusted avec withheld : la signature se vérifie, mais une règle de liaison l’a retenue (un From:, un Reply-To: protégé ou une étiquette d’objet falsifiée, un certificat sans nom, un nom affiché ou plusieurs boîtes From:, un domaine sosie), et la raison est indiquée en toutes lettres.

Only part of what you see is signed (orange)

signature=partial : un bloc signé en clair vérifié à côté d’un texte que la signature ne couvre pas (unsigned-surface).

Signed with a key nobody vouches for (orange)

signature=valid-untrusted. La signature se vérifie, mais n’importe qui peut en produire une avec une clé que rien n’ancre. Affiché comme un courrier non signé accompagné d’une explication, jamais comme vérifié.

Signed, but the signature could not be checked (orange)

signature=unverifiable, avec la raison failure consignée.

Encrypted; could not be opened here (orange)

encrypted=yes; decrypted=no, avec decrypt-failure lorsqu’il est consigné.

Decrypted, but nobody vouches for the content (rouge)

unauthenticated=yes : un texte en clair issu d’un conteneur sans protection d’intégrité qu’aucune signature ne couvre ; il est précisé s’il a été réduit à du texte brut (sanitised=text).

Signature invalid (rouge)

signature=invalid, avec la raison failure et un rappel que les listes de diffusion provoquent cela sur du courrier légitime.

Conflicting gateway verdicts (rouge)

Plus d’un champ X-Pepsi-Crypto. La passerelle en écrit exactement un : le message a donc été modifié après son départ, ou est passé par un chemin qui ne retire pas le champ ; aucun d’eux n’est cru.

Sous le titre :

  • chaque X-Pepsi-Warning sur sa propre ligne rouge, explicité en toutes lettres. display-name-claims-other-address se lit « le nom affiché de l’expéditeur contient une autre adresse électronique que celle depuis laquelle le message a été envoyé » ; from-has-bidi-or-invisible-characters décrit des caractères cachés dans la ligne de l’expéditeur, capables de réordonner ou de masquer ce qu’elle montre ; from-domain-resembles-served-domain décrit un domaine d’expéditeur qui ressemble à celui de l’organisation sans l’être ; attachment-name-has-bidi-or-invisible-characters décrit un nom de pièce jointe susceptible d’afficher un autre type de fichier ; et les quatre avertissements [external] sont expliqués de même. Dans Thunderbird, un tel avertissement fait aussi passer le badge au rouge lorsque le verdict est par ailleurs bon ou neutre (vérifié, déchiffré, pour le client ou aucun), puisque le message a alors la forme d’un message d’hameçonnage ;

  • une note lorsque le courrier de l’expéditeur porte habituellement une signature vérifiée et que ce message n’en a pas (usually-signed, avec la date de la dernière) ;

  • une note lorsqu’une liste de diffusion a ajouté le Reply-To: hors de la signature (reply-to=unsigned) et lorsque l’objet signé est affiché à la place d’un objet modifié (subject=protected) ;

  • des notes sur la structure du message : un protected-mismatch (la copie signée de From:, To: ou Subject: diffère de celle affichée), ce que l’isolation a séparé de la partie protégée (isolated, demoted, dropped) ;

  • les faits : signature, signer, bound-to, fingerprint, key-source, trust, algorithm, binding, anchor, withheld, unsigned-surface, signer-domain, protocol, container, layers, encrypted, decrypted, et les raisons d’échec. Une clé que l’extension ne connaît pas est listée sous son nom brut plutôt qu’écartée, si bien qu’une extension plus ancienne à côté d’une passerelle plus récente se dégrade en une ligne inexpliquée, non en silence.

Chaque valeur est placée sous forme de texte. Un nom de signataire provient d’un certificat que l’expéditeur a fourni ; la passerelle l’a déjà assaini pour la syntaxe des en-têtes (pepsi-stage-decrypt), et l’extension ne l’interprète jamais comme du balisage.

20.2. Ce que cela prouve, et ce que cela ne prouve pas

L’affichage ne vaut que ce que vaut le champ, et le champ est digne de confiance pour une seule raison : ingress et l’étape de déchiffrement retirent chaque champ X-Pepsi-* entrant avant que la passerelle n’écrive le sien (Falsification d’en-têtes). Une boîte aux lettres derrière Pepsi voit donc le champ de la passerelle ou aucun. Les extensions ne vérifient pas, et ne peuvent pas vérifier, que le message est passé par Pepsi : sur une boîte aux lettres qui reçoit aussi du courrier par une autre voie, le X-Pepsi-Crypto d’un inconnu parvient intact au client et est affiché. Déployez-les là où le système de courrier n’accepte les domaines gérés que depuis Pepsi, ce que le chapitre sur Exchange exige de toute façon.

Un titre vert signifie ce que valid signifie dans Ce que signifie un indicateur de sécurité : une signature sur le texte en clair par une clé à laquelle la passerelle fait confiance pour l’adresse de l’expéditeur. Cela ne signifie pas que l’expéditeur est celui que dit le nom affiché (la ligne d’avertissement est là pour cela), et cela ne signifie pas que le contenu est sûr.

Rien ne change pour les clients que les extensions ne couvrent pas : le webmail, les clients mobiles et tous les autres clients de bureau affichent les étiquettes d’objet et rien d’autre. Les étiquettes restent dans la bande (État de sécurité usurpé dans le corps ou les en-têtes du message).

20.3. Outlook : le volet de lecture

Le complément Outlook (Le module complémentaire Outlook) comporte les deux volets. Une fois que l’administrateur a chargé son manifeste, un utilisateur qui lit un message trouve dans le ruban un bouton Gateway verdict, qui ouvre le volet. Les clients plus anciens placent ce bouton dans la barre des compléments, sous le message. Le volet peut être épinglé, et un volet épinglé suit la sélection. Le volet de rédaction, Protect message, est inchangé.

Prérequis : le volet de lecture utilise getAllInternetHeadersAsync (ensemble d’exigences Outlook Mailbox 1.8 ; Outlook sur le web, le nouvel Outlook pour Windows, Outlook 2019 et ultérieur, et Outlook pour Mac). Sur un client plus ancien, le volet s’ouvre et indique qu’il ne peut pas lire les en-têtes ; le volet de rédaction y fonctionne toujours, et c’est pourquoi le plancher du manifeste reste à 1.3.

Les ressources sont /addin/readpane.html, /addin/pepsi-crypto.js et les icônes /addin/icon-*.png, servies par pepsi-httpd à côté du manifeste et du volet de rédaction, sous le même interrupteur [pepsi-httpd] ADDIN (pepsi-httpd). La bibliothèque JavaScript propre à Office est chargée depuis le CDN de Microsoft, comme pour tout complément Office.

20.4. Thunderbird : le bouton de verdict

L’extension Thunderbird est une MailExtension (manifeste version 2, Thunderbird 115 ou ultérieur ; elle utilise messages.getFull sous la permission messagesRead, et rien d’autre). Elle ajoute un bouton Gateway à la barre d’outils de l’en-tête du message. Chaque fois qu’un message est affiché, le badge du bouton montre une marque colorée selon le verdict, et son infobulle porte le titre. Le badge montre une coche verte pour vérifié ; un point bleu pour déchiffré ou pour le client ; rien en l’absence de verdict ; un point d’interrogation orange pour non fiable, invérifiable ou non ouvert ; et un point d’exclamation ou une croix rouges pour les lignes rouges ci-dessus et pour un avertissement à côté d’un verdict vert, bleu ou gris. Un clic sur le bouton ouvre le verdict complet.

Un bandeau à l’intérieur du message affiché a délibérément été écarté : Thunderbird peut en injecter un (messageDisplayScripts), mais il se trouverait dans la zone du message, où un expéditeur peut placer une imitation.

L’installer. make install place l’extension décompressée sous ${DATADIR}/thunderbird/ (/usr/share/pepsi/thunderbird/ sur Debian), et make thunderbird-xpi la compresse dans target/pepsi-verdict.xpi (THUNDERBIRD_XPI= nomme un autre chemin). Sans arborescence des sources, le répertoire installé se compresse de la même façon :

cd /usr/share/pepsi/thunderbird && zip -r ~/pepsi-verdict.xpi .

Dans Thunderbird, ouvrez Add-ons and Themes, choisissez Install Add-on From File… dans le menu de l’engrenage, et sélectionnez le .xpi. Pour le développement, Debug Add-ons → Load Temporary Add-on… prend directement le manifest.json du répertoire. L’extension n’est pas répertoriée sur addons.thunderbird.net ; elle n’est signée par personne, si bien que Thunderbird demande une confirmation à l’installation, et une politique d’entreprise (ExtensionSettings) est le moyen de la déployer auprès de nombreux utilisateurs. Une organisation qui veut que ses utilisateurs voient le verdict sur un client non couvert ici peut partir de l’analyseur.

20.5. Contenu distant

Un message que la passerelle a déchiffré arrive dans la boîte aux lettres comme un message ordinaire. Son HTML est remis tel qu’il est sorti du texte chiffré (pepsi-stage-decrypt, DECRYPTED_MARKUP = keep), et il peut encore charger du contenu distant : une image, une feuille de style ou une police récupérée sur le serveur de l’expéditeur indique à celui-ci que le message a été lu, quand et à peu près où, et le CSS peut prendre l’empreinte du client. Le courrier HTML non chiffré fait de même, et un pixel de suivi dans une lettre d’information est le cas courant. À moins que le lecteur n’ait activé pepsi-stage-defang (ci-dessous), c’est le client de messagerie qui décide si ces requêtes ont lieu. Cela compte davantage derrière Pepsi qu’ailleurs. Certains clients traitent le courrier chiffré avec un soin particulier : ils y bloquent le contenu distant, ou refusent de le mêler à d’autres parties. Un tel client ne peut pas savoir que ce message était chiffré. Configurez le client pour qu’il bloque le contenu distant dans tout le courrier :

  • Thunderbird : Settings → Privacy & Security → Mail Content : laissez Allow remote content in messages décoché (la valeur par défaut), et n’accordez d’exceptions par expéditeur qu’à des expéditeurs de confiance.

  • Outlook (classique, Windows) : File → Options → Trust Center → Trust Center Settings → Automatic Download : cochez Don’t download pictures automatically in standard HTML email messages or RSS items (la valeur par défaut). Le nouvel Outlook et Outlook sur le web récupèrent les images distantes par le proxy propre à Microsoft, qui masque l’adresse du lecteur mais indique toujours à l’expéditeur que le message a été ouvert ; bloquez les images externes sous Settings → Mail → Privacy and data là où le tenant le permet.

  • Apple Mail : Settings → Privacy : Protect Mail Activity charge le contenu distant par un relais qui masque l’adresse du lecteur et l’heure ; Block All Remote Content le bloque, ce qui est visé ici.

  • K-9 Mail / Thunderbird pour Android : Settings → General settings → Display : Show images réglé sur Never (ou sur les contacts seulement).

  • FairEmail : les images distantes ne sont pas affichées par défaut ; laissez Settings → Privacy → Confirm showing images activé.

La passerelle peut aussi retirer les références distantes avant que le message ne soit classé. pepsi-setup --wizard câble pepsi-stage-defang, désactivée, sur chaque installation qui remet le courrier localement. Un utilisateur l’active avec DEFANG = on, par courrier de réglages ou avec pepsi-settings (Utiliser Pepsi : un guide pour les utilisateurs). L’étape retire alors du HTML de cet utilisateur tout ce que ce HTML chargerait de lui-même : images distantes, feuilles de style, polices, cadres, url() et @import. Les liens, les parties cid: et les images data: en ligne restent. L’étape marque le message X-Pepsi-Warning: remote-content-defanged, ce que les deux extensions affichent sous forme de note. Elle laisse intact ce qu’un client vérifie de nouveau (un multipart/signed, une partie S/MIME signée ou chiffrée, un bloc OpenPGP en ligne) ; un message HTML signé conserve donc ses références, et c’est toujours le réglage du client qui le protège. Aucun des deux ne remplace l’autre : l’étape fonctionne pour chaque client avec lequel l’utilisateur lit, et le réglage couvre ce que l’étape doit laisser intact.

Un site dont on ne peut pas compter sur les utilisateurs pour conserver un tel réglage peut faire le choix à leur place : DECRYPTED_MARKUP = text remet chaque texte en clair déchiffré en texte brut, pour tout le monde ou, au moyen d’une surcouche pepsi-config, pour des adresses choisies, au prix de la mise en forme de chaque message chiffré. Un texte en clair issu d’un conteneur sans protection d’intégrité qu’aucune signature ne couvre est réduit de cette façon quel que soit le réglage (UNAUTHENTICATED_PLAINTEXT = text).