Reveal URLs

Reveal URLs — Handleiding

Reveal URLs is een kleine browserextensie (en Thunderbird-add-on) die je laat zien waar een koppeling in je e-mail werkelijk naartoe gaat, zodat je een phishing-link kunt herkennen voordat je erop klikt.

Deze handleiding legt uit hoe je Reveal URLs installeert en hoe je het gebruikt. Voor hoe er met je gegevens wordt omgegaan, zie het privacybeleid; voor een technisch overzicht van hoe de extensie is gebouwd, zie het architectuuroverzicht.

Een bug gevonden, een koppeling die ten onrechte werd gemarkeerd (of gemist), of een webmailhost die ondersteund zou moeten worden? Meld het op de Codeberg-issuetracker.

Inhoud

Wat het doet en waarom

Een phishing-e-mail verbergt een vijandige bestemming achter betrouwbaar ogende koppelingstekst. Soms is het een lijkende host: de tekst toont paypal.com terwijl de koppeling naar paypa1.com verwijst. Vaak is het subtieler en loopt het via een tracker of een doorverwijzer, zodat waar je uitkomt totaal niet lijkt op het merk dat in de tekst wordt genoemd.

Dit is niet hypothetisch. Het onderstaande bericht is een echte phishingmail, vermomd als een pakketbezorgingsmelding van PostNL, de Nederlandse postdienst:

Een phishingmail die zich voordoet als de Nederlandse postdienst PostNL beweert dat een pakket wordt vastgehouden totdat openstaande douanekosten zijn betaald en dringt aan op betaling via een knop „Ga naar betaling“. Reveal URLs laat zien dat de knop niet naar PostNL verwijst, maar naar parcel-pay.custom.co.xa, een niet-gerelateerde site, en ontmaskert het bericht zo als oplichting.
Reveal URLs ontmaskert de knop „Ga naar betaling“: die verwijst naar parcel-pay.custom.co.xa, niet naar PostNL.

Let op: Deze schermafbeelding toont een frauduleuze phishingmail die zich voordoet als PostNL. PostNL is niet verbonden aan Reveal URLs en ondersteunt het niet.

Reveal URLs leest elke koppeling in het bericht dat je leest en toont je de URL waar hij echt naartoe wijst. Wanneer de host die in de koppelingstekst wordt genoemd niet overeenkomt met die host, markeert Reveal URLs dit, zodat het verschil duidelijk is voordat je klikt.

Een Gmail-bericht met Reveal URLs actief: een misleidende koppeling is rood gemarkeerd met de tracking-URL waar ze naartoe wijst onthuld boven de koppelingstekst, terwijl de URL van een eerlijke koppeling zonder waarschuwing wordt onthuld.

In de browserextensie en de Thunderbird-add-on gebeurt alles op je eigen apparaat en wordt er niets verzonden. In al zijn vormen stuurt Reveal URLs geen van je e-mailgegevens naar ons of naar een derde partij — er is geen analytics en geen tracking. (De vormen verschillen in waar ze draaien en hoe de code van het Outlook-venster wordt aangeboden; zie de sectie Privacy en het privacybeleid voor alle details.)

Ondersteunde browsers en de mailclient

Reveal URLs draait op:

Een Safari-build wordt nog niet geleverd; die staat gepland voor een latere fase.

Op de browserdoelen annoteert Reveal URLs koppelingen in je webmail. In Thunderbird annoteert het de koppelingen in de e-mail die je leest, rechtstreeks in de mailclient.

Installeren

Vanuit de store van je browser of mailclient (aanbevolen)

Installeer Reveal URLs vanuit de store voor je browser of mailclient. De vermeldingen voor Chrome, Edge, Firefox en Thunderbird zijn live; Opera werkt met de Chrome-build, en een aparte Opera-vermelding is nog onderweg:

Zelf een build laden (ontwikkelaars en vroeg testen)

Als je Reveal URLs vanuit de broncode hebt gebouwd, kun je de uitgepakte build rechtstreeks laden. Elk doel wordt gebouwd met een make-opdracht en geproduceerd onder dist/<target>/:

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

Laad vervolgens de resulterende map:

