Reveal URLs

Reveal URLs — Handbuch

Reveal URLs ist eine kleine Browser-Erweiterung (und ein Thunderbird-Add-on), die dir zeigt, wohin ein Link in deiner E-Mail wirklich führt, sodass du einen Phishing-Link erkennen kannst, bevor du darauf klickst.

Dieses Handbuch erklärt, wie du Reveal URLs installierst und wie du es benutzt. Für die Frage, wie mit deinen Daten umgegangen wird, siehe die Datenschutzerklärung; für einen technischen Überblick darüber, wie die Erweiterung aufgebaut ist, siehe den Architekturüberblick.

Einen Fehler gefunden, einen Link, der fälschlicherweise markiert (oder übersehen) wurde, oder einen Webmail-Host, der unterstützt werden sollte? Bitte melde es im Codeberg-Issue-Tracker.

Inhalt

Was es macht und warum

Eine Phishing-E-Mail verbirgt ein feindliches Ziel hinter vertrauenswürdig aussehendem Linktext. Manchmal ist es ein ähnlich aussehender Host: Der Text lautet paypal.com, während der Link auf paypa1.com verweist. Oft ist es subtiler und führt über einen Tracker oder eine Weiterleitung, sodass das Ziel, auf dem du landest, nichts mit der im Text genannten Marke zu tun hat.

Eine Phishing-E-Mail, die sich als Deutsche Post ausgibt, behauptet, ein Paket werde zurückgehalten, bis offene Zollgebühren bezahlt sind, und drängt zur Zahlung über eine Schaltfläche „Zur Zahlung“. Reveal URLs zeigt, dass die Schaltfläche nicht auf Deutsche Post verweist, sondern auf parcel-pay.custom.co.xa, eine nicht zugehörige Website, und entlarvt die Nachricht so als Betrug.
Reveal URLs entlarvt die Schaltfläche „Zur Zahlung“: Sie verweist auf parcel-pay.custom.co.xa, nicht auf Deutsche Post.

Hinweis: Dieser Screenshot zeigt eine betrügerische Phishing-E-Mail, die sich als Deutsche Post ausgibt. Deutsche Post ist nicht mit Reveal URLs verbunden und unterstützt es nicht.

Reveal URLs liest jeden Link in der Nachricht, die du gerade liest, und zeigt dir die URL, auf die er tatsächlich zeigt. Wenn der im Linktext genannte Host nicht mit diesem Host übereinstimmt, markiert Reveal URLs dies, sodass der Unterschied deutlich ist, bevor du klickst.

Eine Gmail-Nachricht mit aktivem Reveal URLs: ein irreführender Link ist rot markiert, wobei die Tracking-URL, auf die er verweist, über dem Linktext aufgedeckt wird, während bei einem ehrlichen Link die URL ohne Warnung aufgedeckt wird.

In der Browser-Erweiterung und im Thunderbird-Add-on geschieht alles auf deinem eigenen Gerät, wobei nichts übertragen wird. In jeder Form sendet Reveal URLs keine deiner E-Mail-Daten an uns oder an irgendeinen Dritten — es gibt kein Analytics und kein Tracking. (Die Formen unterscheiden sich darin, wo sie laufen und wie der Code des Outlook-Bereichs bereitgestellt wird; siehe den Abschnitt Datenschutz und die Datenschutzerklärung für alle Details.)

Unterstützte Browser und der Mail-Client

Reveal URLs läuft auf:

Eine Safari-Version wird noch nicht ausgeliefert; sie ist für eine spätere Phase geplant.

Auf den Browser-Zielen annotiert Reveal URLs Links in deiner Webmail. In Thunderbird annotiert es die Links in der E-Mail, die du liest, direkt im Mail-Client.

Installieren

Aus dem Store deines Browsers oder Mail-Clients (empfohlen)

Installiere Reveal URLs aus dem Store für deinen Browser oder dein E-Mail-Programm. Die Einträge für Chrome, Edge, Firefox und Thunderbird sind live; Opera führt den Chrome-Build aus, und ein eigener Opera-Eintrag ist noch in Arbeit:

Einen Build selbst laden (Entwickler und frühes Testen)

Wenn du Reveal URLs aus dem Quellcode gebaut hast, kannst du den entpackten Build direkt laden. Jedes Ziel wird mit einem make-Befehl gebaut und unter dist/<target>/ erzeugt:

make build-chrome        # produces dist/chrome
make build-edge          # produces dist/edge
make build-opera         # produces dist/opera
make build-firefox       # produces dist/firefox
make build-thunderbird   # produces dist/thunderbird

Lade anschließend den resultierenden Ordner:

Die Einstellungsseite öffnet sich automatisch, wenn die Erweiterung zum ersten Mal installiert wird.

