20. Erweiterungen für Mail-Clients

Pepsi hält an zwei Stellen fest, was es an einer eingehenden Nachricht verifiziert oder entschlüsselt hat: in den Betreffmarken [decrypted] / [verified], die jeder Client anzeigt, und im Header-Feld X-Pepsi-Crypto, das ein Client nur unter den Roh-Headern anzeigt, sofern er keine der Erweiterungen aus diesem Kapitel hat. Die Marken haben eine Schwäche, die das Gateway nicht beseitigen kann: Den Betreff schreibt der Absender, und ein Nachrichtentext kann ein Banner enthalten, das wie eine Marke aussieht. Pepsi entfernt gefälschte Marken (Header-Fälschung), aber ein Leser, der im Text einer unsignierten Nachricht „verified“ sieht, kann dies nicht vom Echten unterscheiden.

Die beiden Erweiterungen in diesem Kapitel schließen diese Lücke für die beiden Clients, die sie abdecken. Jede liest X-Pepsi-Crypto und X-Pepsi-Warning aus den Nachrichten-Headern im Client und zeigt das Urteil des Gateways an einer Stelle an, die der Nachrichteninhalt nicht erreichen kann: in einem Aufgabenbereich in Outlook, in einer Symbolleisten-Schaltfläche mit Badge und Popup in Thunderbird. Nichts, was der Absender in den Betreff oder den Text schreibt, ändert, was dort erscheint. Was das Gateway nicht gesagt hat, wird genau als solches angezeigt, als neutrales „kein Gateway-Urteil“, und niemals als gutes oder schlechtes Urteil. Was ein Sicherheitsindikator bedeutet legt dar, was jedes Urteil verspricht.

Beide sind kleine JavaScript-Programme ohne Abhängigkeiten, die sich einen Parser teilen (contrib/addin/pepsi-crypto.js). make check hält diesen Parser mit dem Gateway in Einklang: Jeder Schlüssel, den die Decrypt-Stage in X-Pepsi-Crypto schreiben kann, jedes Signatururteil und jeder X-Pepsi-Warning-Wert muss ihm bekannt sein (tests/check-extensions.sh).

Keine der Erweiterungen meldet irgendetwas irgendwohin. Die Header werden vom Client gelesen und bleiben dort. Die Outlook-Seiten werden wie jede statische Datei vom Gateway abgerufen, und dieser Abruf ist alles, was das Gateway sieht; bei eingeschalteter Telemetrie wird er unter dem Schlüssel addin gezählt. Kein Nachrichteninhalt, keine Adresse und kein Urteil verlässt den Client.

20.1. Was angezeigt wird

Das Urteil besteht aus einer Überschrift mit Erläuterung, nach Schweregrad eingefärbt, dann etwaigen Warnungen, dann den Fakten, die das Gateway festgehalten hat:

Überschrift

Wann

Verified: signed by … („Verifiziert: signiert von …“, grün)

signature=valid: Eine Signatur über den Inhalt wurde gegen einen Schlüssel verifiziert, dem das Gateway für den Absender vertraut, und der Unterzeichner stimmt mit der From:-Adresse überein. Der Bereich zeigt die Adresse, an die die Signatur gebunden ist (bound-to), andernfalls den Unterzeichner, wie das Gateway ihn festgehalten hat.

Decrypted by the gateway; sender not verified („Vom Gateway entschlüsselt; Absender nicht verifiziert“, blau)

decrypted=yes ohne anerkannte Signatur. Sagt nichts darüber aus, wer die Nachricht gesendet hat.

Encrypted to your own key („An Ihren eigenen Schlüssel verschlüsselt“, blau)

for-client=yes: ungeöffnet durchgereicht für einen Schlüssel, der im Client liegt. Es gilt die Anzeige des Clients selbst.

No gateway verdict („Kein Gateway-Urteil“, grau)