De instellingenpagina opent automatisch wanneer de extensie voor het eerst wordt geïnstalleerd.

Het gebruiken

Out of the box annoteert Reveal URLs de koppelingen in berichten bij de ingebouwde providers — geen instelwerk nodig:

Annotatie is afgebakend tot de berichttekst, zodat de eigen chrome van de app — de zijbalk, het opstelvenster en de werkbalken — onaangeroerd blijft. In Thunderbird wordt de hele weergegeven e-mail gedekt.

Reveal URLs annoteert een Gmail-bericht: de URL van elke koppeling wordt op een eigen regel boven de koppelingstekst getoond, met een niet-overeenkomende trackinglink rood gemarkeerd en de URL van een eerlijke koppeling zonder waarschuwing onthuld.

De twee onthulmodi

Je kiest hoe de werkelijke URL wordt getoond, onder Onthul de URL op de instellingenpagina:

Markeren van niet-overeenkomende koppelingen

Wanneer de host die in de zichtbare tekst van een koppeling wordt genoemd niet overeenkomt met de host waar de koppeling echt naartoe wijst, markeert Reveal URLs dit als een mismatch. De vergelijking gebeurt op het registreerbare domein, dus een eerlijk subdomein zoals mail.example.com voor example.com wordt niet gemarkeerd, terwijl een look-alike zoals paypa1.com voor paypal.com dat wel is.

Twee gerelateerde instellingen sturen dit aan:

De instellingenpagina: de moduskiezer 'Onthul de URL', de schakelaar 'Markeer niet-overeenkomende koppelingen', en de velden voor de mismatch- en matchkleur.

De werkbalkknop

In Chrome, Edge, Opera, Firefox en Thunderbird is het werkbalkpictogram van Reveal URLs een snelle aan/uit-schakelaar: klik erop om annotatie in of uit te schakelen. Wanneer de extensie is uitgeschakeld, verschijnt er een badge OFF op het pictogram, en de tooltip vertelt je of klikken haar in- of uitschakelt. In de browsers wordt de wijziging meteen in alle geopende tabbladen van kracht; in Thunderbird geldt ze voor het volgende bericht dat je opent.

(In Thunderbird toont de knop alleen het pictogram, zodat hij compact blijft in de uniforme werkbalk. Je kunt Reveal URLs ook in- en uitschakelen met de schakelaar Inschakelen op de instellingenpagina.)

De instellingenpagina

De instellingenpagina bevat elke optie. Open hem vanaf de extensiepagina van je browser (bijvoorbeeld Details → Extensie-opties), of hij opent automatisch bij de eerste installatie.

Afgezien van de hoofdschakelaar Inschakelen en de bediening van Actieve sites (die meteen worden toegepast), worden wijzigingen opgeslagen met de knop Instellingen opslaan.

De onderste instellingen: de lijst 'Negeer deze hosts', de maximale weergegeven URL-lengte, en de optionele velden voor lettergrootte en -gewicht van de onthulde URL en de waarschuwingsbadge, boven de knop 'Instellingen opslaan'.

Actieve sites — je eigen webmail toevoegen

De sectie Actieve sites, bovenaan de instellingenpagina, somt de pagina's op waarop Reveal URLs draait en de container die elke berichttekst bevat.

De bovenkant van de instellingenpagina: de hoofdschakelaar 'Reveal URLs inschakelen' en de lijst 'Actieve sites', waarbij elke ingebouwde provider zijn overeenkomstpatroon, een schakelaar 'Ingeschakeld', een schakelaar 'Subframes' en zijn berichttekst-selector toont.

Elke rij toont:

De ingebouwde providers (Gmail, Outlook en Proton) kunnen worden uitgeschakeld en opnieuw gericht, maar ze kunnen niet worden verwijderd.

Om je eigen webmailsite toe te voegen:

  1. Voer onder Site toevoegen een Overeenkomst-URL in — een overeenkomstpatroon zoals https://mail.example.com/*.
  2. Voer een Berichttekst-selector in — een CSS-selector voor de container die de berichttekst bevat, bijvoorbeeld .message-body.
  3. Als de berichttekst in een subframe wordt weergegeven, vink Ook binnen subframes uitvoeren aan.
  4. Klik op Site toevoegen. Je browser zal toestemming vragen om toegang te krijgen tot die site; verleen die. De site wordt pas toegevoegd zodra je de toestemming verleent.

