Reveal URLs — Korisnički priručnik
Reveal URLs je malo proširenje za preglednik i dodatak za Thunderbird koji vam pokazuje kamo link u vašoj e-pošti stvarno vodi, tako da phishing link možete prepoznati prije nego što kliknete.
Ovaj priručnik objašnjava kako instalirati Reveal URLs i kako ga koristiti. Za način obrade vaših podataka pogledajte politiku privatnosti. Za tehnički pregled načina na koji je proširenje sastavljeno pogledajte pregled arhitekture.
Ako ste pronašli grešku, pogrešno označen link ili webmail host koji bi trebao biti podržan, prijavite to na Codeberg issue tracker.
Sadržaj
- Šta radi i zašto
- Podržani preglednici i klijent e-pošte
- Instalacija
- Korištenje
- Outlook i Gmail dodaci
- Jezici
- Privatnost
- Rješavanje problema
- Licenca i izvorni kod
Šta radi i zašto
Phishing poruka skriva neprijateljsko odredište iza teksta linka koji
izgleda pouzdano. Nekad je to host koji samo liči na pravi: tekst kaže
paypal.com, a link zapravo vodi na paypa1.com. Često je trik suptilniji
i vodi kroz tracker ili redirector, pa mjesto na koje stignete nema gotovo
nikakve veze s brendom spomenutim u tekstu.