Verwendung

Out of the box annotiert Reveal URLs die Links in Nachrichten bei den eingebauten Anbietern — keine Einrichtung erforderlich:

Die Annotation ist auf den Nachrichtentext begrenzt, sodass die eigene Oberfläche der App — ihre Seitenleiste, ihr Verfassen-Fenster und ihre Symbolleisten — unangetastet bleibt. In Thunderbird wird die gesamte dargestellte E-Mail abgedeckt.

Reveal URLs annotiert eine Gmail-Nachricht: die URL jedes Links wird in einer eigenen Zeile über dem Linktext gezeigt, mit einem nicht übereinstimmenden Tracking-Link in Rot und einem ehrlichen Link, dessen URL ohne Warnung aufgedeckt wird.

Die zwei Aufdeckungsmodi

Du wählst, wie die tatsächliche URL angezeigt wird, unter URL aufdecken auf der Einstellungsseite:

Wenn der im sichtbaren Text eines Links genannte Host nicht mit dem Host übereinstimmt, auf den der Link wirklich zeigt, markiert Reveal URLs dies als Mismatch. Der Vergleich erfolgt anhand der registrierbaren Domain, sodass eine ehrliche Subdomain wie mail.example.com für example.com nicht markiert wird, während ein Look-alike wie paypa1.com für paypal.com markiert wird.

Zwei zugehörige Einstellungen steuern dies:

Die Einstellungsseite: der Modus-Wähler 'URL aufdecken', der Schalter 'Nicht übereinstimmende Links hervorheben' und die Felder für die Mismatch- und Match-Farbe.

Die Symbolleisten-Schaltfläche

In Chrome, Edge, Opera, Firefox und Thunderbird ist das Symbol von Reveal URLs in der Symbolleiste ein schneller Ein/Aus-Schalter — klicke darauf, um die Annotation umzuschalten. Wenn die Erweiterung ausgeschaltet ist, erscheint ein OFF-Abzeichen auf dem Symbol, und sein Tooltip sagt dir, ob ein Klick sie ein- oder ausschaltet. In den Browsern wird die Änderung in allen offenen Tabs gleichzeitig wirksam; in Thunderbird gilt sie für die nächste Nachricht, die du öffnest.

(In Thunderbird zeigt die Schaltfläche nur ihr Symbol, sodass sie in der einheitlichen Symbolleiste kompakt bleibt. Du kannst Reveal URLs auch mit dem Schalter Aktivieren auf der Einstellungsseite ein- und ausschalten.)

Die Einstellungsseite

Die Einstellungsseite enthält jede Option. Öffne sie über die Erweiterungsseite deines Browsers (zum Beispiel Details → Erweiterungsoptionen), oder sie öffnet sich automatisch bei der ersten Installation.

Abgesehen vom Hauptschalter Aktivieren und den Steuerungen für Aktive Sites (die sofort angewendet werden) werden Änderungen mit der Schaltfläche Einstellungen speichern gespeichert.

Die unteren Einstellungen: die Liste 'Diese Hosts ignorieren', die maximale angezeigte URL-Länge und die optionalen Felder für Schriftgröße und -gewicht der aufgedeckten URL und des Warn-Abzeichens, über der Schaltfläche 'Einstellungen speichern'.

Aktive Sites — deine eigene Webmail hinzufügen

Der Abschnitt Aktive Sites, oben auf der Einstellungsseite, listet die Seiten auf, auf denen Reveal URLs läuft, und den Container, der jeden Nachrichtentext enthält.

Der obere Teil der Einstellungsseite: der Hauptschalter 'Reveal URLs aktivieren' und die Liste 'Aktive Sites', wobei jeder eingebaute Anbieter sein Übereinstimmungsmuster, einen Schalter 'Aktiviert', einen Schalter 'Subframes' und seinen Nachrichtentext-Selektor zeigt.

Jede Zeile zeigt:

Die eingebauten Anbieter (Gmail, Outlook und Proton) können ausgeschaltet und neu ausgerichtet werden, aber sie können nicht entfernt werden.

Um deine eigene Webmail-Site hinzuzufügen:

  1. Gib unter Site hinzufügen eine Übereinstimmungs-URL ein — ein Übereinstimmungsmuster wie https://mail.example.com/*.
  2. Gib einen Nachrichtentext-Selektor ein — einen CSS-Selektor für den Container, der den Nachrichtentext enthält, zum Beispiel .message-body.
  3. Wenn der Nachrichtentext in einem Subframe dargestellt wird, hake Auch innerhalb von Subframes ausführen an.
  4. Klicke auf Site hinzufügen. Dein Browser wird um Erlaubnis bitten, auf diese Site zuzugreifen; erteile sie. Die Site wird erst hinzugefügt, sobald du die Erlaubnis erteilst.

