Reveal URLs — Brukerhåndbok

Reveal URLs er en liten nettleserutvidelse (og Thunderbird-tillegg) som viser deg hvor en lenke i e-posten din egentlig fører, slik at du kan oppdage en phishing-lenke før du klikker på den.

Denne håndboken forklarer hvordan du installerer Reveal URLs og hvordan du bruker det. For hvordan dataene dine håndteres, se personvernerklæringen; for en teknisk oversikt over hvordan utvidelsen er bygget, se arkitekturoversikten.

Funnet en feil, en lenke som ble feilaktig merket (eller oversett), eller en webmail-vert som burde støttes? Meld det på Codeberg-feilsporeren.

Hva det gjør og hvorfor

En phishing-e-post skjuler en fiendtlig destinasjon bak tillitvekkende lenketekst. Noen ganger er det en lignende vert: teksten viser paypal.com mens lenken peker mot paypa1.com. Ofte er det mer subtilt og går via en sporer eller en omdirigering, slik at stedet du havner på, ikke ligner i det hele tatt på merket som nevnes i teksten.

En phishing-e-post som utgir seg for å komme fra Posten Norge, hevder at en pakke holdes tilbake til ubetalte tollavgifter er betalt, og oppfordrer til betaling via en knapp merket „Gå til betaling“. Reveal URLs viser at knappen ikke peker til Posten Norge, men til parcel-pay.custom.co.xa, et uvedkommende nettsted, og avslører dermed meldingen som svindel. — Reveal URLs avslører knappen „Gå til betaling“: den peker til `parcel-pay.custom.co.xa`, ikke til Posten Norge.

Merk: Dette skjermbildet viser en svindelaktig phishing-e-post som utgir seg for å være Posten Norge. Posten Norge er ikke tilknyttet Reveal URLs og støtter det ikke.

Reveal URLs leser hver lenke i meldingen du leser og viser deg URL-en den faktisk peker mot. Når verten som er nevnt i lenketeksten ikke stemmer overens med den verten, merker Reveal URLs dette, slik at forskjellen er tydelig før du klikker.

I nettleserutvidelsen og Thunderbird-tillegget skjer alt på din egen enhet, og ingenting overføres. På tvers av hver form sender Reveal URLs ingen av e-postdataene dine til oss eller til noen tredjepart — det finnes ingen analyse og ingen sporing. (Formene skiller seg i hvor de kjører og hvordan Outlook-rutens kode serveres; se seksjonen Personvern og personvernerklæringen for alle detaljer.)

Støttede nettlesere og e-postklienten

Reveal URLs kjører på:

Google Chrome
Microsoft Edge
Opera
Mozilla Firefox
Mozilla Thunderbird (skrivebords-e-postklienten)

En Safari-versjon leveres ennå ikke; den er planlagt for en senere fase.

På nettlesermålene annoterer Reveal URLs lenker i webmailen din. I Thunderbird annoterer det lenkene i e-posten du leser, direkte i e-postklienten.

Installere

Fra nettleserens eller e-postklientens butikk (anbefalt)

Installer Reveal URLs fra butikken for nettleseren eller e-postklienten din. Oppføringene for Chrome, Edge, Firefox og Thunderbird er aktive; Opera kjører Chrome-bygget, og en egen Opera-oppføring er fortsatt på vei:

Chrome — Chrome Web Store
Edge — Microsoft Edge Add-ons
Opera — installer Chrome-versjonen fra Chrome Web Store; en egen Opera-oppføring kommer snart
Firefox — Firefox Add-ons (AMO)
Thunderbird — Thunderbird Add-ons (ATN)

Laste en versjon selv (utviklere og tidlig testing)

Hvis du har bygget Reveal URLs fra kildekoden, kan du laste den utpakkede versjonen direkte. Hvert mål bygges med en make-kommando og produseres 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

Last deretter den resulterende mappen:

Chrome — åpne chrome://extensions, slå på Utviklermodus, klikk på Last inn upakket og velg dist/chrome.
Edge — åpne edge://extensions, slå på Utviklermodus, klikk på Last inn upakket og velg dist/edge.
Opera — åpne opera://extensions, slå på Utviklermodus, klikk på Last inn upakket og velg dist/opera.
Firefox — åpne about:debugging, velg Denne Firefox, klikk på Last inn midlertidig tillegg og velg en hvilken som helst fil i dist/firefox (for eksempel dens manifest.json). Et midlertidig tillegg fjernes når Firefox starter på nytt.
Thunderbird — installer det midlertidige tillegget fra dist/thunderbird på samme måte (via Verktøy → Utviklerverktøy → Feilsøk tillegg → Last inn midlertidig tillegg).