Kein X-Pepsi-Crypto-Feld: Die Nachricht trug keinen Schutz oder hat nie eine Decrypt-Stage durchlaufen. Beides wird gleich angezeigt, weil die Erweiterung die Fälle nicht unterscheiden kann und nicht raten darf.

No protection recorded („Kein Schutz festgehalten“, grau)

Ein X-Pepsi-Crypto-Feld, das weder eine Verschlüsselung noch eine Signatur festhält.

Signed, but not credited to the sender („Signiert, aber nicht dem Absender zugerechnet“, gelb)

signature=valid-untrusted mit withheld: Die Signatur ist gültig, aber eine Bindungsregel hat die Anerkennung zurückgehalten (ein geschütztes From:, Reply-To: oder eine gefälschte Betreffmarke, ein Zertifikat ohne Namen, ein Anzeigename oder mehrere From:-Postfächer, eine ähnlich aussehende Domain), und der Grund wird ausgeschrieben.

Only part of what you see is signed („Nur ein Teil dessen, was Sie sehen, ist signiert“, gelb)

signature=partial: ein verifizierter Clearsign-Block neben Text, den die Signatur nicht abdeckt (unsigned-surface).

Signed with a key nobody vouches for („Mit einem Schlüssel signiert, für den niemand bürgt“, gelb)

signature=valid-untrusted. Die Signatur ist gültig, aber jeder kann eine solche mit einem Schlüssel erzeugen, den nichts verankert. Wird wie unsignierte Mail mit einer Erläuterung dargestellt, niemals als verifiziert.

Signed, but the signature could not be checked („Signiert, aber die Signatur konnte nicht geprüft werden“, gelb)

signature=unverifiable, mit dem festgehaltenen failure-Grund.

Encrypted; could not be opened here („Verschlüsselt; konnte hier nicht geöffnet werden“, gelb)

encrypted=yes; decrypted=no, mit decrypt-failure, sofern festgehalten.

Decrypted, but nobody vouches for the content („Entschlüsselt, aber niemand bürgt für den Inhalt“, rot)

unauthenticated=yes: ein Klartext aus einem Container ohne Integritätsschutz, den keine Signatur abdeckt; ob er auf reinen Text reduziert wurde (sanitised=text), wird angegeben.

Signature invalid („Signatur ungültig“, rot)

signature=invalid, mit dem failure-Grund und einem Hinweis, dass Mailinglisten dies bei legitimer Mail verursachen.

Conflicting gateway verdicts („Widersprüchliche Gateway-Urteile“, rot)

Mehr als ein X-Pepsi-Crypto-Feld. Das Gateway schreibt genau eines, also wurde die Nachricht verändert, nachdem sie es verlassen hat, oder kam über einen Weg, der das Feld nicht entfernt; keinem davon wird geglaubt.

Unterhalb der Überschrift:

  • jede X-Pepsi-Warning als eigene rote Zeile, in Worten ausgeschrieben. display-name-claims-other-address lautet „der Anzeigename des Absenders enthält eine andere E-Mail-Adresse als die, von der die Nachricht gesendet wurde“; from-has-bidi-or-invisible-characters beschreibt versteckte Zeichen in der Absenderzeile, die das Angezeigte umordnen oder verbergen können; from-domain-resembles-served-domain beschreibt eine Absender-Domain, die wie die eigene der Organisation aussieht, es aber nicht ist; attachment-name-has-bidi-or-invisible-characters beschreibt einen Anhangsnamen, der einen anderen Dateityp vortäuschen kann; und die vier [external]-Warnungen werden ebenso erklärt. In Thunderbird färbt eine solche Warnung das Badge zudem rot, wenn das Urteil sonst gut oder neutral ist (verifiziert, entschlüsselt, for-client oder keines), denn die Nachricht hat dann das Muster einer Phishing-Nachricht;

  • ein Hinweis, wenn die Mail des Absenders gewöhnlich eine verifizierte Signatur trägt und diese Nachricht nicht (usually-signed, mit dem Datum der letzten);

  • ein Hinweis, wenn eine Mailingliste den Reply-To: außerhalb der Signatur hinzugefügt hat (reply-to=unsigned) und wenn der signierte Betreff anstelle eines geänderten angezeigt wird (subject=protected);

  • Hinweise zur Struktur der Nachricht: ein protected-mismatch (die signierte Kopie von From:, To: oder Subject: weicht von der angezeigten ab), was die Isolierung vom geschützten Teil getrennt hat (isolated, demoted, dropped);

  • die Fakten: signature, signer, bound-to, fingerprint, key-source, trust, algorithm, binding, anchor, withheld, unsigned-surface, signer-domain, protocol, container, layers, encrypted, decrypted sowie die Fehlergründe. Ein Schlüssel, den die Erweiterung nicht kennt, wird unter seinem Rohnamen aufgeführt statt verworfen, sodass eine ältere Erweiterung neben einem neueren Gateway zu einer unerklärten Zeile degradiert, nicht zu Schweigen.

