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.

Hvad det gør og hvorfor

En phishing-e-mail skjuler en fjendtlig destination bag troværdigt udseende linktekst. Teksten kan vise paypal.com, mens linket i virkeligheden peger på paypa1.com eller en anden look-alike-host. Den synlige tekst kan lyve; den reelle destination kan ikke.

Reveal URLs læser hvert link i den besked, du læser, og viser dig dets reelle destination. Når den host, der nævnes i linkteksten, ikke stemmer overens med den host, linket reelt peger på, markerer Reveal URLs det, så uoverensstemmelsen er tydelig, før du klikker.

En Gmail-besked med Reveal URLs aktiv: et vildledende link er markeret med rødt med dets reelle sporingsdestination afsløret over linkteksten, mens et ærligt link vises med grønt.

Alt sker på din egen enhed. Reveal URLs sender intet til os eller til nogen tredjepart — der er ingen server, ingen analyse og ingen sporing. Se 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)

Når det er udgivet, installerer du Reveal URLs fra storen til din browser eller mailklient. Udgivelsen er stadig under behandling, så disse opslag er den tilsigtede distributionsrute og endnu ikke fungerende links:

Chrome — Chrome Web Store
Edge — Microsoft Edge Add-ons
Opera — Opera-add-onssitet
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.

Reveal URLs annoterer en Gmail-besked: hvert links reelle destination vises på sin egen linje over linkteksten, med et ikke-overensstemmende sporingslink markeret med rødt og et ærligt link med grønt.

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.

Indstillingssiden: tilstandsvælgeren 'Afslør URL'en', kontakten 'Fremhæv ikke-overensstemmende links', og felterne for uoverensstemmelses- og overensstemmelsesfarve.

Værktøjslinjeknappen

I Chrome, Edge, Opera og Firefox er Reveal URLs-værktøjslinjeikonet en hurtig til/fra-kontakt — klik på det for at skifte annotering. Når udvidelsen er slået fra, vises et OFF-mærke på ikonet, og dets værktøjstip fortæller dig, om et klik vil slå den til eller fra. Ændringen træder i kraft i hver åben fane på én gang.

(Thunderbird har ikke denne værktøjslinjeknap; brug i stedet 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 green eller #0a0). Standarden er grøn.
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.

De nederste indstillinger: listen 'Ignorér disse hosts', den maksimale viste URL-længde, og de valgfrie felter for skriftstørrelse og -vægt for afsløret URL og advarselsmærke, over 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.

Toppen af indstillingssiden: hovedkontakten 'Aktivér Reveal URLs' og listen 'Aktive sites', hvor hver indbygget udbyder viser sit matchmønster, en kontakt 'Aktiveret', en kontakt 'Underrammer' og sin beskedtekst-selektor.

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:

Under Tilføj site, indtast en Match-URL — et matchmønster som https://mail.example.com/*.
Indtast en Beskedtekst-selektor — en CSS-selektor for den container, der indeholder beskedteksten, for eksempel .message-body.
Hvis beskedteksten gengives inde i en underramme, sæt flueben ved Kør også inde i underrammer.
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.

Privatliv

Reveal URLs fungerer udelukkende på din egen enhed. For at afsløre og kontrollere links læser det — kun inden for den side, du ser — den synlige tekst og destinationen for linkene i den besked, du læser, plus sidens farver (så den afslørede URL forbliver læsbar). Dette læses, mens siden gengives; det gemmes aldrig og overføres aldrig.

Det eneste, det gemmer, er dine egne indstillinger (såsom aktiveret/deaktiveret, afsløringstilstand, farver, skriftstørrelser, din ignoreringsliste og eventuelle sites, du har tilføjet). Disse gemmes i din browsers udvidelseslager. Hvis din browsers synkronisering er slået til, kan dine indstillinger synkroniseres på tværs af dine indloggede enheder, håndteret af din browserleverandør — aldrig sendt til os. Reveal URLs overfører intet.

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