parcel-pay.custom.co.xa, a ne na BH Poštu.Napomena: Ovaj snimak zaslona prikazuje lažni phishing e-mail koji se predstavlja kao BH Pošta. BH Pošta nije povezana s Reveal URLs i ne podržava ga.
Reveal URLs pročita svaki link u poruci koju gledate i pokaže URL na koji on vodi. Kada se host naveden u tekstu linka ne podudara s hostom na koji link zaista vodi, Reveal URLs to označi, tako da je nepodudaranje jasno vidljivo prije klika.
U pregledničkom proširenju i dodatku za Thunderbird sve se odvija na vašem vlastitom uređaju i ništa se ne šalje dalje. Nijedan oblik Reveal URLs ne šalje vaše podatke iz e-pošte nama niti trećim stranama: nema analytics i nema tracking. Različiti oblici razlikuju se samo po tome gdje se izvršavaju i kako se isporučuje kod za Outlook panel. Više detalja nalazi se u odjeljku Privatnost i u politici privatnosti.
Podržani preglednici i klijent e-pošte
Reveal URLs radi u sljedećem:
- Google Chrome
- Microsoft Edge
- Opera
- Mozilla Firefox
- Mozilla Thunderbird (desktop klijent e-pošte)
Safari verzija još nije objavljena. Planirana je za kasniju fazu.
U preglednicima Reveal URLs označava linkove u vašem webmailu. U Thunderbirdu označava linkove direktno u poruci e-pošte koju čitate u samom klijentu.
Instalacija
Iz trgovine vašeg preglednika ili klijenta e-pošte (preporučeno)
Instalirajte Reveal URLs iz trgovine za vaš preglednik ili klijent e-pošte. Objave za Chrome, Edge, Firefox i Thunderbird već su dostupne. Opera koristi Chrome build, a zaseban Opera listing još je u pripremi:
- Chrome — the Chrome Web Store
- Edge — Microsoft Edge Add-ons
- Opera — instalirajte Chrome verziju iz the Chrome Web Store. Zaseban Opera listing stiže uskoro
- Firefox — Firefox Add-ons (AMO)
- Thunderbird — Thunderbird Add-ons (ATN)
Ručno učitavanje builda (razvoj i rano testiranje)
Ako ste Reveal URLs izgradili iz izvornog koda, možete direktno učitati
raspakirani build. Svaki target se gradi komandom make i nastaje u
direktoriju 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 odgovarajući direktorij:
- Chrome — otvorite
chrome://extensions, uključite Developer mode, kliknite Load unpacked i izaberitedist/chrome. - Edge — otvorite
edge://extensions, uključite Developer mode, kliknite Load unpacked i izaberitedist/edge. - Opera — otvorite
opera://extensions, uključite Developer mode, kliknite Load unpacked i izaberitedist/opera. - Firefox — otvorite
about:debugging, izaberite This Firefox, kliknite Load Temporary Add-on i izaberite bilo koju datoteku unutar direktorijadist/firefox, na primjermanifest.json. Privremeni dodatak uklanja se kada se Firefox ponovo pokrene. - 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 linkove u porukama ugrađenih servisa bez 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, pa vlastiti chrome aplikacije, kao što su bočna traka, prozor za pisanje i alatne trake, ostaje netaknut. U Thunderbirdu je obuhvaćena cijela rendered email poruka.
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 redu, odmah iznad teksta linka. Ovo je zadana opcija.
- In the link's tooltip (title) — stvarni URL upisuje se u tooltip linka, pa ga vidite kada zadržite pokazivač iznad linka.
Isticanje nepodudaranja
Kada se host naveden u vidljivom tekstu linka ne slaže s hostom na koji link
zaista vodi, Reveal URLs to označi kao nepodudaranje. Poređenje se radi na
registrable domeni, pa pošteni sub-domain kao mail.example.com za
example.com nije označen, dok look-alike host kao paypa1.com za
paypal.com jeste.
- U inline režimu nepodudaranje se prikazuje bojom koju odaberete za mismatch i podebljanim tekstom.
- U režimu tooltip (title) uz link se dodaje jasna oznaka ⚠ URL mismatch.
To kontrolišu dvije povezane postavke:
- Highlight mismatching links uključuje ili isključuje isticanje nepodudaranja.
- Only annotate mismatching links ostavlja poštene linkove potpuno netaknutim, tako da se otkrivaju samo sumnjivi.
Dugme alatne trake
U Chromeu, Edgeu, Operi, Firefoxu i Thunderbirdu ikona Reveal URLs na alatnoj traci je brzi prekidač za uključivanje i isključivanje — kliknite je da uključite ili isključite anotaciju. Kada je ekstenzija isključena, na ikoni se pojavljuje oznaka OFF, a njen opis vam 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 dugme prikazuje samo svoju ikonu, pa ostaje kompaktno u objedinjenoj alatnoj traci. Reveal URLs možete uključivati i isključivati i prekidačem Enable na stranici postavki.)
Stranica postavki
Na stranici postavki nalaze se sve opcije. Otvorite je sa stranice proširenja u vašem pregledniku, na primjer preko 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. Djeluje odmah, bez potrebe da sačuvate ostatak forme.
- Display language — izaberite jezik u kojem će biti prikazana stranica postavki. Podrazumijevano prati jezik vašeg preglednika i vraća se na engleski ako vaš jezik nije podržan. To možete promijeniti izborom drugog jezika s liste. Vaš izbor djeluje odmah, pamti se i čuva samo na ovom uređaju.
- Reveal the URL — izaberite inline ili tooltip (title) režim, kao što je opisano iznad.
- Highlight mismatching links — uključite ili isključite isticanje nepodudaranja.
- Mismatch colour — CSS boja za označeni link, na primjer
red,#cc0000ilirgb(200, 0, 0). Zadana vrijednost je crvena. - Match colour — boja otkrivenog URL-a za poštene linkove bez
nepodudaranja, na primjer
blackili#1a1a1a. Podrazumijevano je to neutralna vrlo tamnosiva (#1a1a1a). - Only annotate mismatching links — ostavite poštene linkove netaknutim.
- Ignore these hosts — lista hostname-ova koje treba potpuno preskočiti, po jedan u svakom redu. Preskaču se i sub-domaini navedenog hosta.
- Maximum displayed URL length — dugi URL-ovi skraćuju se nakon ovog
broja znakova, pri čemu host ostaje vidljiv. Dozvoljeni raspon je od 20 do
- Revealed URL font size / weight i Warning badge font size / weight — opcionalne tipografske izmjene. Ostavite prazno ako želite zadržati zadane vrijednosti.
Osim glavnog prekidača Enable i kontrola Active sites, koje se primjenjuju odmah, promjene se čuvaju dugmetom Save settings.
Aktivni sajtovi — 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 red prikazuje:
- match pattern sajta, na primjer
https://mail.example.com/* - prekidač Enabled
- message-body selector, odnosno CSS selector za container koji Reveal URLs označava i koji možete urediti
- prekidač Sub-frames, za sajtove čije se tijelo poruke prikazuje unutar iframe
- dugme Remove, samo za sajtove koje ste sami dodali
Ugrađeni servisi, kao što su Gmail, Outlook i Proton, mogu se isključiti ili preusmjeriti, ali se ne mogu ukloniti.
Da biste dodali vlastiti webmail sajt:
- U odjeljku Add site unesite Match URL — match pattern kao što je
https://mail.example.com/*. - Unesite Message-body selector — CSS selector za container koji sadrži
tijelo poruke, na primjer
.message-body. - Ako se tijelo poruke prikazuje unutar podokvira, označite Also run inside sub-frames.
- Kliknite Add site. Vaš preglednik tražit će dozvolu za pristup tom sajtu. Dodijelite je. Sajt se dodaje tek kada je dozvola potvrđena.
Promjene ovdje djeluju odmah. Uklanjanje sajta koji ste dodali također opoziva njegovu dozvolu, pa Reveal URLs prestaje pristupati tom sajtu.
Thunderbird (i drugi klijenti e-pošte). Thunderbird već prikazuje svaku poruku koju čitate, bez obzira na provajdera, pa mu ne treba lista po hostu. Zato se odjeljak Active sites ne prikazuje na Thunderbird stranici postavki. Tamo su prikazani samo glavni prekidač, jezik prikaza, način otkrivanja, boje, fontovi i lista ignorisanja. Svaka konfiguracija aktivnih sajtova koju ste možda postavili u pregledniku ostaje netaknuta. Čuvanje postavki u Thunderbirdu nikada je ne briše.
Outlook i Gmail dodaci
Pored pregledničkog proširenja i dodatka za Thunderbird, Reveal URLs dostupan je i kao native dodatak za dvije aplikacije za poštu do kojih pregledničko proširenje ne može doći: Outlook add-in i Gmail add-on. Oba koriste istu detekciju linkova kao i proširenje, pa otkrivaju iste URL-ove i označavaju iste look-alike hostove.
Jedina razlika je u tome kako prikazuju nalaze. Pregledničko proširenje označava linkove na samom mjestu, bojeći URL iznad ili pored svakog linka. Outlook i Gmail okviri ne dozvoljavaju dodatku da mijenja prikazanu poruku, pa zato svaki dodatak umjesto toga prikazuje bočni panel (Outlook) ili karticu (Gmail) s listom pronađenih linkova. Za svaki link prikazani su vidljivi tekst, odredišni URL i registrable host, a nepodudaranje se označava kada vidljivi tekst navodi drugu registrable domenu od one na koju link zaista vodi.
- Outlook add-in — task pane koji čita poruku koju ste otvorili i analizira je na vašem uređaju. Nikakvi podaci iz e-pošte ili poruke ne šalju se nikuda. Kod task pane-a, odnosno HTML, JavaScript, CSS i ikone, učitava se sa https://www.reveal-urls.eu preko HTTPS, kao i kada otvorite bilo koju drugu 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, a zatim kliknite ikonu Reveal URLs u desnoj bočnoj traci da vidite njene linkove. Gmail ne otvara karticu sam, ali ako panel ostavite otvorenim, osvježit će se dok prelazite između poruka. URL svakog linka prikazuje se neutralnom tamnosivom bojom za pošteni link, a crveno za look-alike. Pokriva Gmail na webu, Androidu i iOS-u. Za razliku od drugih oblika, Gmail add-on radi na Google serverima, jer tako rade Gmail dodaci. Poruka koju otvorite tamo se pročita i provjeri svaki put kada je otvorite, i ne zadržava se. Pogledajte politiku privatnosti za detalje o tome čemu svaki oblik pristupa i šta pohranjuje.
Oba dodatka distribuirat će se preko svojih trgovina aplikacija: Outlook add-in preko Microsoft AppSource, a Gmail add-on preko Google Workspace Marketplace. Objavljivanje još traje. Direktni linkovi za instalaciju bit će dodani ovdje čim svaki listing postane aktivan.
Jezici
Reveal URLs dostupan je na engleskom i na mnogim drugim jezicima.
- Stranica postavki automatski prati jezik vašeg preglednika i vraća se na engleski ako vaš jezik nije podržan. To možete u bilo kojem trenutku promijeniti pomoću birača Display language pri vrhu stranice. Vaš izbor pamti se 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. Ako za neku stranicu još nema prevoda, prikazuje se engleska verzija.
Neengleski tekst je machine-translated i čeka ljudsku provjeru, pa neka formulacija ponekad može zvučati nespretno. Namjera je da značenje ostane isto kao u engleskom originalu. Ako primijetite pogrešan prevod, otvorite issue na Codeberg issue tracker.
Privatnost
Reveal URLs ni u jednom svom obliku ne šalje vaše podatke iz e-pošte ili poruka nama niti trećim stranama. Nema analytics i nema tracking. Gdje i kako se posao obavlja zavisi od oblika:
- Pregledničko proširenje i dodatak za Thunderbird rade potpuno na vašem uređaju i ništa ne šalju dalje. Oni čitaju tekst linka, URL-ove i boje stranice tokom renderiranja, bez pohrane ili slanja tih podataka.
- Outlook add-in analizira otvorenu poruku na vašem uređaju i ne šalje podatke iz e-pošte ili poruke nikuda. Njegov task pane kod, odnosno HTML, JavaScript, CSS i ikone, učitava se sa https://www.reveal-urls.eu preko HTTPS kao i kod svake druge web stranice.
- Gmail add-on radi na Google serverima, jer tako rade Gmail dodaci. Otvorena poruka tamo se pročita i provjeri svaki put kada je otvorite, i ne zadržava se.
Jedino što se pohranjuje jesu vaše vlastite postavke, kao što su uključeno ili isključeno stanje Reveal URLs, način otkrivanja, boje, veličine fonta, vaša lista ignorisanja i svi sajtovi koje ste dodali. One se čuvaju u per-user storage vašeg preglednika, Outlooka ili Googlea i nikada nam se ne šalju.
Više detalja potražite u politici privatnosti.
Rješavanje problema
Neki link se ne otkriva.
- Provjerite da li je Reveal URLs uključen. Ikona u alatnoj traci ne smije prikazivati oznaku OFF, a prekidač Enable Reveal URLs na stranici postavki mora biti uključen.
- Provjerite da li je sajt pokriven. Ugrađeni servisi Gmail, Outlook i Proton rade odmah. Svaki drugi webmail mora biti dodan u Active sites sa svojim match URL-om i message-body selector-om.
- Provjerite message-body selector. Ako se ne podudara s container-om koji sadrži tijelo poruke, linkovi unutar tog container-a neće biti otkriveni.
- Imajte na umu da se linkovi prema sidrima unutar stranice i linkovi koji
koriste scheme-ove različite od
http/https, kao što jemailto:, namjerno preskaču. Isto važi i za hostove sa vaše liste Ignore these hosts.
Ugrađeni servis je prestao raditi nakon redizajna.
Webmail servisi s vremena na vrijeme mijenjaju markup svojih stranica. Ako se selector ugrađenog servisa nakon takve promjene više ne podudara, možete ga sami ispraviti: u odjeljku Active sites uredite message-body selector tog servisa tako da pokazuje na novi container.
Tooltip URL se ne prikazuje.
U režimu tooltip (title) stvarni URL stavlja se u tooltip linka, pa je vidljiv samo kada zadržite pokazivač iznad linka. Ako želite vidjeti URL bez hovera, prebacite Reveal the URL na inline režim.
Licenca i izvorni kod
Reveal URLs je slobodan softver, licenciran pod 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 phishing linkovima: Email link phishing: your app should always show the URL