Jeder Wert wird als Text eingefügt. Ein Unterzeichnername stammt aus einem Zertifikat, das der Absender geliefert hat; das Gateway hat ihn bereits für die Header-Syntax bereinigt (pepsi-stage-decrypt), und die Erweiterung interpretiert ihn niemals als Markup.

20.2. Was sie beweist und was nicht

Die Anzeige ist nur so gut wie das Feld, und das Feld ist aus einem Grund vertrauenswürdig: Ingress und die Decrypt-Stage entfernen jedes eingehende X-Pepsi-*-Feld, bevor das Gateway sein eigenes schreibt (Header-Fälschung). Ein Postfach hinter Pepsi sieht daher das Feld des Gateways oder keines. Die Erweiterungen prüfen nicht – und können nicht prüfen –, ob die Nachricht durch Pepsi kam: Bei einem Postfach, das Mail auch auf einem anderen Weg empfängt, erreicht das X-Pepsi-Crypto eines Fremden den Client unverändert und wird angezeigt. Setzen Sie sie dort ein, wo das Mailsystem Mail für die verwalteten Domains nur von Pepsi annimmt, was das Exchange-Kapitel ohnehin verlangt.

Eine grüne Überschrift bedeutet, was valid in Was ein Sicherheitsindikator bedeutet bedeutet: eine Signatur über den Klartext mit einem Schlüssel, dem das Gateway für die Adresse des Absenders vertraut. Sie bedeutet nicht, dass der Absender der ist, den der Anzeigename nennt (dafür ist die Warnzeile da), und sie bedeutet nicht, dass der Inhalt sicher ist.

Für Clients, die die Erweiterungen nicht abdecken, ändert sich nichts: Webmail, mobile Clients und alle anderen Desktop-Clients zeigen die Betreffmarken und sonst nichts. Die Marken bleiben In-Band (Sicherheitsstatus In-Band im Nachrichten-Body oder in Headern gefälscht).

20.3. Outlook: der Lesebereich

Das Outlook-Add-in (Das Outlook-Add-in) enthält beide Bereiche. Sobald der Administrator sein Manifest per Sideloading installiert hat, findet ein Benutzer, der eine Nachricht liest, im Menüband eine Schaltfläche Gateway verdict, die den Bereich öffnet. Ältere Clients zeigen die Schaltfläche in der Add-in-Leiste unterhalb der Nachricht. Der Bereich kann angeheftet werden, und ein angehefteter Bereich folgt der Auswahl. Der Verfassen-Bereich, Protect message, ist unverändert.

Voraussetzungen: Der Lesebereich verwendet getAllInternetHeadersAsync (Outlook-Mailbox-Anforderungssatz 1.8; Outlook im Web, das neue Outlook für Windows, Outlook 2019 und neuer sowie Outlook für Mac). Auf einem älteren Client öffnet sich der Bereich und meldet, dass er keine Header lesen kann; der Verfassen-Bereich funktioniert dort weiterhin, weshalb die Untergrenze des Manifests bei 1.3 bleibt.

