Reveal URLs — Brugervejledning

Reveal URLs er en lille browserudvidelse (og Thunderbird-tilføjelse), der viser dig, hvor et link i din e-mail i virkeligheden fører hen, så du kan opdage et phishing-link, før du klikker på det.

Denne vejledning forklarer, hvordan du installerer Reveal URLs, og hvordan du bruger det. For hvordan dine data håndteres, se privatlivspolitikken; for et teknisk overblik over, hvordan udvidelsen er bygget, se arkitekturoversigten.

Har du fundet en fejl, et link der blev markeret forkert (eller overset), eller en webmail-host der bør understøttes? Rapportér det venligst på Codeberg-issuetrackeren.

Indhold

• Hvad det gør og hvorfor
• Understøttede browsere og mailklienten
• Installation
• Sådan bruger du det
• Outlook- og Gmail-tilføjelserne
• Sprog
• Privatliv
• Fejlfinding
• Licens og kildekode

Hvad det gør og hvorfor

En phishing-e-mail skjuler en fjendtlig destination bag troværdigt udseende linktekst. Nogle gange er det en lignende vært: teksten viser paypal.com, mens linket peger på paypa1.com. Ofte er det mere subtilt og dirigeres gennem en sporings- eller omdirigeringstjeneste, så det sted, du ender, slet ikke ligner det mærke, der er nævnt i teksten.

Bemærk: Dette skærmbillede viser en svigagtig phishingmail, der udgiver sig for at være PostNord Danmark. PostNord Danmark er ikke tilknyttet Reveal URLs og støtter det ikke.

Reveal URLs læser hvert link i den besked, du læser, og viser dig den URL, det faktisk peger på. Når den vært, der nævnes i linkteksten, ikke stemmer overens med den vært, markerer Reveal URLs det, så uoverensstemmelsen er tydelig, før du klikker.

I browserudvidelsen og Thunderbird-tilføjelsen sker alt på din egen enhed, og intet overføres. På tværs af hver form sender Reveal URLs ingen af dine e-mail-data til os eller til nogen tredjepart — der er ingen analyse og ingen sporing. (Formerne adskiller sig i, hvor de kører, og hvordan koden til Outlook-ruden serveres; se afsnittet Privatliv og privatlivspolitikken for alle detaljer.)

Understøttede browsere og mailklienten

Reveal URLs kører på:

• Google Chrome
• Microsoft Edge
• Opera
• Mozilla Firefox
• Mozilla Thunderbird (desktop-mailklienten)

En Safari-build leveres endnu ikke; den er planlagt til en senere fase.

På browsermålene annoterer Reveal URLs links i din webmail. I Thunderbird annoterer det linkene i den e-mail, du læser, direkte i mailklienten.

Installation

Fra din browsers eller mailklients store (anbefalet)

Installer Reveal URLs fra butikken til din browser eller mailklient. Listerne for Chrome, Edge, Firefox og Thunderbird er aktive; Opera kører Chrome-builden, og en dedikeret Opera-liste er stadig på vej:

• Chrome — Chrome Web Store
• Edge — Microsoft Edge Add-ons
• Opera — installer Chrome-versionen fra Chrome Web Store; en dedikeret Opera-liste kommer snart
• Firefox — Firefox Add-ons (AMO)
• Thunderbird — Thunderbird Add-ons (ATN)

Selv at indlæse en build (udviklere og tidlig testning)

Hvis du har bygget Reveal URLs fra kildekoden, kan du indlæse den udpakkede build direkte. Hvert mål bygges med en make-kommando og produceres under 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

Indlæs derefter den resulterende mappe:

• Chrome — åbn chrome://extensions, slå Udviklertilstand til, klik på Indlæs upakket og vælg dist/chrome.
• Edge — åbn edge://extensions, slå Udviklertilstand til, klik på Indlæs upakket og vælg dist/edge.
• Opera — åbn opera://extensions, slå Udviklertilstand til, klik på Indlæs upakket og vælg dist/opera.
• Firefox — åbn about:debugging, vælg Denne Firefox, klik på Indlæs midlertidig tilføjelse og vælg en vilkårlig fil i dist/firefox (for eksempel dens manifest.json). En midlertidig tilføjelse fjernes, når Firefox genstarter.
• Thunderbird — installér den midlertidige tilføjelse fra dist/thunderbird på samme måde (via Værktøjer → Udviklerværktøjer → Fejlfind tilføjelser → Indlæs midlertidig tilføjelse).

