Reveal URLs

Safari is supported through its macOS Xcode container and App Store route. Built-in providers use static scripts and Safari requests no all-sites access. A user-added site needs a runtime optional permission, then Safari injects content.js after navigation only for a granted, enabled, non-builtin rule; sub-frames run only when All frames is enabled. Safari settings are device-local and do not roam.

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. Zie voor veelgestelde vragen de veelgestelde vragen; voor hoe er met je gegevens wordt omgegaan, zie het privacybeleid; voor een technisch overzicht, 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 een postdienst:

Een phishingmail die zich voordoet als een postdienst 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 die postdienst 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 de nagebootste dienst.

Let op: Deze schermafbeelding toont een frauduleuze phishingmail die zich voordoet als een postdienst. De nagebootste dienst 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. In de browserextensie en Thunderbird markeert het misleidende web-, e-mail-, telefoon- en andere koppelingen, zodat het verschil duidelijk is voordat je klikt.

Reveal URLs onthult en markeert; het keurt niet. Het volgt geen omleidingen: een koppeling die via een tracker of omleider loopt, wordt getoond als de URL van de omleider die hij daadwerkelijk noemt; Reveal URLs kan niet zien waar die omleiding uiteindelijk eindigt. Bij een link zonder waarschuwing is geen toepasselijke afwijking vastgesteld, niet bevestigd als veilig, dus lees de onthulde URL voordat je een link vertrouwt, ook als er niets is gemarkeerd. Om dat te onthouden wordt de onthulde URL bij een niet-gemarkeerde link in een amberkleurige „controleren“-kleur getoond in plaats van een geruststellend groen.

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 koppeling zonder afwijking zonder waarschuwing wordt onthuld.

Opmerking: e-mailadressen, URL's en namen in deze schermafbeelding zijn voor de privacy met sterretjes gemaskeerd.

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 mailapps

Reveal URLs draait op:

Webbrowsers:

Mailtoepassingen:

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. Alle vermeldingen zijn nu beschikbaar; Opera werkt met de Chrome-build.

Webbrowsers:

Mailtoepassingen:

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        # maakt dist/chrome
make build-edge          # maakt dist/edge
make build-firefox       # maakt dist/firefox
make build-gmail         # maakt dist/gmail
make build-opera         # maakt dist/opera
make build-outlook       # maakt dist/outlook
make build-safari        # maakt dist/safari
make build-thunderbird   # maakt dist/thunderbird

Laad vervolgens de resulterende map:

De Safari-extensie, de Outlook-add-in en de Gmail-add-on worden niet als uitgepakte browserextensies geladen. Bouw ze zoals hierboven en vervolgens:

make deploy-gmail        # implementeert de Gmail-add-on in Apps Script
make safari-xcode        # bouwt het Safari Xcode-project en voer het daarna uit
                         # vanuit het Develop-menu van Safari (macOS)
                         # Outlook: laad dist/outlook als sideload

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 koppeling zonder afwijking zonder waarschuwing onthuld.

Opmerking: e-mailadressen, URL's en namen in deze schermafbeelding zijn voor de privacy met sterretjes gemaskeerd.

Hoe de werkelijke URL wordt getoond

De werkelijke URL van elke koppeling wordt op een eigen regel weergegeven, net boven de koppelingstekst. Deze wordt ook in de tooltip (titel) van de koppeling geplaatst, zodat de volledige URL er altijd is wanneer je met de muis over de koppeling beweegt.

Markeren van niet-overeenkomende koppelingen

Bij webkoppelingen vergelijkt Reveal URLs een URL of hostnaam in de zichtbare tekst van een koppeling met de URL waar deze naartoe wijst. De vergelijking gebeurt op het registreerbare domein, dus een subdomein zonder afwijking zoals mail.example.com voor example.com wordt niet gemarkeerd, terwijl een look-alike zoals paypa1.com voor paypal.com dat wel is. De browserextensie en Thunderbird controleren ook e-mail-, telefoon- en ondoorzichtige koppelingen; javascript:, data: en vbscript:-koppelingen worden altijd gemarkeerd.

De controle bekijkt alleen de URL die de koppeling zelf noemt; omleidingen worden nooit gevolgd, dus een koppeling via een tracker of omleider wordt vergeleken als diens URL, niet als de pagina die hij uiteindelijk bereikt.

Een mismatch wordt getoond in je gekozen mismatchkleur en vetgedrukt.