Die Dateien sind /addin/readpane.html, /addin/pepsi-crypto.js und die Symbole /addin/icon-*.png, ausgeliefert von pepsi-httpd neben dem Manifest und dem Verfassen-Bereich unter demselben Schalter [pepsi-httpd] ADDIN (pepsi-httpd). Die JavaScript-Bibliothek von Office selbst wird, wie bei jedem Office-Add-in, aus Microsofts CDN geladen.

20.4. Thunderbird: die Urteils-Schaltfläche

Die Thunderbird-Erweiterung ist eine MailExtension (Manifest-Version 2, Thunderbird 115 oder neuer; sie verwendet messages.getFull unter der Berechtigung messagesRead und sonst nichts). Sie fügt der Symbolleiste des Nachrichtenkopfs eine Schaltfläche Gateway hinzu. Immer wenn eine Nachricht angezeigt wird, zeigt das Badge der Schaltfläche ein nach dem Urteil eingefärbtes Zeichen, und ihr Tooltip enthält die Überschrift. Das Badge zeigt ein grünes Häkchen für verifiziert; einen blauen Punkt für entschlüsselt oder for-client; nichts für kein Urteil; ein gelbes Fragezeichen für nicht vertrauenswürdig, nicht prüfbar oder nicht geöffnet; und ein rotes Ausrufezeichen oder Kreuz für die roten Zeilen oben und für eine Warnung neben einem grünen, blauen oder grauen Urteil. Ein Klick auf die Schaltfläche öffnet das vollständige Urteil.

Auf ein Banner innerhalb der dargestellten Nachricht wurde bewusst verzichtet: Thunderbird kann eines einfügen (messageDisplayScripts), aber es säße im Nachrichtenbereich, wo ein Absender eine Nachahmung platzieren kann.

Installation. make install legt die entpackte Erweiterung unter ${DATADIR}/thunderbird/ ab (/usr/share/pepsi/thunderbird/ unter Debian), und make thunderbird-xpi packt sie als ZIP in target/pepsi-verdict.xpi (THUNDERBIRD_XPI= nennt einen anderen Pfad). Ohne Quellbaum lässt sich das installierte Verzeichnis auf dieselbe Weise packen:

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

Öffnen Sie in Thunderbird Add-ons und Themes, wählen Sie im Zahnradmenü Add-on aus Datei installieren… und wählen Sie die .xpi-Datei. Für die Entwicklung nimmt Add-ons debuggen → Temporäres Add-on laden… direkt die manifest.json des Verzeichnisses. Die Erweiterung ist nicht auf addons.thunderbird.net gelistet; sie ist von niemandem signiert, daher fragt Thunderbird bei der Installation nach einer Bestätigung, und eine Unternehmensrichtlinie (ExtensionSettings) ist der Weg, sie an viele Benutzer zu verteilen. Eine Organisation, die ihren Benutzern das Urteil in einem hier nicht abgedeckten Client zeigen möchte, kann beim Parser ansetzen.

20.5. Externe Inhalte

