95.1.41. pepsi-stage-defang¶
neutralise the remote references in HTML messages
- Section du manuel:
1
95.1.41.1.1. Nom¶
pepsi-stage-defang - l’étape de contenu distant du pipeline Pepsi.
95.1.41.1.2. Synopsis¶
pepsi-stage-defang [GLOBAL-OPTIONS] worker
95.1.41.1.3. Description¶
pepsi-stage-defang 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. Lorsque DEFANG est activé pour le destinataire d’un message, l’étape retire tout ce que le HTML du message chargerait de lui-même depuis le réseau à l’affichage, de sorte qu’ouvrir le message n’apprend rien à son expéditeur. Une image d’un pixel dotée d’une URL propre à chaque destinataire signale qui a lu un courrier, quand, depuis quelle adresse et avec quel programme. Le même mécanisme permet à une partie HTML déchiffrée d’envoyer son propre texte en clair au serveur d’un attaquant (l’exfiltration directe d’EFAIL).
DEFANG est désactivé par défaut et destiné à être activé par adresse, par le propriétaire de l’adresse : pepsi-settings set ADDRESS STAGE DEFANG on, ou un courrier de paramètres à pepsi-stage-edit-settings(1) lorsque l’étape figure dans ses EDITABLE_STAGES. Un message dont les destinataires diffèrent est d’abord scindé, de sorte que chaque copie est traitée comme son destinataire l’a choisi. Tant que DEFANG est désactivé pour un message, l’étape fait avancer ce message intact. L’étape a FUSION = yes par défaut. Intégrée au binaire unifié pepsi, elle fait passer un message sur ses seules métadonnées, sans charger le corps, lorsque DEFANG est certainement désactivé pour lui (désactivé dans la section, et aucune redéfinition pour aucune des adresses du message).
95.1.41.1.4. Ce qui est réécrit¶
L’étape réécrit chaque partie text/html, application/xhtml+xml et text/x-amp-html, à toute profondeur et quel que soit son Content-Disposition, ainsi que chaque partie text/css, y compris celles des messages joints. Une partie est décodée de son encodage de transfert et de son jeu de caractères, puis réencodée dans le même encodage de transfert. Certains jeux de caractères n’écrivent pas le texte ASCII sous forme d’octets ASCII (ISO-2022-JP, Shift_JIS, UTF-16, …) ; une partie dans un tel jeu est lue dans ce jeu de caractères et réécrite en UTF-8, avec une étiquette de jeu de caractères modifiée.
L’étape retire ce qui suit, sauf si la référence désigne une partie du message lui-même (cid:) ou une image, un son ou une vidéo transportés en ligne (data:image/..., data:audio/..., data:video/...) :
les attributs qui chargent une ressource :
src,srcset,imagesrcset,lowsrc,dynsrc,poster,background;hrefsur tout élément autre que<a>et<area>(<link>ne garde quecid:, les éléments SVG gardent les références à un fragment du document,#id) ;tout
srcde<iframe>,<frame>et<embed>, et ledatade<object>, puisqu’un document encadré charge ce qu’il veut ;ping,attributionsrc,srcdoc,manifest,codebaseetarchivesur chaque élément ;url(),@importet les chaînes d’URL (image-set("..."), la chaîne d’une propriété personnalisée) dans les attributsstyle, les éléments<style>, les partiestext/csset les propriétés SVG qui prennent une URL (fill,filter,mask,clip-path,marker,cursor, …), remplacés par le mot-clénone; une animation SVG ne peut pas définir dehref;<base href>,<meta http-equiv="refresh">et<meta http-equiv="link">;<script>avec son contenu.
Un attribut retiré est retiré, non conservé sous un autre nom, de sorte qu’aucun client ne peut le rétablir. Les liens (<a href>, <area href>) et les formulaires restent : rien n’est récupéré tant que le lecteur n’agit pas. Une référence relative part aussi, car un champ Content-Base ou Content-Location peut la faire pointer n’importe où.
L’étape lit le HTML comme un navigateur le lit, en suivant les propres règles du tokenizer HTML pour les fins de balise, les guillemets, les commentaires et le texte brut. Un réécrivain qui lit une balise autrement que le client est un réécrivain qu’un attaquant peut contourner. À certains endroits, la lecture dépend de l’arbre du document : <style>, <title> et les autres éléments à texte brut sont du texte en HTML mais du balisage à l’intérieur de <svg>, <math>, <select> et <frameset>. Là, la sortie est faite pour se lire de la même manière dans les deux cas. <noscript> perd ses balises et garde son contenu. Le corps des commentaires est réécrit aussi, puisqu’Outlook affiche le balisage de ses commentaires conditionnels. Un arbre MIME imbriqué sur plus de 32 niveaux ne peut pas être vérifié, et sa partie trop profonde est remplacée par une courte note.
95.1.41.1.5. Ce qui n’est jamais touché¶
L’étape laisse intact ce qu’un client vérifie à nouveau : un multipart/signed et tout ce qu’il contient, une partie application/pkcs7-mime (signée ou encore chiffrée), un multipart/encrypted, et une partie HTML qui porte un bloc OpenPGP en ligne. Une telle partie garde ses références distantes, et l’étape journalise combien elle en a laissé intactes. Le texte en clair que pepsi-stage-decrypt(1) a produit est un contenu ordinaire.
Un message que l’étape a modifié porte X-Pepsi-Warning: remote-content-defanged en tête de son en-tête ; les extensions Outlook et Thunderbird l’affichent comme une note, non comme un avertissement. Un message sans rien à neutraliser est transmis octet pour octet.
95.1.41.1.6. Placement¶
L’étape se place après chaque étape qui vérifie ou lit le contenu (pepsi-stage-decrypt(1), pepsi-stage-dmarc-report(1), les filtres de liste blanche et de paiement, pepsi-stage-autocrypt-learn(1)). Elle se place aussi après pepsi-stage-dot-forward(1), afin qu’une copie réexpédiée garde les octets que couvrent ses signatures DKIM et ARC, et avant pepsi-stage-reencrypt(1), qui scelle ce qu’on lui remet. C’est là que pepsi-setup –wizard la place, avec DEFANG = off, sur toute installation qui remet le courrier localement ; l’assistant l’inscrit aussi dans EDITABLE_STAGES lorsqu’il configure l’éditeur de paramètres.
95.1.41.1.7. Configuration¶
Les options se trouvent dans la propre section [stage-<name>] de l’étape (PROGRAM = pepsi-stage-defang) :
- NEXT_STAGE
Où va chaque message, réécrit ou non. Obligatoire.
- DEFANG
onouoff(par défautoff). Lu après l’application des paramètres par adresse ; c’est ce qu’un utilisateur active pour son propre courrier.
Inscrire l’étape dans EDITABLE_STAGES ne remet aux utilisateurs que ce seul interrupteur : l’étape n’a aucune cible de branchement et ne fait jamais que retirer ce qui est affiché.
95.1.41.1.8. État¶
Entrées : aucune.
Sorties : aucune ; l’étape consigne son travail dans le champ X-Pepsi-Warning et dans le journal. La disposition de l’état est décrite dans pepsi.state(7).
Transitions : avance toujours vers NEXT_STAGE. Toute erreur est réessayée comme d’habitude (voir pepsi-dispatch(1)) ; une section qui ne s’analyse pas fait refuser le démarrage du worker, et une valeur par adresse qui ne s’analyse pas fait échouer le message.
95.1.41.1.9. Commandes¶
- worker
Exécuté comme un worker persistant de pepsi-dispatch(1), lisant les identifiants de message sur l’entrée standard.
95.1.41.1.10. Options globales¶
- -c FILE, –config FILE
Lit la configuration depuis FILE au lieu de parcourir les emplacements par défaut.
- -L LOGLEVEL, –log LOGLEVEL
Règle la verbosité de journalisation (par défaut
[pepsi] LOG, sinoninfo).- -v, –verbose
Affiche les messages de journal de toutes les sources.
- -h, –help ; -V, –version
Affiche un résumé d’utilisation / la version et quitte.
95.1.41.1.11. Code de sortie¶
Le résultat de chaque message est rapporté à pepsi-dispatch(1) sur la ligne de statut du worker, et non par le code de sortie.
- 0
Le worker s’est exécuté jusqu’à la fermeture de son entrée standard.
- 1
Une erreur fatale s’est produite (configuration illisible, base de données impossible à ouvrir, ou échec de l’entrée/sortie standard). La raison est écrite dans le journal.
- 78
Le worker a refusé de démarrer : une section
[stage-*]qu’il sert ne s’analyse pas (DEFANGne vaut nionnioff).
95.1.41.1.12. Exemples¶
La section qu’écrit pepsi-setup –wizard
[stage-defang]
PROGRAM = pepsi-stage-defang
NEXT_STAGE = reencrypt
DEFANG = off
L’activer pour une adresse
pepsi-settings set alice@example.org defang DEFANG on
La même chose par courrier, depuis le propre compte d’Alice, à l’adresse de l’éditeur de paramètres (par défaut pepsi@ le domaine, objet Pepsi)
[stage-defang]
DEFANG = on
95.1.41.1.13. Voir aussi¶
pepsi-settings(1), pepsi-stage-edit-settings(1), pepsi-stage-decrypt(1), pepsi-stage-reencrypt(1), pepsi-dispatch(1), pepsi.conf(5), pepsi.state(7)
95.1.41.1.14. Bogues¶
Signalez les bogues au gestionnaire de tickets de Pepsi.