Reveal URLs — Korisnički priručnik
Reveal URLs je malo proširenje za preglednik i dodatak za Thunderbird koje vam pokazuje kamo poveznica u vašoj e-pošti zaista vodi, tako da možete prepoznati phishing poveznicu prije nego što kliknete na nju.
Ovaj priručnik objašnjava kako instalirati Reveal URLs i kako ga koristiti. Za način na koji se obrađuju vaši podaci pogledajte pravila privatnosti. Za tehnički pregled načina na koji je proširenje izgrađeno pogledajte pregled arhitekture.
Jeste li pronašli bug, poveznicu koja je pogrešno označena ili host webmaila koji bi trebao biti podržan? Prijavite to na Codeberg issue tracker.
Sadržaj
- Što radi i zašto
- Podržani preglednici i klijent e-pošte
- Instalacija
- Korištenje
- Dodaci za Outlook i Gmail
- Jezici
- Privatnost
- Rješavanje problema
- Licenca i izvorni kod
Što radi i zašto
Phishing poruka skriva zlonamjerno odredište iza teksta poveznice koji
izgleda vjerodostojno. Ponekad je riječ o hostu koji samo nalikuje
pravome: tekst prikazuje paypal.com, dok poveznica zapravo vodi na
paypa1.com. Često je trik suptilniji i prolazi kroz tracker ili
redirector, pa mjesto na koje završite nema mnogo veze s brendom koji je
naveden u tekstu.

