Safari is supported through its macOS Xcode container and App Store route. Built-in providers use static scripts and Safari requests no all-sites access. A user-added site needs a runtime optional permission, then Safari injects content.js after navigation only for a granted, enabled, non-builtin rule; sub-frames run only when All frames is enabled. Safari settings are device-local and do not roam.

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 česta pitanja pogledajte FAQ; za način obrade vaših podataka pogledajte politiku privatnosti; za tehnički pregled 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 aplikacije 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.

Napomena: Ovaj snimak zaslona prikazuje lažni phishing e-mail koji se predstavlja kao poštanska usluga. Predstavljena usluga 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. U pregledničkom proširenju i Thunderbirdu označava obmanjujuće web, e-mail, telefonske i druge linkove, tako da je razlika jasno vidljiva prije klika.

Reveal URLs otkriva i označava; ne provjerava. Ne prati preusmjeravanja: link koji ide preko trackera ili preusmjerivača prikazuje se kao URL preusmjerivača koji zaista navodi; Reveal URLs ne može znati gdje to preusmjeravanje na kraju završi. Veza bez upozorenja nema otkrivenu primjenjivu neusklađenost, a nije potvrđena kao sigurna, pa pročitajte otkriveni URL prije nego što vjerujete vezi, čak i kada ništa nije označeno. Da biste to imali na umu, otkriveni URL na neoznačenoj vezi prikazuje se u jantarnoj boji „za provjeru“ umjesto u umirujuće zelenoj.

Napomena: adrese e-pošte, URL-ovi i imena na ovom snimku ekrana maskirani su zvjezdicama radi privatnosti.

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 aplikacije e-pošte

Reveal URLs radi u sljedećem:

Web preglednici:

• Brave
• Google Chrome
• Microsoft Edge
• Mozilla Firefox
• Opera
• Safari

Aplikacije za e-poštu:

• Gmail
• Outlook
• Mozilla Thunderbird (desktop klijent e-pošte)

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. Instalirajte Reveal URLs iz trgovine za svoj preglednik ili mail klijent. Sve objave su sada dostupne; Opera koristi Chrome build.

Web preglednici:

• Brave — instalirajte Chrome verziju iz Chrome Web Store
• Chrome — Chrome Web Store
• Edge — Microsoft Edge Add-ons
• Firefox — Firefox Add-ons (AMO)
• Opera — instalirajte Chrome verziju iz Chrome Web Store
• Safari — App Store

Aplikacije za e-poštu:

• Gmail — Google Workspace Marketplace
• Outlook — Microsoft Marketplace
• 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        # pravi dist/chrome
make build-edge          # pravi dist/edge
make build-firefox       # pravi dist/firefox
make build-gmail         # pravi dist/gmail
make build-opera         # pravi dist/opera
make build-outlook       # pravi dist/outlook
make build-safari        # pravi dist/safari
make build-thunderbird   # pravi dist/thunderbird

Zatim učitajte odgovarajući direktorij:

• Chrome — otvorite chrome://extensions, uključite Developer mode, kliknite Load unpacked i izaberite dist/chrome.
• Edge — otvorite edge://extensions, uključite Developer mode, kliknite Load unpacked i izaberite dist/edge.
• Firefox — otvorite about:debugging, izaberite This Firefox, kliknite Load Temporary Add-on i izaberite bilo koju datoteku unutar direktorija dist/firefox, na primjer manifest.json. Privremeni dodatak uklanja se kada se Firefox ponovo pokrene.
• Opera — otvorite opera://extensions, uključite Developer mode, kliknite Load unpacked i izaberite dist/opera.
• Thunderbird — instalirajte privremeni dodatak iz dist/thunderbird na isti način preko Tools → Developer Tools → Debug Add-ons → Load Temporary Add-on.

Safari ekstenzija, Outlook dodatak i Gmail dodatak ne učitavaju se kao raspakovana proširenja preglednika. Izgradite ih kao gore, zatim:

make deploy-gmail        # razmješta Gmail dodatak na Apps Script
make safari-xcode        # izgradi Safari Xcode projekt, zatim ga pokrenite
                         # iz Safari izbornika Develop (macOS)
                         # Outlook: bočno učitajte dist/outlook

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:

• FastMail (app.fastmail.com)
• Gmail (mail.google.com)
• Outlook Live (outlook.live.com)
• Outlook on the web / Microsoft 365 (outlook.office.com)
• Proton Mail (mail.proton.me)
• Tuta (app.tuta.com, mail.tutanota.com)
• Yahoo Mail (mail.yahoo.com)
• Zoho Mail (mail.zoho.com.au, mail.zoho.com.cn, mail.zoho.com, mail.zoho.eu, mail.zoho.in, mail.zoho.jp, mail.zoho.sa, mail.zohocloud.ca)

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.

Napomena: adrese e-pošte, URL-ovi i imena na ovom snimku ekrana maskirani su zvjezdicama radi privatnosti.