Innstillingssiden åpnes automatisk første gang utvidelsen installeres.

Bruke det

Rett ut av boksen annoterer Reveal URLs lenkene i meldinger hos de innebygde leverandørene — ingen oppsett kreves:

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

Annotering er avgrenset til meldingsteksten, slik at appens eget grensesnitt — dens sidefelt, skrivevindu og verktøylinjer — forblir urørt. I Thunderbird dekkes hele den gjengitte e-posten.

De to avsløringsmodusene

Du velger hvordan den virkelige URL-en vises, under Avslør URL-en på innstillingssiden:

Inline — den virkelige URL-en vises på sin egen linje, like over lenketeksten. Dette er standarden.
I lenkens verktøytips (tittel) — den virkelige URL-en plasseres i lenkens verktøytips, slik at den vises når du holder musepekeren over lenken.

Utheving av ikke-samsvarende lenker

Når verten som er nevnt i den synlige teksten til en lenke ikke stemmer overens med verten lenken faktisk peker mot, merker Reveal URLs dette som et avvik. Sammenligningen gjøres på det registrerbare domenet, så et ærlig underdomene som mail.example.com for example.com blir ikke merket, mens en etterligning som paypa1.com for paypal.com blir det.

I inline-modus vises et avvik i den valgte avviksfargen din og med fet skrift.
I modusen verktøytips (tittel) legges et tydelig ⚠ URL-avvik-merke til ved siden av lenken.

To relaterte innstillinger styrer dette:

Uthev ikke-samsvarende lenker slår avviksuthevingen på eller av.
Annoter kun ikke-samsvarende lenker lar ærlige lenker forbli helt urørt, slik at bare de mistenkelige avsløres.

Verktøylinjeknappen

I Chrome, Edge, Opera, Firefox og Thunderbird er Reveal URLs-ikonet på verktøylinjen en rask av/på-bryter — klikk på det for å slå annotering av eller på. Når utvidelsen er slått av, vises et OFF-merke på ikonet, og verktøytipset forteller deg om et klikk vil slå den på eller av. I nettleserne trer endringen i kraft i alle åpne faner samtidig; i Thunderbird gjelder den for neste melding du åpner.

(I Thunderbird viser knappen bare ikonet sitt, så den holder seg kompakt i den samlede verktøylinjen. Du kan også slå Reveal URLs av og på med bryteren Aktiver på innstillingssiden.)

Innstillingssiden

Innstillingssiden inneholder hvert alternativ. Åpne den fra nettleserens utvidelsesside (for eksempel Detaljer → Utvidelsesalternativer), eller den åpnes automatisk ved første installasjon.