parcel-pay.custom.co.xa, a ne na Hrvatsku poštu.Napomena: Ova snimka zaslona prikazuje lažni phishing e-mail koji se predstavlja kao Hrvatska pošta. Hrvatska pošta nije povezana s Reveal URLs i ne podržava ga.
Reveal URLs čita svaku poveznicu u poruci koju upravo gledate i prikazuje vam URL na koji ona vodi. Kad se host naveden u tekstu poveznice ne podudara s hostom na koji poveznica stvarno pokazuje, Reveal URLs to označi, tako da je nepodudaranje očito prije nego što kliknete.
U proširenju za preglednik i dodatku za Thunderbird sve se odvija na vašem uređaju i ništa se ne prenosi. U svim svojim oblicima Reveal URLs ne šalje nikakve podatke iz vaše e-pošte nama ni trećim stranama: nema analitike ni praćenja. Oblici se razlikuju samo po tome gdje se izvršavaju i kako se poslužuje kôd Outlook okna. Za potpune pojedinosti pogledajte odjeljak Privatnost i pravila privatnosti.
Podržani preglednici i klijent e-pošte
Reveal URLs radi na:
- Google Chrome
- Microsoft Edge
- Opera
- Mozilla Firefox
- Mozilla Thunderbird (desktop klijent e-pošte)
Safari izdanje još nije objavljeno. Planirano je za kasniju fazu.
U preglednicima Reveal URLs označava poveznice u vašem webmailu. U Thunderbirdu označava poveznice izravno u poruci e-pošte koju čitate unutar samog klijenta.
Instalacija
Iz trgovine vašeg preglednika ili klijenta e-pošte (preporučeno)
Instalirajte Reveal URLs iz trgovine za svoj preglednik ili klijent e-pošte. Objave za Chrome, Edge, Firefox i Thunderbird već su dostupne. Opera koristi Chrome build, a posebna Opera objava još je u pripremi:
- Chrome — the Chrome Web Store
- Edge — Microsoft Edge Add-ons
- Opera — instalirajte Chrome izdanje iz the Chrome Web Store. Posebna Opera objava stiže uskoro
- Firefox — Firefox Add-ons (AMO)
- Thunderbird — Thunderbird Add-ons (ATN)
Ručno učitavanje builda (razvoj i rana testiranja)
Ako ste izgradili Reveal URLs iz izvornog koda, možete izravno učitati
raspakirani build. Svaki se cilj gradi naredbom make i stvara pod
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
Zatim učitajte dobivenu mapu:
- Chrome — otvorite
chrome://extensions, uključite Developer mode, kliknite Load unpacked i odaberitedist/chrome. - Edge — otvorite
edge://extensions, uključite Developer mode, kliknite Load unpacked i odaberitedist/edge. - Opera — otvorite
opera://extensions, uključite Developer mode, kliknite Load unpacked i odaberitedist/opera. - Firefox — otvorite
about:debugging, odaberite This Firefox, kliknite Load Temporary Add-on i odaberite bilo koju datoteku unutardist/firefox, primjerice njegovmanifest.json. Privremeni dodatak uklanja se pri ponovnom pokretanju Firefoxa. - Thunderbird — instalirajte privremeni dodatak iz
dist/thunderbirdna isti način preko Tools → Developer Tools → Debug Add-ons → Load Temporary Add-on.
Stranica postavki automatski se otvara pri prvoj instalaciji proširenja.
Korištenje
Odmah nakon instalacije Reveal URLs označava poveznice u porukama na ugrađenim pružateljima, bez ikakvog dodatnog podešavanja:
- Gmail (
mail.google.com) - Outlook Live (
outlook.live.com) - Outlook on the web / Microsoft 365 (
outlook.office.com) - Proton Mail (
mail.proton.me)
Označavanje je ograničeno na tijelo poruke, tako da vlastito sučelje aplikacije, poput bočne trake, prozora za pisanje i alatnih traka, ostaje netaknuto. U Thunderbirdu je obuhvaćen cijeli prikazani email.
Dva načina otkrivanja
Na stranici postavki, pod Reveal the URL, birate kako će se prikazivati stvarni URL:
- Inline — stvarni URL prikazuje se u vlastitom retku, odmah iznad teksta poveznice. To je zadana postavka.
- In the link's tooltip (title) — stvarni URL smješta se u tooltip poveznice, pa se prikazuje kada zadržite pokazivač iznad nje.
Isticanje nepodudaranja
Kada se host naveden u vidljivom tekstu poveznice ne podudara s hostom na
koji poveznica doista vodi, Reveal URLs to označi kao nepodudaranje.
Usporedba se radi na registrable domeni, pa poštena poddomena kao
mail.example.com za example.com neće biti označena, dok će look-alike
host poput paypa1.com za paypal.com biti označen.
- U načinu inline nepodudaranje se prikazuje vašom odabranom bojom za nepodudaranje i podebljanim tekstom.
- U načinu tooltip (title) uz poveznicu se dodaje uočljiva oznaka ⚠ URL mismatch.
Dvije povezane postavke upravljaju tim ponašanjem:
- Highlight mismatching links uključuje ili isključuje isticanje nepodudaranja.
- Only annotate mismatching links ostavlja poštene poveznice potpuno netaknutima, tako da se otkrivaju samo sumnjive.
Gumb alatne trake
U Chromeu, Edgeu, Operi, Firefoxu i Thunderbirdu ikona Reveal URLs na alatnoj traci brzi je prekidač za uključivanje i isključivanje — kliknite je da biste prebacili anotaciju. Kada je proširenje isključeno, na ikoni se pojavljuje oznaka OFF, a njezin vam opis govori hoće li je klik uključiti ili isključiti. U preglednicima promjena stupa na snagu u svim otvorenim karticama odjednom; u Thunderbirdu se primjenjuje na sljedeću poruku koju otvorite.
(U Thunderbirdu gumb prikazuje samo svoju ikonu, pa ostaje kompaktan u objedinjenoj alatnoj traci. Reveal URLs možete uključivati i isključivati i prekidačem Enable na stranici postavki.)
Stranica postavki
Stranica postavki sadrži sve opcije. Otvorite je sa stranice proširenja svog preglednika, primjerice kroz Details → Extension options, ili će se sama otvoriti pri prvoj instalaciji.
- Enable Reveal URLs — glavni prekidač za uključivanje i isključivanje na samom vrhu stranice. Stupa na snagu odmah, bez spremanja ostatka obrasca.
- Display language — odaberite jezik na kojem će se prikazivati stranica postavki. Zadano prati jezik vašeg preglednika i vraća se na engleski kada vaš jezik nije podržan. Možete ga nadjačati odabirom drugog jezika s popisa. Vaš izbor počinje vrijediti odmah, pamti se za sljedeći put i pohranjuje se samo na ovom uređaju. Ne mijenja ostatak vaših postavki.
- Reveal the URL — odaberite način inline ili tooltip (title), kako je opisano iznad.
- Highlight mismatching links — uključite ili isključite isticanje nepodudaranja.
- Mismatch colour — CSS boja koja se koristi za označenu poveznicu,
primjerice
red,#cc0000ilirgb(200, 0, 0). Zadana boja je crvena. - Match colour — boja prikazanog URL-a na poštenim poveznicama bez
nepodudaranja, primjerice
blackili#1a1a1a. Zadana vrijednost je neutralna vrlo tamnosiva (#1a1a1a), odabrana tako da boja ne sugerira da je poveznica provjerena. - Only annotate mismatching links — ostavite poštene poveznice netaknute.
- Ignore these hosts — popis hostnames koje treba potpuno preskočiti, jedan po retku. Preskaču se i poddomene navedenog hosta.
- Maximum displayed URL length — dugi URL-ovi skraćuju se nakon ovog
broja znakova, uz zadržavanje vidljivog hosta. Dopušteni raspon: 20 do
- Revealed URL font size / weight i Warning badge font size / weight — neobavezna nadjačavanja tipografije. Ostavite prazno ako želite zadržati zadane vrijednosti.
Osim glavnog prekidača Enable i kontrola Active sites, koje se primjenjuju odmah, promjene se spremaju gumbom Save settings.
Aktivna mjesta — dodavanje vlastitog webmaila
Odjeljak Active sites pri vrhu stranice postavki navodi stranice na kojima Reveal URLs radi i container koji sadrži tijelo svake poruke.
Svaki redak prikazuje:
- match pattern stranice, primjerice
https://mail.example.com/* - preklopnik Enabled
- message-body selector, odnosno CSS selector za container koji Reveal URLs označava, a koji možete uređivati
- preklopnik Sub-frames, za stranice čije se tijelo poruke prikazuje unutar iframe
- gumb Remove, samo za stranice koje ste sami dodali
Ugrađeni pružatelji, kao što su Gmail, Outlook i Proton, mogu se isključiti ili preusmjeriti na novi cilj, ali ih nije moguće ukloniti.
Za dodavanje vlastite webmail stranice:
- Pod Add site unesite Match URL — match pattern poput
https://mail.example.com/*. - Unesite Message-body selector — CSS selector za container koji sadrži
tijelo poruke, primjerice
.message-body. - Ako se tijelo poruke prikazuje unutar podokvira, označite Also run inside sub-frames.
- Kliknite Add site. Vaš će preglednik zatražiti dopuštenje za pristup toj stranici. Odobrite ga. Stranica se dodaje tek kada dopuštenje odobrite.
Promjene se ovdje primjenjuju odmah. Uklanjanje stranice koju ste dodali također opoziva njezino dopuštenje, pa joj Reveal URLs više ne pristupa.
Thunderbird (i drugi klijenti e-pošte). Thunderbird već prikazuje svaku poruku koju čitate, bez obzira na pružatelja, pa mu popis po hostovima nije potreban. Zbog toga se odjeljak Active sites ne prikazuje na stranici postavki u Thunderbirdu. Ondje se prikazuju samo glavni prekidač, jezik prikaza, način otkrivanja, boje, fontovi i popis zanemarivanja. Svaka konfiguracija aktivnih mjesta koju ste možda postavili u pregledniku ostaje netaknuta. Spremanje postavki u Thunderbirdu nikada je ne briše.
Dodaci za Outlook i Gmail
Uz proširenje za preglednik i dodatak za Thunderbird, Reveal URLs dolazi i kao izvorni dodatak za dvije aplikacije za e-poštu do kojih proširenje preglednika ne može doprijeti: Outlook add-in i Gmail add-on. Oba koriste istu detekciju poveznica kao i proširenje, pa otkrivaju iste URL-ove i označavaju iste look-alike hostove.
Jedina je razlika u tome kako prikazuju svoje nalaze. Proširenje za preglednik označava poveznice na samom mjestu, bojeći URL iznad ili pokraj svake poveznice. Outlook i Gmail okviri ne dopuštaju dodatku da mijenja prikazanu poruku, pa svaki dodatak umjesto toga prikazuje bočnu ploču (Outlook) ili karticu (Gmail) s pronađenim poveznicama. Za svaku poveznicu prikazuju se vidljivi tekst, odredišni URL i registrable host, a nepodudaranje se označava kada vidljivi tekst imenuje drugu registrable domenu od one na koju poveznica stvarno pokazuje.
- Outlook add-in — task pane koji čita otvorenu poruku i analizira je na vašem uređaju. Nikakvi podaci o emailu ili poruci ne šalju se nikamo. Kôd task panea, odnosno HTML, JavaScript, CSS i ikone, učitava se s https://www.reveal-urls.eu preko HTTPS-a, kao kada otvorite bilo koju web stranicu. Pokriva Outlook on the web, Windows, Mac, iOS, Android i Outlook.com.
- Gmail add-on — kartica u Gmail bočnoj traci. Otvorite poruku, zatim kliknite ikonu Reveal URLs u desnoj bočnoj traci kako biste vidjeli njezine poveznice. Gmail ne otvara karticu sam od sebe, ali ako ploču ostavite otvorenom, ona se osvježava dok prelazite s poruke na poruku. URL svake poveznice prikazuje se neutralnom tamnosivom bojom za poštenu poveznicu i crvenom za look-alike. Pokriva Gmail na webu, Androidu i iOS-u. Za razliku od drugih oblika, Gmail add-on radi na Googleovim poslužiteljima, tako Gmail dodaci funkcioniraju. Poruka koju otvorite tamo se čita i provjerava svaki put kada je otvorite i ne zadržava se. U pravilima privatnosti pogledajte čemu svaki oblik pristupa i što pohranjuje.
Oba dodatka distribuirat će se kroz svoje trgovine aplikacija: Outlook add-in preko Microsoft AppSource, a Gmail add-on preko Google Workspace Marketplace. Objavljivanje je još u tijeku. Izravne poveznice za instalaciju bit će dodane ovdje čim svaka objava bude aktivna.
Jezici
Reveal URLs dostupan je na engleskom i mnogim drugim jezicima.
- Stranica postavki automatski prati jezik vašeg preglednika i vraća se na engleski kada vaš jezik nije podržan. U bilo kojem trenutku to možete nadjačati biračem Display language pri vrhu stranice. Vaš se odabir pamti na tom uređaju. Pogledajte Stranica postavki.
- Ova web stranica, odnosno početna stranica i ove dokumentacijske stranice, također prepoznaje jezik vašeg preglednika i nudi birač jezika u zaglavlju. Priručnik i stranice privatnosti dostupni su prevedeni. Gdje za neku stranicu prijevod još ne postoji, prikazuje se engleska verzija.
Neengleski tekst je strojno preveden i čeka ljudski pregled, pa neka formulacija povremeno može zvučati nespretno. Namjera je da značenje bude isto kao u engleskom izvorniku. Ako primijetite pogrešan prijevod, otvorite issue na Codeberg issue tracker.
Privatnost
Reveal URLs ne šalje nikakve podatke iz vaše e-pošte ili poruke nama ni trećim stranama, ni u jednom svom obliku. Nema analitike ni praćenja. Gdje i kako se obrada odvija ovisi o obliku:
- Proširenje za preglednik i dodatak za Thunderbird rade u cijelosti na vašem uređaju i ništa ne prenose. Čitaju tekst poveznica, URL-ove i boje stranice dok se stranica prikazuje, bez pohranjivanja ili slanja tih podataka.
- Outlook add-in analizira otvorenu poruku na vašem uređaju i ne šalje nikakve podatke o emailu ili poruci. Njegov task-pane kôd, odnosno HTML, JavaScript, CSS i ikone, učitava se s https://www.reveal-urls.eu preko HTTPS-a, kao i svaka druga web stranica.
- Gmail add-on radi na Googleovim poslužiteljima, tako Gmail dodaci funkcioniraju. Otvorena poruka ondje se čita i provjerava svaki put kada je otvorite i ne zadržava se.
Jedino što se pohranjuje jesu vaše vlastite postavke, poput toga je li Reveal URLs uključen ili isključen, načina otkrivanja, boja, veličina fonta, vašeg popisa zanemarivanja i svih stranica koje ste dodali. One se čuvaju u per-user pohrani vašeg preglednika, Outlooka ili Googlea i nikada se ne šalju nama.
Za potpune pojedinosti pogledajte pravila privatnosti.
Rješavanje problema
Poveznica se ne otkriva.
- Provjerite je li Reveal URLs uključen. Ikona alatne trake ne smije prikazivati oznaku OFF, a prekidač Enable Reveal URLs na stranici postavki mora biti uključen.
- Provjerite je li stranica obuhvaćena. Ugrađeni pružatelji, Gmail, Outlook i Proton, rade odmah. Svaki drugi webmail treba dodati pod Active sites s njegovim match URL-om i message-body selectorom.
- Provjerite message-body selector. Ako se ne podudara s containerom koji sadrži tijelo poruke, poveznice u tom containeru neće biti otkrivene.
- Imajte na umu da se poveznice na sidra unutar iste stranice, kao i
poveznice koje koriste scheme različite od
http/https, poputmailto:, namjerno preskaču. Isto vrijedi i za hostove na vašem popisu Ignore these hosts.
Ugrađeni pružatelj prestao je raditi nakon redizajna.
Pružatelji webmaila povremeno mijenjaju markup svojih stranica. Ako selector ugrađenog pružatelja nakon takve promjene više ne odgovara, možete ga sami ispraviti: u Active sites uredite message-body selector tog pružatelja tako da odgovara novom containeru.
Tooltip URL se ne prikazuje.
U načinu tooltip (title) stvarni URL stavlja se u tooltip poveznice, pa se pojavljuje tek kada zadržite pokazivač iznad nje. Ako URL radije želite vidjeti bez hovera, prebacite Reveal the URL na inline način rada.
Licenca i izvorni kod
Reveal URLs je slobodan softver pod licencom GNU Affero General Public License v3.0 (AGPL-3.0-only).
- Izvorni kod: https://codeberg.org/Magentron/reveal-urls
- Tehnički pregled: Architecture
- Više o phishingu poveznica: Email link phishing: your app should always show the URL