Kako se prikazuje stvarni URL

Stvarni URL svakog linka prikazuje se u vlastitom redu, odmah iznad teksta linka. Također se stavlja u tooltip (title) linka, tako da je puni URL uvijek tu kada zadržite pokazivač iznad linka.

Isticanje nepodudaranja

Za web linkove Reveal URLs poredi URL-ove ili imena hostova u vidljivom tekstu linka s URL-om na koji on vodi. Poređenje se radi na registrable domeni, pa sub-domain bez nepodudarnosti kao mail.example.com za example.com nije označen, dok look-alike host kao paypa1.com za paypal.com jeste. Pregledničko proširenje i Thunderbird također provjeravaju e-mail, telefonske i neprozirne linkove; linkovi javascript:, data: i vbscript: uvijek se označavaju.

Provjera uzima u obzir samo URL koji sam link navodi; preusmjeravanja se nikad ne prate, pa se link preko trackera ili preusmjerivača poredi kao njegov URL, a ne kao stranica do koje na kraju stiže.

Nepodudaranje se prikazuje bojom za nepodudaranje koju ste odabrali i podebljano.

To kontrolišu dvije povezane postavke:

• Istakni nepodudarne linkove uključuje ili isključuje isticanje nepodudaranja.
• Prikaži samo nepodudarajuće linkove u tekstu skriva vidljivo inline otkrivanje za linkove bez nepodudarnosti, ali i dalje stavlja njihov odredišni URL u atribut title linka, tako da se prikazuje pri prelasku mišem.

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.

Dok je Reveal URLs uključen, ikona na alatnoj traci preglednika vam također govori, po kartici, šta je pronašla na trenutnoj stranici. Ako stranica ima nepodudarajuće (nalik pravim) veze, ikona prikazuje taj broj na crvenoj znački; ako stranica ima veze, ali nijedna od njih nije nepodudarajuća, prikazuje ukupan broj analiziranih veza na sivoj znački; stranica bez veza za analizu (i svaka stranica na kojoj ekstenzija ne djeluje) ne prikazuje broj. Svaka kartica zadržava vlastitu značku, pa prebacivanje između kartica ažurira broj, a napuštanje stranice ili zatvaranje kartice ga briše. (Brojevi iznad 99 prikazuju se kao 99+.)

Značka u svoja tri stanja (preglednik je iscrtava, pa se tačan položaj malo razlikuje ovisno o pregledniku): crveni broj nepodudaranja, sivi broj analiziranih veza i značka OFF dok je ekstenzija onemogućena; njen logo je također prigušeno svijetlosiv. Na stranici na kojoj je ekstenzija uključena, ali nije aktivna, nema značke; odsutna značka OFF razlikuje isti prigušeni logo od onoga u onemogućenom stanju.

Ove ilustracije ne pokazuju svaki ishod bez značke; aktivna stranica bez veza za analizu zadržava ikonu normalne boje.