Indstillingssiden åbnes automatisk, første gang udvidelsen installeres.

Sådan bruger du det

Lige ud af boksen annoterer Reveal URLs linkene i beskeder hos de indbyggede udbydere — ingen opsætning påkrævet:

• Gmail (mail.google.com)
• Outlook Live (outlook.live.com)
• Outlook på nettet / Microsoft 365 (outlook.office.com)
• Proton Mail (mail.proton.me)

Annotering er afgrænset til beskedteksten, så appens egen chrome — dens sidebjælke, skrivevindue og værktøjslinjer — efterlades urørt. I Thunderbird dækkes hele den gengivne e-mail.

De to afsløringstilstande

Du vælger, hvordan den reelle URL vises, under Afslør URL'en på indstillingssiden:

• Inline — den reelle URL vises på sin egen linje, lige over linkteksten. Dette er standarden.
• I linkets værktøjstip (titel) — den reelle URL placeres i linkets værktøjstip, så den vises, når du holder musen over linket.

Markering af uoverensstemmelser

Når den host, der nævnes i et links synlige tekst, ikke stemmer overens med den host, linket reelt peger på, markerer Reveal URLs det som en uoverensstemmelse. Sammenligningen foretages på det registrerbare domæne, så et ærligt underdomæne som mail.example.com for example.com markeres ikke, mens en look-alike som paypa1.com for paypal.com gør.

• I tilstanden inline vises en uoverensstemmelse i din valgte uoverensstemmelsesfarve og med fed.
• I tilstanden værktøjstip (titel) tilføjes et særskilt ⚠ URL-uoverensstemmelse-mærke ved siden af linket.

To relaterede indstillinger styrer dette:

• Fremhæv ikke-overensstemmende links slår uoverensstemmelsesbetoningen til eller fra.
• Annotér kun ikke-overensstemmende links efterlader ærlige links helt urørte, så kun de mistænkelige afsløres.

Værktøjslinjeknappen

I Chrome, Edge, Opera, Firefox og Thunderbird er ikonet for Reveal URLs på værktøjslinjen en hurtig tænd/sluk-knap — klik på det for at slå annotering til eller fra. Når udvidelsen er slået fra, vises et OFF-mærke på ikonet, og værktøjstipset fortæller dig, om et klik vil slå den til eller fra. I browserne træder ændringen i kraft i alle åbne faner på én gang; i Thunderbird gælder den for den næste meddelelse, du åbner.

(I Thunderbird viser knappen kun sit ikon, så den forbliver kompakt i den samlede værktøjslinje. Du kan også slå Reveal URLs til og fra med kontakten Aktivér på indstillingssiden.)

Indstillingssiden

Indstillingssiden indeholder hver indstilling. Åbn den fra din browsers udvidelsesside (for eksempel Detaljer → Udvidelsesindstillinger), eller den åbnes automatisk ved første installation.