Wijzigingen hier worden meteen toegepast. Het verwijderen van een site die je hebt toegevoegd trekt ook de toestemming ervan in, zodat Reveal URLs deze niet meer benadert.

Thunderbird (en andere mailclients). Thunderbird toont al elk bericht dat je leest, ongeacht de provider, dus het heeft geen lijst per host nodig. De sectie Actieve sites wordt daarom niet getoond op de instellingenpagina van Thunderbird — alleen de hoofdschakelaar, weergavetaal, onthulmodus, kleuren, lettertypen en de negeerlijst verschijnen. Elke actieve-sites-configuratie die je in een browser hebt ingesteld, blijft onaangeroerd behouden: het opslaan van de Thunderbird-instellingen wist deze nooit.

De Outlook- en Gmail-add-ons

Naast de browserextensie en de Thunderbird-add-on komt Reveal URLs als een native add-on voor twee mailapps die een browserextensie niet kan bereiken: een Outlook-add-in en een Gmail-add-on. Beide gebruiken dezelfde koppelingdetectie als de extensie, dus ze onthullen dezelfde URL's en markeren dezelfde look-alikehosts.

Het enige verschil is hoe ze hun bevindingen tonen. De browserextensie annoteert de koppelingen ter plaatse — door de URL boven of naast elke koppeling te kleuren. De frameworks van Outlook en Gmail staan een add-on niet toe het weergegeven bericht te wijzigen, dus in plaats daarvan toont elke add-on een zijpaneel (Outlook) of kaart (Gmail) met een lijst van de gevonden koppelingen. Voor elke koppeling toont het de zichtbare tekst, de bestemmings-URL en de registreerbare host, en het markeert een mismatch wanneer de zichtbare tekst een ander registreerbaar domein noemt dan waar de koppeling daadwerkelijk naartoe wijst.

Beide add-ons worden gedistribueerd via hun app stores — de Outlook-add-in via Microsoft AppSource, de Gmail-add-on via de Google Workspace Marketplace. Publicatie is in afwachting; directe installatielinks worden hier toegevoegd zodra elke vermelding live is.

Talen

Reveal URLs is beschikbaar in het Engels en veel andere talen.

De niet-Engelse tekst is machinaal vertaald en wacht op menselijke controle, dus een zin kan af en toe wat onhandig lezen; de bedoeling is dat de betekenis overeenkomt met het Engelse origineel. Als je een verkeerde vertaling opmerkt, open dan een issue op de Codeberg-issuetracker.

Privacy

Reveal URLs stuurt geen van je e-mail- of berichtgegevens naar ons of naar een derde partij, in geen van zijn vormen — er is geen analytics en geen tracking. Hoe en waar het werk gebeurt, hangt af van de vorm:

Het enige dat wordt opgeslagen zijn je eigen instellingen (zoals aan/uit, onthulmodus, kleuren, lettergroottes, je negeerlijst en eventuele sites die je hebt toegevoegd), bewaard in de opslag per gebruiker van je browser, Outlook of Google en nooit naar ons verzonden.

Zie het privacybeleid voor alle details.

Problemen oplossen

Een koppeling wordt niet onthuld.

Een ingebouwde provider werkte niet meer na een herontwerp.

Webmailproviders veranderen hun pagina-opmaak van tijd tot tijd. Als de selector van een ingebouwde provider na zo'n wijziging niet meer overeenkomt, kun je dit zelf corrigeren: bewerk in Actieve sites de berichttekst-selector van die provider naar de nieuwe container.

De tooltip-URL wordt niet getoond.

In de modus tooltip (titel) wordt de werkelijke URL in de tooltip van de koppeling geplaatst, zodat hij alleen verschijnt wanneer je over de koppeling beweegt. Als je de URL liever zonder bewegen ziet, schakel Onthul de URL dan naar de modus inline.

Licentie en broncode

Reveal URLs is vrije software, gelicentieerd onder de GNU Affero General Public License v3.0 (AGPL-3.0-only).