(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 Omogući Reveal URLs 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.

• Omogući Reveal URLs — glavni prekidač za uključivanje i isključivanje na samom vrhu stranice. Djeluje odmah, bez potrebe da sačuvate ostatak forme.
• Jezik prikaza — 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.
• Istakni nepodudarne linkove — uključite ili isključite isticanje nepodudaranja.
• Boja nepodudaranja — CSS boja za označeni link, na primjer red, #cc0000 ili rgb(200, 0, 0). Zadana vrijednost je crvena.
• Boja bez nepodudarnosti — boja prikazanog URL-a na vezama bez nepodudarnosti (na primjer black ili #b45309). Zadana je jantarni ton opreza (#b45309), odabran tako da veza bez upozorenja ne djeluje kao potvrđeno sigurna.
• Prikaži samo nepodudarajuće linkove u tekstu — sakrijte vidljivo inline otkrivanje za linkove bez nepodudarnosti; njihov odredišni URL ostaje u atributu title linka i prikazuje se pri prelasku mišem.
• Ignoriši ove hostove — lista hostname-ova koje treba potpuno preskočiti, po jedan u svakom redu. Preskaču se i sub-domaini navedenog hosta.
• Maksimalna dužina prikazanog URL-a — dugi URL-ovi skraćuju se nakon ovog broja znakova, pri čemu host ostaje vidljiv. Dozvoljeni raspon je od 20 do
• Veličina / debljina fonta prikazanog URL-a — opcionalne tipografske izmjene. Ostavite prazno ako želite zadržati zadane vrijednosti.

Osim glavnog prekidača Omogući Reveal URLs i kontrola Aktivni sajtovi, koje se primjenjuju odmah, promjene se čuvaju dugmetom Sačuvaj postavke.

Aktivni sajtovi — dodavanje vlastitog webmaila

Odjeljak Aktivni sajtovi pri vrhu stranice postavki navodi stranice na kojima Reveal URLs radi. Sada ostaje fiksne visine: izaberite jedan sajt iz padajućeg menija, pa u panelu ispod uređujte samo postavke tog sajta.

Padajući meni prikazuje jednu stavku za svako pravilo sajta:

• ugrađena pravila koriste čitljiva imena kao što su Gmail, Proton Mail i Outlook (Live);
• kada više pravila dijeli isto ime, padajući meni dodaje host u zagradama, na primjer Tuta (app.tuta.com) i Zoho Mail (mail.zoho.eu);
• pravilo koje doda korisnik koristi svoj neobavezni Naziv, ili svoj match URL kada ime ostane prazno.

Editor odabranog sajta prikazuje:

• URL podudaranja sajta kao identifikator samo za čitanje;
• uređivo Naziv sajta;
• prekidač Omogućeno;
• Selektor tijela poruke (CSS selector za container koji Reveal URLs označava), koji možete urediti;
• prekidač Podokviri, za sajtove čije se tijelo poruke prikazuje unutar iframe-a;
• dugme Ukloni samo za sajtove koje ste sami dodali.

Ugrađeni servisi (FastMail, Gmail, Outlook Live, Outlook 365, Proton, Tuta, Yahoo i Zoho) mogu se isključiti i preusmjeriti, ali se ne mogu ukloniti. Njihova imena se ovdje također mogu preimenovati; brisanje imena ugrađenog servisa vraća njegovo zadano čitljivo ime.

Da biste dodali vlastiti webmail sajt:

1. U odjeljku Dodaj stranicu unesite URL podudaranja — match pattern kao što je https://mail.example.com/*.
2. Po želji unesite Naziv za padajući meni. Ostavite ga praznim da bi se koristio match URL.
3. Unesite Selektor tijela poruke — CSS selector za container koji sadrži tijelo poruke, na primjer .message-body.
4. Ako se tijelo poruke prikazuje unutar podokvira, označite Također izvodite unutar podokvira.
5. Kliknite Dodaj stranicu. 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. Da biste promijenili match URL sajta, uklonite ga i dodajte ponovo: match ostaje samo za čitanje jer je to identitet pravila.

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 Aktivni sajtovi ne prikazuje na Thunderbird stranici postavki. Tamo su prikazani samo glavni prekidač, jezik prikaza, 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. Dijele http/https prepoznavanje URL-ova i hostova pregledničkog proširenja, ali ne analiziraju njegove dodatne sheme linkova.

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 http/https link prikazuju se vidljivi tekst i odredišni URL, a nepodudaranje se označava samo kada vidljivi tekst navodi URL ili ime hosta čija se registrable domena ne podudara s domenom odredišta linka.

• 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. Look-alike link označen je crveno uz ikonu upozorenja; URL linka bez nepodudarnosti prikazuje se zadanom bojom teksta kartice, koja prati svijetlu ili tamnu Gmail temu. 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.

Gmail dodatak je sada dostupan putem Google Workspace Marketplacea.

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 Jezik prikaza 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, 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č Omogući Reveal URLs na stranici postavki mora biti uključen.
• Provjerite da li je sajt pokriven. Ugrađeni servisi (FastMail, Gmail, Outlook Live, Outlook 365, Proton, Tuta, Yahoo, Zoho) rade odmah. Svaki drugi webmail mora biti dodan u Aktivni sajtovi 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.
• Provajderi s open shadow root-om otkrivaju se batch-po-batch skeniranjem body-ja čim se body-observer batch pokrene nakon što host uđe u DOM. Kasni shadow root nadograđuje se u sljedećem batch-u mutacija body-ja. Jedini nepodržani slučaj je kada se host ili shadow root pojavi, a zatim se više nikada ne okine nijedna mutacija body-ja na stranici.
• Pregledničko proširenje i Thunderbird otkrivaju i linkove koji koriste druge scheme-ove — mailto: (e-mail), tel:/sms: (telefon) i neprozirne scheme-ove kao što su javascript:, data: ili blob: — i označavaju ih kada vidljivi tekst navodi drugačije odredište od onoga na koje link zaista vodi; linkovi javascript:, data: i vbscript: uvijek se označavaju (na primjer adresa prikazana kao billing@paypal.com čiji mailto: cilja na drugu domenu, ili link koji izgleda kao web adresa, a zapravo je javascript: link). Preskaču se samo linkovi prema sidrima unutar stranice (#…) i prazni ili neispravni linkovi, kao i hostovi sa vaše liste Ignoriši ove hostove. Imajte na umu da se ovo šire pokrivanje scheme-ova odnosi na inline anotaciju pregledničkog proširenja; paneli s nalazima native Outlook i Gmail dodataka trenutno pokrivaju samo http/https linkove.

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 Aktivni sajtovi uredite message-body selector tog servisa tako da pokazuje na novi container.

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

Napomene za Safari

Safari prikazuje značku samo kada se veze ne podudaraju; nema sivog brojača za sigurnu stranicu. Ponovno otvorite postavke iz menija desnim klikom Reveal URLs — settings, umjesto da učitate zastarjelu karticu postavki.