Aktiver Reveal URLs — hovedbryteren på/av, helt øverst på siden. Den trer i kraft umiddelbart, uten at resten av skjemaet trenger å bli lagret.
Visningsspråk — velg språket innstillingssiden vises på. Som standard følger den nettleserens språk, med engelsk som reserve; velg et annet fra listen for å overstyre det. Valget ditt trer i kraft med en gang, huskes til neste gang, og lagres kun på denne enheten (det endrer aldri resten av innstillingene dine).
Avslør URL-en — velg modus inline eller verktøytips (tittel) (se ovenfor).
Uthev ikke-samsvarende lenker — slå avviksuthevingen på eller av.
Avviksfarge — CSS-fargen som brukes for en merket lenke (for eksempel red, #cc0000 eller rgb(200, 0, 0)). Standarden er rød.
Samsvarsfarge — fargen på den avslørte URL-en på ærlige (ikke-avvik) lenker (for eksempel black eller #1a1a1a). Standarden er en nøytral, svært mørk grå (#1a1a1a), valgt slik at fargen ikke antyder at lenken er kontrollert.
Annoter kun ikke-samsvarende lenker — la ærlige lenker forbli urørt.
Ignorer disse vertene — en liste over vertsnavn som skal hoppes over helt, ett per linje. Underdomener av en oppført vert hoppes også over.
Maksimal vist URL-lengde — lange URL-er kortes ned forbi dette antall tegn, slik at verten forblir synlig. Tillatt område: 20 til 2000.
Skriftstørrelse / -tykkelse for avslørt URL og Skriftstørrelse / -tykkelse for advarselsmerket — valgfrie typografioverstyringer; la stå tomt for å beholde standardverdiene.

Bortsett fra hovedbryteren Aktiver og kontrollene for Aktive nettsteder (som tas i bruk med en gang), lagres endringer med knappen Lagre innstillinger.

Aktive nettsteder — legge til din egen webmail

Seksjonen Aktive nettsteder, øverst på innstillingssiden, lister opp sidene Reveal URLs kjører på og beholderen som inneholder hver meldingstekst.

Hver rad viser:

nettstedets samsvarsmønster (for eksempel https://mail.example.com/*);
en Aktivert-bryter;
meldingstekst-velgeren (CSS-velgeren for beholderen Reveal URLs annoterer), som du kan redigere;
en Underrammer-bryter, for nettsteder hvis meldingstekst gjengis inne i en iframe;
en Fjern-knapp (kun for dine egne nettsteder).

De innebygde leverandørene (Gmail, Outlook og Proton) kan slås av og rettes på nytt, men de kan ikke fjernes.

For å legge til ditt eget webmail-nettsted:

Under Legg til nettsted, skriv inn en Samsvars-URL — et samsvarsmønster som https://mail.example.com/*.
Skriv inn en Meldingstekst-velger — en CSS-velger for beholderen som inneholder meldingsteksten, for eksempel .message-body.
Hvis meldingsteksten gjengis inne i en underramme, kryss av for Kjør også inne i underrammer.
Klikk på Legg til nettsted. Nettleseren din vil be om tillatelse til å få tilgang til det nettstedet; gi den. Nettstedet legges først til når du gir tillatelsen.

Endringer her tas i bruk med en gang. Å fjerne et nettsted du har lagt til tilbakekaller også tillatelsen til det, slik at Reveal URLs slutter å få tilgang til det.

Thunderbird (og andre e-postklienter). Thunderbird viser allerede hver melding du leser, uansett leverandør, så det har ikke behov for en liste per vert. Seksjonen Aktive nettsteder vises derfor ikke på Thunderbird-innstillingssiden — bare hovedbryteren, visningsspråk, avsløringsmodus, farger, skrifter og ignoreringslisten vises. Eventuell aktive-nettsteder-konfigurasjon du måtte ha satt i en nettleser bevares urørt: lagring av Thunderbird-innstillingene tømmer den aldri.

Outlook- og Gmail-tilleggene

Ved siden av nettleserutvidelsen og Thunderbird-tillegget kommer Reveal URLs som et nativt tillegg for to e-postapper en nettleserutvidelse ikke kan nå: et Outlook-tillegg og et Gmail-tillegg. Begge bruker den samme lenkedeteksjonen som utvidelsen, så de avslører de samme URL-ene og merker de samme etterlignende vertene.

Den ene forskjellen er hvordan de viser funnene sine. Nettleserutvidelsen annoterer lenkene på stedet — den fargelegger URL-en over eller ved siden av hver lenke. Outlook- og Gmail-rammeverkene tillater ikke at et tillegg endrer den gjengitte meldingen, så i stedet viser hvert tillegg et sidepanel (Outlook) eller kort (Gmail) som lister opp lenkene det fant. For hver lenke viser det den synlige teksten, destinasjons-URL-en og den registrerbare verten, og det merker et avvik når den synlige teksten nevner et annet registrerbart domene enn lenken faktisk peker mot.

Outlook-tillegg — en oppgaverute som leser meldingen du har åpen og analyserer den på din egen enhet; ingen e-post- eller meldingsdata sendes noe sted. Oppgaverutens kode (HTML, JavaScript, CSS og ikoner) lastes fra https://www.reveal-urls.eu over HTTPS, som skjer når du åpner en hvilken som helst nettside. Det når Outlook på nettet, Windows, Mac, iOS og Android, og Outlook.com.
Gmail-tillegg — et kort i Gmails sidefelt. Åpne en melding, og klikk deretter på Reveal URLs-ikonet i sidefeltet til høyre for å se lenkene dens: Gmail åpner ikke kortet av seg selv, men hvis du lar panelet stå åpent oppdateres det når du beveger deg mellom meldinger. Hver lenkes URL vises i en nøytral mørk grå for en ærlig lenke og rødt for en etterligning. Det når Gmail på nettet, Android og iOS. I motsetning til de andre formene kjører Gmail-tillegget på Googles servere (slik fungerer Gmail-tillegg): meldingen du åpner leses og kontrolleres der, hver gang du åpner den, og beholdes ikke. Se personvernerklæringen for hva hver form har tilgang til og lagrer.

Begge tilleggene vil bli distribuert gjennom appbutikkene sine — Outlook-tillegget via Microsoft AppSource, Gmail-tillegget via Google Workspace Marketplace. Publisering er ventende; direkte installasjonslenker vil bli lagt til her når hver oppføring er aktiv.

Språk

Reveal URLs er tilgjengelig på engelsk og mange andre språk.

Innstillingssiden følger nettleserens språk automatisk, og faller tilbake til engelsk når språket ditt ikke er ett av de ovennevnte. Du kan overstyre det når som helst med Visningsspråk-velgeren nær toppen av siden; valget ditt huskes på den enheten (se Innstillingssiden).
Dette nettstedet (hjemmesiden og disse dokumentasjonssidene) oppdager nettleserens språk også og tilbyr en språkvelger i toppfeltet. Håndboken og personvernsidene er tilgjengelige oversatt; der en side ennå ikke har en oversettelse, vises den på engelsk.

Den ikke-engelske teksten er maskinoversatt og venter på menneskelig gjennomgang, så en frase kan av og til lese seg klønete; meningen er ment å samsvare med det engelske originalen. Hvis du oppdager en feiloversettelse, vennligst åpne en sak på Codeberg-feilsporeren.

Personvern

Reveal URLs sender ingen av e-post- eller meldingsdataene dine til oss eller til noen tredjepart, i noen av formene sine — det finnes ingen analyse og ingen sporing. Hvordan og hvor arbeidet skjer avhenger av formen:

Nettleserutvidelsen og Thunderbird-tillegget fungerer helt på din egen enhet og overfører ingenting: de leser lenketeksten, URL-ene og sidens farger mens siden gjengis, og lagrer eller sender dem aldri.
Outlook-tillegget analyserer den åpne meldingen på din egen enhet og sender ingen e-post- eller meldingsdata noe sted; oppgaverutens kode (HTML, JavaScript, CSS og ikoner) lastes fra https://www.reveal-urls.eu over HTTPS, som skjer når du åpner en hvilken som helst nettside.
Gmail-tillegget kjører på Googles egne servere (slik fungerer Gmail-tillegg): den åpne meldingen leses og kontrolleres der, hver gang du åpner den, og beholdes ikke.

Det eneste som lagres er dine egne innstillinger (som aktivert/deaktivert, avsløringsmodus, farger, skriftstørrelser, ignoreringslisten din og eventuelle nettsteder du har lagt til), oppbevart i nettleserens, Outlooks eller Googles per-bruker-lagring og aldri sendt til oss.

Se personvernerklæringen for alle detaljer.

Feilsøking

En lenke blir ikke avslørt.

Kontroller at Reveal URLs er slått på — verktøylinjeikonet må ikke vise OFF-merket, og bryteren Aktiver Reveal URLs på innstillingssiden må stå på.
Kontroller at nettstedet er dekket. Innebygde leverandører (Gmail, Outlook, Proton) fungerer rett ut av boksen; enhver annen webmail må legges til under Aktive nettsteder med sin samsvars-URL og meldingstekst-velger.
Kontroller meldingstekst-velgeren. Hvis den ikke stemmer overens med beholderen som inneholder meldingsteksten, blir lenker inne i den beholderen ikke avslørt.
Merk at lenker til interne ankere, og lenker som bruker andre skjemaer enn http/https (som mailto:), med vilje hoppes over — det samme gjelder verter på listen Ignorer disse vertene.

En innebygd leverandør sluttet å fungere etter en omdesign.

Webmail-leverandører endrer sidemarkeringen sin fra tid til annen. Hvis velgeren til en innebygd leverandør ikke lenger stemmer overens etter en slik endring, kan du korrigere det selv: i Aktive nettsteder, rediger den leverandørens meldingstekst-velger til den nye beholderen.

Verktøytips-URL-en vises ikke.

I modusen verktøytips (tittel) plasseres den virkelige URL-en i lenkens verktøytips, slik at den bare vises når du holder musepekeren over lenken. Hvis du heller vil se URL-en uten å holde over, bytt Avslør URL-en til inline-modus.

Lisens og kildekode

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

Kildekode: https://codeberg.org/Magentron/reveal-urls
Teknisk oversikt: Arkitektur
Videre lesning om lenke-phishing: Email link phishing: your app should always show the URL