95.1.41. pepsi-stage-defang¶
neutralise the remote references in HTML messages
- Handbuchabschnitt:
1
95.1.41.1.1. Name¶
pepsi-stage-defang - die Stage für entfernte Inhalte der Pepsi-Pipeline.
95.1.41.1.2. Übersicht¶
pepsi-stage-defang [GLOBAL-OPTIONS] worker
95.1.41.1.3. Beschreibung¶
pepsi-stage-defang ist ein Stage-Programm, das von pepsi-dispatch(1) als persistenter Worker ausgeführt wird, der Nachrichten-IDs von der Standardeingabe liest. Ist DEFANG für den Empfänger einer Nachricht eingeschaltet, entfernt die Stage alles, was das HTML der Nachricht beim Anzeigen von sich aus aus dem Netz laden würde. So verrät das Öffnen der Nachricht ihrem Absender nichts. Ein Ein-Pixel-Bild mit einer URL je Empfänger meldet, wer eine Mail gelesen hat, wann, von welcher Adresse und mit welchem Programm. Derselbe Mechanismus lässt einen entschlüsselten HTML-Teil seinen eigenen Klartext an den Server eines Angreifers senden (die direkte Exfiltration von EFAIL).
DEFANG ist standardmäßig aus und dafür gedacht, je Adresse vom Inhaber der Adresse eingeschaltet zu werden: pepsi-settings set ADDRESS STAGE DEFANG on oder eine Einstellungsmail an pepsi-stage-edit-settings(1), wenn die Stage in dessen EDITABLE_STAGES aufgeführt ist. Eine Nachricht mit unterschiedlich eingestellten Empfängern wird zuerst aufgeteilt, sodass jede Kopie so behandelt wird, wie ihr Empfänger es gewählt hat. Solange DEFANG für eine Nachricht aus ist, schaltet die Stage die Nachricht unberührt weiter. Die Stage hat standardmäßig FUSION = yes. In das vereinheitlichte pepsi-Binärprogramm eingefaltet, reicht sie eine Nachricht allein anhand ihrer Metadaten weiter, ohne den Nachrichtentext zu laden, wenn DEFANG für sie sicher aus ist (aus im Abschnitt und keine Überschreibung für eine der Adressen der Nachricht).
95.1.41.1.4. Was umgeschrieben wird¶
Die Stage schreibt jeden text/html-, application/xhtml+xml- und text/x-amp-html-Teil um, in beliebiger Tiefe und gleich welcher Content-Disposition, ebenso jeden text/css-Teil, auch in angehängten Nachrichten. Ein Teil wird aus seiner Transfer-Encoding und seinem Zeichensatz dekodiert und wieder in derselben Transfer-Encoding kodiert. Manche Zeichensätze schreiben ASCII-Text nicht als ASCII-Bytes (ISO-2022-JP, Shift_JIS, UTF-16, …). Ein Teil in einem solchen Zeichensatz wird in diesem Zeichensatz gelesen und als UTF-8 zurückgeschrieben; seine Zeichensatzangabe wird entsprechend geändert.
Die Stage entfernt Folgendes, sofern der Verweis nicht einen Teil der Nachricht selbst benennt (cid:) oder ein eingebettet mitgeführtes Bild, einen Ton oder ein Video (data:image/..., data:audio/..., data:video/...):
die Attribute, die eine Ressource laden:
src,srcset,imagesrcset,lowsrc,dynsrc,poster,background;hrefan jedem Element außer<a>und<area>(<link>behält nurcid:, SVG-Elemente behalten Verweise auf ein Fragment des Dokuments,#id);jedes
srcvon<iframe>,<frame>und<embed>sowiedatavon<object>, da ein eingerahmtes Dokument lädt, was es will;ping,attributionsrc,srcdoc,manifest,codebaseundarchivean jedem Element;url(),@importund URL-Zeichenketten (image-set("..."), die Zeichenkette einer benutzerdefinierten Eigenschaft) instyle-Attributen,<style>-Elementen,text/css-Teilen und den SVG-Eigenschaften, die eine URL nehmen (fill,filter,mask,clip-path,marker,cursor, …), ersetzt durch das Schlüsselwortnone; SVG-Animation darf keinhrefsetzen;<base href>,<meta http-equiv="refresh">und<meta http-equiv="link">;<script>mit seinem Inhalt.
Ein entferntes Attribut wird entfernt, nicht unter einem anderen Namen behalten, sodass kein Client es zurücksetzen kann. Links (<a href>, <area href>) und Formulare bleiben: Nichts wird abgerufen, bis der Leser handelt. Ein relativer Verweis wird ebenfalls entfernt, weil ein Content-Base- oder Content-Location-Feld ihn überallhin zeigen lassen kann.
Die Stage liest das HTML so, wie ein Browser es liest, nach den eigenen Regeln des HTML-Tokenizers für Tag-Enden, Anführungszeichen, Kommentare und Rohtext. Einen Umschreiber, der ein Tag anders liest als der Client, kann ein Angreifer umgehen. An manchen Stellen hängt das Lesen vom Dokumentbaum ab: <style>, <title> und die anderen Rohtext-Elemente sind in HTML Text, innerhalb von <svg>, <math>, <select> und <frameset> aber Markup. Dort wird die Ausgabe so gestaltet, dass sie auf beide Weisen gleich gelesen wird. <noscript> verliert seine Tags und behält seinen Inhalt. Auch Kommentarinhalte werden umgeschrieben, da Outlook das Markup in seinen bedingten Kommentaren rendert. Einen MIME-Baum, der tiefer als 32 Ebenen verschachtelt ist, kann die Stage nicht prüfen; sein zu tiefer Teil wird durch einen kurzen Hinweis ersetzt.
95.1.41.1.5. Was nie angefasst wird¶
Die Stage lässt unberührt, was ein Client erneut verifiziert: ein multipart/signed und alles darin, einen application/pkcs7-mime-Teil (signiert oder noch verschlüsselt), ein multipart/encrypted und einen HTML-Teil, der einen Inline-OpenPGP-Block trägt. Ein solcher Teil behält seine entfernten Verweise, und die Stage protokolliert, wie viele sie unberührt gelassen hat. Klartext, den pepsi-stage-decrypt(1) erzeugt hat, ist gewöhnlicher Inhalt.
Eine von der Stage veränderte Nachricht trägt X-Pepsi-Warning: remote-content-defanged am Anfang ihres Headers; die Erweiterungen für Outlook und Thunderbird zeigen es als Hinweis, nicht als Warnung. Eine Nachricht, an der nichts zu entschärfen ist, wird Byte für Byte weitergereicht.
95.1.41.1.6. Platzierung¶
Die Stage gehört hinter jede Stage, die den Inhalt verifiziert oder liest (pepsi-stage-decrypt(1), pepsi-stage-dmarc-report(1), die Whitelist- und Zahlungsschranken, pepsi-stage-autocrypt-learn(1)). Sie gehört außerdem hinter pepsi-stage-dot-forward(1), damit eine weitergeleitete Kopie die Bytes behält, die ihre DKIM- und ARC-Signaturen abdecken, und vor pepsi-stage-reencrypt(1), das versiegelt, was ihm übergeben wird. Hierhin setzt pepsi-setup –wizard sie mit DEFANG = off auf jeder Installation, die Mail lokal zustellt. Wenn der Assistent den Einstellungseditor konfiguriert, führt er sie auch in EDITABLE_STAGES auf.
95.1.41.1.7. Konfiguration¶
Die Optionen liegen im eigenen [stage-<name>]-Abschnitt der Stage (PROGRAM = pepsi-stage-defang):
- NEXT_STAGE
Wohin jede Nachricht geht, umgeschrieben oder nicht. Erforderlich.
- DEFANG
onoderoff(Standardwertoff). Wird gelesen, nachdem die adressbezogenen Einstellungen angewendet wurden; es ist das, was ein Benutzer für seine eigene Mail einschaltet.
Die Stage in EDITABLE_STAGES aufzuführen überlässt den Benutzern nichts als diesen Schalter: Die Stage hat kein Verzweigungsziel und entfernt immer nur, was angezeigt wird.
95.1.41.1.8. State¶
Eingaben: keine.
Ausgaben: keine; die Stage hält ihre Arbeit im Feld X-Pepsi-Warning und im Log fest. Das State-Layout wird in pepsi.state(7) beschrieben.
Übergänge: schaltet immer zu NEXT_STAGE weiter. Jeder Fehler wird wie üblich wiederholt (siehe pepsi-dispatch(1)); ein Abschnitt, der sich nicht parsen lässt, verweigert den Start des Workers, und ein adressbezogener Wert, der sich nicht parsen lässt, lässt die Nachricht fehlschlagen.
95.1.41.1.9. Befehle¶
- worker
Läuft als persistenter pepsi-dispatch(1)-Worker, der Nachrichten-IDs von der Standardeingabe liest.
95.1.41.1.10. Globale Optionen¶
- -c FILE, –config FILE
Liest die Konfiguration aus FILE, statt die Standardorte zu durchsuchen.
- -L LOGLEVEL, –log LOGLEVEL
Setzt die Log-Ausführlichkeit (Standardwert
[pepsi] LOG, sonstinfo).- -v, –verbose
Zeigt Log-Meldungen aus allen Quellen.
- -h, –help; -V, –version
Gibt eine Verwendungsübersicht / die Version aus und beendet sich.
95.1.41.1.11. Exit-Status¶
Das Ergebnis jeder Nachricht wird pepsi-dispatch(1) auf der Statuszeile des Workers gemeldet, nicht als Exit-Status.
- 0
Der Worker lief, bis seine Standardeingabe geschlossen wurde.
- 1
Ein fataler Fehler ist aufgetreten (unlesbare Konfiguration, die Datenbank konnte nicht geöffnet werden, oder Standardein-/-ausgabe schlug fehl). Der Grund wird in das Journal geschrieben.
- 78
Der Worker hat den Start verweigert: Ein
[stage-*]-Abschnitt, den er bedient, lässt sich nicht parsen (DEFANGwederonnochoff).
95.1.41.1.12. Beispiele¶
Der Abschnitt, den pepsi-setup –wizard schreibt:
[stage-defang]
PROGRAM = pepsi-stage-defang
NEXT_STAGE = reencrypt
DEFANG = off
Für eine Adresse einschalten:
pepsi-settings set alice@example.org defang DEFANG on
Dasselbe per Mail, von Alices eigenem Konto an die Adresse des Einstellungseditors (standardmäßig pepsi@ die Domain, Betreff Pepsi):
[stage-defang]
DEFANG = on
95.1.41.1.13. Siehe auch¶
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. Fehler¶
Melden Sie Fehler an den Pepsi-Issue-Tracker.