Änderungen hier werden sofort angewendet. Das Entfernen einer Site, die du hinzugefügt hast, widerruft auch deren Erlaubnis, sodass Reveal URLs nicht mehr darauf zugreift.

Thunderbird (und andere Mail-Clients). Thunderbird zeigt bereits jede Nachricht, die du liest, ganz gleich, welcher Anbieter, sodass es keine Liste pro Host benötigt. Der Abschnitt Aktive Sites wird daher auf der Thunderbird-Einstellungsseite nicht gezeigt — nur der Hauptschalter, die Anzeigesprache, der Aufdeckungsmodus, die Farben, die Schriftarten und die Ignorierliste erscheinen. Jede Aktive-Sites-Konfiguration, die du eventuell in einem Browser festgelegt hast, bleibt unangetastet erhalten: das Speichern der Thunderbird-Einstellungen löscht sie nie.

Die Outlook- und Gmail-Add-ons

Neben der Browser-Erweiterung und dem Thunderbird-Add-on gibt es Reveal URLs als natives Add-on für zwei Mail-Apps, die eine Browser-Erweiterung nicht erreichen kann: ein Outlook-Add-in und ein Gmail-Add-on. Beide nutzen dieselbe Linkerkennung wie die Erweiterung, sodass sie dieselben URLs aufdecken und dieselben Look-alike-Hosts markieren.

Der einzige Unterschied liegt darin, wie sie ihre Ergebnisse zeigen. Die Browser-Erweiterung annotiert die Links direkt an Ort und Stelle — sie färbt die URL über oder neben jedem Link. Die Outlook- und Gmail-Frameworks erlauben es einem Add-on nicht, die dargestellte Nachricht zu ändern, sodass stattdessen jedes Add-on ein Seitenpanel (Outlook) oder eine Karte (Gmail) zeigt, das/die die gefundenen Links auflistet. Für jeden Link zeigt es den sichtbaren Text, die URL und den registrierbaren Host, und es markiert einen Mismatch, wenn der sichtbare Text eine andere registrierbare Domain nennt, als der Link wirklich ansteuert.

Beide Add-ons werden über ihre App-Stores verteilt — das Outlook-Add-in über Microsoft AppSource, das Gmail-Add-on über den Google Workspace Marketplace. Die Veröffentlichung steht noch aus; direkte Installationslinks werden hier ergänzt, sobald jeder Eintrag live ist.

Sprachen

Reveal URLs ist auf Englisch und in vielen weiteren Sprachen verfügbar.

Der nicht englische Text ist maschinell übersetzt und steht noch zur menschlichen Überprüfung aus, sodass eine Formulierung gelegentlich holprig klingen kann; die Bedeutung soll dem englischen Original entsprechen. Wenn dir eine Fehlübersetzung auffällt, eröffne bitte ein Issue im Codeberg-Issue-Tracker.

Datenschutz

Reveal URLs sendet in keiner seiner Formen E-Mail- oder Nachrichtendaten an uns oder an irgendeinen Dritten — es gibt kein Analytics und kein Tracking. Wie und wo die Arbeit geschieht, hängt von der Form ab:

Das Einzige, was gespeichert wird, sind deine eigenen Einstellungen (wie ein-/ausgeschaltet, Aufdeckungsmodus, Farben, Schriftgrößen, deine Ignorierliste und etwaige Sites, die du hinzugefügt hast), aufbewahrt im benutzerbezogenen Speicher deines Browsers, von Outlook oder von Google und nie an uns gesendet.

Siehe die Datenschutzerklärung für alle Details.

Fehlerbehebung

Ein Link wird nicht aufgedeckt.

Ein eingebauter Anbieter funktionierte nach einer Neugestaltung nicht mehr.

Webmail-Anbieter ändern von Zeit zu Zeit ihr Seiten-Markup. Wenn der Selektor eines eingebauten Anbieters nach einer solchen Änderung nicht mehr übereinstimmt, kannst du dies selbst korrigieren: bearbeite in Aktive Sites den Nachrichtentext-Selektor dieses Anbieters auf den neuen Container.

Die Tooltip-URL wird nicht angezeigt.

Im Modus Tooltip (Titel) wird die tatsächliche URL im Tooltip des Links platziert, sodass sie nur erscheint, wenn du mit dem Mauszeiger über den Link fährst. Wenn du die URL lieber ohne Überfahren sehen möchtest, schalte URL aufdecken auf den Modus inline um.

Lizenz und Quellcode

Reveal URLs ist freie Software, lizenziert unter der GNU Affero General Public License v3.0 (AGPL-3.0-only).