• Aktivér Reveal URLs — hovedkontakten til/fra, helt øverst på siden. Den træder i kraft med det samme, uden at resten af formularen behøver at blive gemt.
• Visningssprog — vælg det sprog, indstillingssiden vises på. Som standard følger den din browsers sprog med engelsk som tilbagefald; vælg et andet fra listen for at tilsidesætte det. Dit valg træder i kraft med det samme, huskes til næste gang og gemmes kun på denne enhed (det ændrer aldrig resten af dine indstillinger).
• Afslør URL'en — vælg tilstanden inline eller værktøjstip (titel) (se ovenfor).
• Fremhæv ikke-overensstemmende links — slå uoverensstemmelsesbetoningen til eller fra.
• Uoverensstemmelsesfarve — den CSS-farve, der bruges til et markeret link (for eksempel red, #cc0000 eller rgb(200, 0, 0)). Standarden er rød.
• Overensstemmelsesfarve — farven på den afslørede URL på ærlige (ikke-uoverensstemmende) links (for eksempel black eller #1a1a1a). Standarden er en neutral, meget mørkegrå (#1a1a1a), valgt så farven ikke antyder, at linket er blevet kontrolleret.
• Annotér kun ikke-overensstemmende links — efterlad ærlige links urørte.
• Ignorér disse hosts — en liste over værtsnavne, der skal springes helt over, ét pr. linje. Underdomæner af en angivet host springes også over.
• Maksimal vist URL-længde — lange URL'er afkortes ud over dette antal tegn, så hosten forbliver synlig. Tilladt interval: 20 til 2000.
• Skriftstørrelse / -vægt for afsløret URL og Skriftstørrelse / -vægt for advarselsmærke — valgfrie typografi-tilsidesættelser; lad stå tomt for at beholde standardværdierne.

Bortset fra hovedkontakten Aktivér og betjeningen af Aktive sites (som anvendes med det samme), gemmes ændringer med knappen Gem indstillinger.

Aktive sites — tilføj din egen webmail

Afsnittet Aktive sites, øverst på indstillingssiden, viser de sider, Reveal URLs kører på, og den container, der indeholder hver beskedtekst.

Hver række viser:

• sitets matchmønster (for eksempel https://mail.example.com/*);
• en kontakt Aktiveret;
• beskedtekst-selektoren (CSS-selektoren for den container, Reveal URLs annoterer), som du kan redigere;
• en kontakt Underrammer, for sites hvis beskedtekst gengives inde i en iframe;
• en knap Fjern (kun for dine egne sites).

De indbyggede udbydere (Gmail, Outlook og Proton) kan slås fra og rettes mod et nyt mål, men de kan ikke fjernes.

Sådan tilføjer du dit eget webmail-site:

1. Under Tilføj site, indtast en Match-URL — et matchmønster som https://mail.example.com/*.
2. Indtast en Beskedtekst-selektor — en CSS-selektor for den container, der indeholder beskedteksten, for eksempel .message-body.
3. Hvis beskedteksten gengives inde i en underramme, sæt flueben ved Kør også inde i underrammer.
4. Klik på Tilføj site. Din browser vil bede om tilladelse til at få adgang til det site; giv den. Sitet tilføjes først, når du giver tilladelsen.

Ændringer her anvendes med det samme. Når du fjerner et site, du har tilføjet, tilbagekaldes også dets tilladelse, så Reveal URLs holder op med at tilgå det.

Thunderbird (og andre mailklienter). Thunderbird viser allerede hver besked, du læser, uanset udbyder, så den har ikke brug for en liste pr. host. Afsnittet Aktive sites vises derfor ikke på Thunderbird-indstillingssiden — kun hovedkontakten, visningssprog, afsløringstilstand, farver, skrifttyper og ignoreringslisten vises. Enhver aktive-sites-konfiguration, du måtte have angivet i en browser, bevares urørt: at gemme Thunderbird-indstillingerne rydder den aldrig.

Outlook- og Gmail-tilføjelserne

Ved siden af browserudvidelsen og Thunderbird-tilføjelsen findes Reveal URLs som en indbygget tilføjelse til to mailapps, en browserudvidelse ikke kan nå: et Outlook-tilføjelsesprogram og en Gmail-tilføjelse. Begge bruger den samme linkdetektion som udvidelsen, så de afslører de samme URL'er og markerer de samme look-alike-hosts.

Den ene forskel er, hvordan de viser deres fund. Browserudvidelsen annoterer linkene på stedet — den farver URL'en over eller ved siden af hvert link. Outlook- og Gmail-rammerne tillader ikke en tilføjelse at ændre den gengivne besked, så i stedet viser hver tilføjelse et sidepanel (Outlook) eller kort (Gmail), der opremser de fundne links. For hvert link viser den den synlige tekst, destinations-URL'en og den registrerbare host, og den markerer en uoverensstemmelse, når den synlige tekst nævner et andet registrerbart domæne, end linket reelt peger på.

• Outlook-tilføjelsesprogram — en opgaverude, der læser den besked, du har åben, og analyserer den på din egen enhed; ingen e-mail- eller beskeddata sendes nogen steder hen. Dens opgaverudekode (HTML, JavaScript, CSS og ikoner) indlæses fra https://www.reveal-urls.eu over HTTPS, som det sker, når du åbner en hvilken som helst webside. Den når Outlook på nettet, Windows, Mac, iOS og Android samt Outlook.com.
• Gmail-tilføjelse — et kort i Gmails sidebjælke. Åbn en besked, og klik derefter på Reveal URLs-ikonet i den højre sidebjælke for at se dens links: Gmail åbner ikke kortet af sig selv, men hvis du lader panelet stå åbent, opdateres det, når du bevæger dig mellem beskeder. Hvert links URL vises i en neutral mørkegrå for et ærligt link og rødt for en look-alike. Den når Gmail på nettet, Android og iOS. I modsætning til de andre former kører Gmail-tilføjelsen på Googles servere (sådan fungerer Gmail-tilføjelser): den besked, du åbner, læses og kontrolleres dér, hver gang du åbner den, og bevares ikke. Se privatlivspolitikken for, hvad hver form tilgår og gemmer.

Begge tilføjelser vil blive distribueret gennem deres app-butikker — Outlook-tilføjelsesprogrammet via Microsoft AppSource, Gmail-tilføjelsen via Google Workspace Marketplace. Udgivelse afventer; direkte installationslinks tilføjes her, når hver liste er aktiv.

Sprog

Reveal URLs er tilgængelig på engelsk og mange andre sprog.

• Indstillingssiden følger din browsers sprog automatisk med engelsk som tilbagefald, når dit sprog ikke er et af de ovenstående. Du kan tilsidesætte det når som helst med Visningssprog-vælgeren nær toppen af siden; dit valg huskes på den enhed (se Indstillingssiden).
• Dette website (hjemmesiden og disse dokumentationssider) registrerer også din browsers sprog og tilbyder en sprogvælger i headeren. Vejlednings- og privatlivssiderne er tilgængelige oversat; hvor en side endnu ikke har en oversættelse, vises den på engelsk.

Den ikke-engelske tekst er maskinoversat og afventer menneskelig gennemgang, så en sætning kan af og til læses akavet; meningen er tænkt at svare til den engelske original. Hvis du opdager en fejloversættelse, så åbn venligst et issue på Codeberg-issuetrackeren.

Privatliv

Reveal URLs sender ingen af dine e-mail- eller beskeddata til os eller til nogen tredjepart, i nogen af sine former — der er ingen analyse og ingen sporing. Hvordan og hvor arbejdet sker, afhænger af formen:

• Browserudvidelsen og Thunderbird-tilføjelsen fungerer udelukkende på din egen enhed og overfører intet: de læser linkteksten, URL'erne og sidens farver, mens siden gengives, og gemmer eller sender dem aldrig.
• Outlook-tilføjelsesprogrammet analyserer den åbne besked på din egen enhed og sender ingen e-mail- eller beskeddata nogen steder hen; dets opgaverudekode (HTML, JavaScript, CSS og ikoner) indlæses fra https://www.reveal-urls.eu over HTTPS, som det sker, når du åbner en hvilken som helst webside.
• Gmail-tilføjelsen kører på Googles egne servere (sådan fungerer Gmail-tilføjelser): den åbne besked læses og kontrolleres dér, hver gang du åbner den, og bevares ikke.

Det eneste, der gemmes, er dine egne indstillinger (såsom aktiveret/deaktiveret, afsløringstilstand, farver, skriftstørrelser, din ignoreringsliste og eventuelle sites, du har tilføjet), opbevaret i din browsers, Outlooks eller Googles lager pr. bruger og aldrig sendt til os.

Se privatlivspolitikken for alle detaljer.

Fejlfinding

Et link afsløres ikke.

• Kontrollér, at Reveal URLs er slået til — værktøjslinjeikonet må ikke vise OFF-mærket, og kontakten Aktivér Reveal URLs på indstillingssiden skal være slået til.
• Kontrollér, at sitet er dækket. Indbyggede udbydere (Gmail, Outlook, Proton) fungerer lige ud af boksen; enhver anden webmail skal tilføjes under Aktive sites med dens match-URL og beskedtekst-selektor.
• Kontrollér beskedtekst-selektoren. Hvis den ikke stemmer overens med den container, der indeholder beskedteksten, afsløres links inde i den container ikke.
• Bemærk, at links til interne ankre, og links der bruger andre skemaer end http/https (såsom mailto:), bevidst springes over — det samme gælder hosts på din liste Ignorér disse hosts.

En indbygget udbyder holdt op med at virke efter et redesign.

Webmail-udbydere ændrer deres sideopmærkning fra tid til anden. Hvis en indbygget udbyders selektor ikke længere stemmer overens efter en sådan ændring, kan du selv rette det: i Aktive sites, redigér den pågældende udbyders beskedtekst-selektor til den nye container.

Værktøjstip-URL'en vises ikke.

I tilstanden værktøjstip (titel) placeres den reelle URL i linkets værktøjstip, så den kun vises, når du holder musen over linket. Hvis du hellere vil se URL'en uden at holde musen over, skift Afslør URL'en til tilstanden inline.

Licens og kildekode

Reveal URLs er fri software, licenseret under GNU Affero General Public License v3.0 (AGPL-3.0-only).

• Kildekode: https://codeberg.org/Magentron/reveal-urls
• Teknisk overblik: Arkitektur
• Videre læsning om link-phishing: Email link phishing: your app should always show the URL