Eine vom Gateway entschlüsselte Nachricht kommt im Postfach als gewöhnliche Nachricht an. Ihr HTML wird so zugestellt, wie es aus dem Chiffrat kam (pepsi-stage-decrypt, DECRYPTED_MARKUP = keep), und es kann weiterhin externe Inhalte laden: Ein Bild, ein Stylesheet oder eine Schriftart, die vom Server des Absenders abgerufen wird, verrät dem Absender, dass, wann und ungefähr wo die Nachricht gelesen wurde, und CSS kann einen Fingerabdruck des Clients erstellen. Unverschlüsselte HTML-Mail tut dasselbe, und ein Tracking-Pixel in einem Newsletter ist der übliche Fall. Sofern der Leser pepsi-stage-defang (siehe unten) nicht eingeschaltet hat, entscheidet der Mail-Client, ob diese Anfragen stattfinden. Hinter Pepsi ist das wichtiger als anderswo. Manche Clients behandeln verschlüsselte Mail mit besonderer Sorgfalt: Sie blockieren darin externe Inhalte oder weigern sich, sie mit anderen Teilen zu mischen. Ein solcher Client kann nicht erkennen, dass diese Nachricht verschlüsselt war. Stellen Sie den Client so ein, dass er externe Inhalte in aller Mail blockiert:

  • Thunderbird: Einstellungen → Datenschutz & Sicherheit → Nachrichteninhalte: Lassen Sie Externe Inhalte in Nachrichten erlauben deaktiviert (die Voreinstellung) und gewähren Sie Ausnahmen pro Absender nur Absendern, denen Sie vertrauen.

  • Outlook (klassisch, Windows): Datei → Optionen → Trust Center → Einstellungen für das Trust Center → Automatischer Download: Aktivieren Sie Bilder in HTML-Standard-E-Mail-Nachrichten oder RSS-Elementen nicht automatisch herunterladen (die Voreinstellung). Das neue Outlook und Outlook im Web rufen externe Bilder über Microsofts eigenen Proxy ab, der die Adresse des Lesers verbirgt, dem Absender aber dennoch verrät, dass die Nachricht geöffnet wurde; blockieren Sie externe Bilder unter Einstellungen → E-Mail → Datenschutz und Daten, sofern der Mandant es zulässt.

  • Apple Mail: Einstellungen → Datenschutz: E-Mail-Aktivität schützen lädt externe Inhalte über ein Relay, das Adresse und Zeitpunkt des Lesers verbirgt; Alle entfernten Inhalte blockieren blockiert sie, und das ist hier gemeint.

  • K-9 Mail / Thunderbird für Android: Einstellungen → Allgemeine Einstellungen → Anzeige: Bilder anzeigen auf Niemals (oder nur für Kontakte) setzen.

  • FairEmail: Externe Bilder werden standardmäßig nicht angezeigt; lassen Sie Einstellungen → Datenschutz → Anzeigen von Bildern bestätigen eingeschaltet.

Das Gateway kann die externen Verweise auch entfernen, bevor die Nachricht abgelegt wird. pepsi-setup --wizard bindet pepsi-stage-defang auf jeder Installation ein, die Mail lokal zustellt, und zwar ausgeschaltet. Ein Benutzer schaltet die Stage mit DEFANG = on ein, per Einstellungs-Mail oder mit pepsi-settings (Pepsi benutzen: ein Leitfaden für Benutzer). Die Stage entfernt dann aus dem HTML dieses Benutzers alles, was das HTML von selbst laden würde: externe Bilder, Stylesheets, Schriftarten, Frames, url() und @import. Links, cid:-Teile und eingebettete data:-Bilder bleiben erhalten. Die Stage kennzeichnet die Nachricht mit X-Pepsi-Warning: remote-content-defanged, was beide Erweiterungen als Hinweis anzeigen. Sie lässt unangetastet, was ein Client erneut verifiziert (ein multipart/signed, einen S/MIME-signierten oder -verschlüsselten Teil, einen Inline-OpenPGP-Block). Eine signierte HTML-Nachricht behält daher ihre Verweise, und weiterhin schützt sie die Client-Einstellung. Keines ersetzt das andere: Die Stage wirkt für jeden Client, mit dem der Benutzer liest, und die Einstellung deckt ab, was die Stage unangetastet lassen muss.

Eine Site, deren Benutzern man nicht zutrauen kann, eine solche Einstellung beizubehalten, kann die Entscheidung für sie treffen: DECRYPTED_MARKUP = text stellt jeden entschlüsselten Klartext als reinen Text zu, für alle oder, über ein pepsi-config-Overlay, für ausgewählte Adressen, um den Preis der Formatierung jeder verschlüsselten Nachricht. Ein Klartext aus einem Container ohne Integritätsschutz, den keine Signatur abdeckt, wird unabhängig von der Einstellung auf diese Weise reduziert (UNAUTHENTICATED_PLAINTEXT = text).