Twee gerelateerde instellingen sturen dit aan:

De instellingenpagina: de moduskiezer 'Onthul de URL', de schakelaar 'Markeer niet-overeenkomende koppelingen', en de velden voor de mismatchkleur en kleur zonder afwijking.

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.

Terwijl Reveal URLs is ingeschakeld, vertelt het werkbalkpictogram van de browser u ook, per tabblad, wat het op de huidige pagina heeft gevonden. Als de pagina niet-overeenkomende (gelijkende) koppelingen bevat, toont het pictogram dat aantal op een rode badge; als de pagina koppelingen bevat maar geen ervan afwijkt, toont het het totale aantal geanalyseerde koppelingen op een grijze badge; een pagina zonder analyseerbare koppelingen (en elke pagina waarop de extensie niet actief is) toont geen aantal. Elk tabblad houdt zijn eigen badge, dus wisselen van tabblad werkt het getal bij, en de pagina verlaten of het tabblad sluiten wist het. (Aantallen boven 99 worden weergegeven als 99+.)

De badge in zijn toestanden (de browser tekent hem, dus de exacte plaatsing verschilt een beetje per browser): een rood aantal afwijkingen, een grijs aantal geanalyseerde koppelingen en de OFF-badge terwijl de extensie is uitgeschakeld; het logo is dan ook gedempt lichtgrijs. Op een pagina waarop de ingeschakelde extensie niet actief is, is er geen badge; de ontbrekende OFF-badge onderscheidt datzelfde gedempte logo van de uitgeschakelde toestand.

Deze illustraties tonen niet elke situatie zonder badge; een actieve pagina zonder analyseerbare koppelingen behoudt het normaal gekleurde pictogram.

Werkbalkpictogram met een rode badge met het aantal niet-overeenkomende koppelingen op de huidige pagina Werkbalkpictogram met een grijze badge met het aantal geanalyseerde koppelingen op de huidige pagina Werkbalkpictogram met een gedempt lichtgrijs logo zonder badge terwijl de ingeschakelde extensie op deze pagina niet actief is Werkbalkpictogram met de rode OFF-badge terwijl de extensie is uitgeschakeld

(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, 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. Ze houdt nu een vaste hoogte: kies één site uit de keuzelijst en bewerk alleen de instellingen van die site in het paneel eronder.

De bovenkant van de instellingenpagina: de hoofdschakelaar 'Enable Reveal URLs' en de sectie 'Active sites', met een keuzelijst 'Active site' boven één editor voor de geselecteerde site die het match pattern, een schakelaar 'Enabled', een schakelaar 'Sub-frames' en zijn message-body selector toont.

De keuzelijst toont één item per siteregel:

De editor van de geselecteerde site toont:

De ingebouwde providers (FastMail, Gmail, Outlook Live, Outlook 365, Proton, Tuta, Yahoo en Zoho) kunnen worden uitgeschakeld en opnieuw gericht, maar ze kunnen niet worden verwijderd. Hun namen kunnen hier ook worden hernoemd; als je de naam van een ingebouwde aanbieder wist, wordt de standaardvriendelijke naam hersteld.

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 optioneel een Name in voor de keuzelijst. Laat die leeg om terug te vallen op de match-URL.
  3. Voer een Message-body selector in — een CSS-selector voor de container die de berichttekst bevat, bijvoorbeeld .message-body.
  4. Als de berichttekst in een subframe wordt weergegeven, vink Also run inside sub-frames aan.
  5. Klik op Add site. 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. Om de match-URL van een site te wijzigen, verwijder je deze en voeg je haar opnieuw toe: de match blijft alleen-lezen omdat dit de identiteit van de regel is.

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, 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. Ze delen de http/https-URL-/hostdetectie van de browserextensie, maar analyseren de aanvullende koppelingsschema's daarvan niet.

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 http/https-koppeling toont het de zichtbare tekst en de URL, en markeert het alleen een mismatch wanneer de zichtbare tekst een URL of hostnaam noemt waarvan het registreerbare domein niet met dat van het koppelingsdoel overeenkomt.

De Gmail-add-on is nu beschikbaar via Google Workspace Marketplace.

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, 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.

Licentie en broncode

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

Safari-opmerkingen

Safari toont alleen een badge wanneer links niet overeenkomen; er is geen grijze teller voor veilige pagina's. Open instellingen opnieuw via het rechtermuisknop- menu Reveal URLs — settings, in plaats van een oud instellingstabblad te laden.