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 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 česta pitanja pogledajte FAQ; 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 aplikacije 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.

Napomena: Ova snimka zaslona prikazuje lažni phishing e-mail koji se predstavlja kao poštanska usluga. Oponašana usluga 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. U proširenju za preglednik i Thunderbirdu označava obmanjujuće web, e-poštanske, telefonske i druge poveznice, tako da je razlika očita prije nego što kliknete.

Reveal URLs otkriva i označava; ne provjerava. Ne slijedi preusmjeravanja: poveznica koja prolazi kroz tracker ili preusmjerivač prikazuje se kao URL preusmjerivača koji stvarno navodi; Reveal URLs ne može znati gdje će to preusmjeravanje na kraju završiti. Na poveznici bez upozorenja nije utvrđeno nikakvo primjenjivo nepodudaranje, a nije potvrđena kao sigurna, pa pročitajte otkriveni URL prije nego što se pouzdate u poveznicu, čak i kada ništa nije označeno. Da biste to imali na umu, otkriveni URL neoznačene poveznice prikazuje se u jantarnoj boji „za provjeru“ umjesto u umirujuće zelenoj.

Napomena: adrese e-pošte, URL-ovi i imena na ovoj snimci zaslona maskirani su zvjezdicama radi privatnosti.

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

Reveal URLs radi na:

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

Web preglednici:

• Brave — instalirajte Chrome izdanje iz Chrome Web Store
• Chrome — Chrome Web Store
• Edge — Microsoft Edge Add-ons
• Firefox — Firefox Add-ons (AMO)
• Opera — instalirajte Chrome izdanje 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 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        # stvara dist/chrome
make build-edge          # stvara dist/edge
make build-firefox       # stvara dist/firefox
make build-gmail         # stvara dist/gmail
make build-opera         # stvara dist/opera
make build-outlook       # stvara dist/outlook
make build-safari        # stvara dist/safari
make build-thunderbird   # stvara dist/thunderbird

Zatim učitajte dobivenu mapu:

• Chrome — otvorite chrome://extensions, uključite Developer mode, kliknite Load unpacked i odaberite dist/chrome.
• Edge — otvorite edge://extensions, uključite Developer mode, kliknite Load unpacked i odaberite dist/edge.
• Firefox — otvorite about:debugging, odaberite This Firefox, kliknite Load Temporary Add-on i odaberite bilo koju datoteku unutar dist/firefox, primjerice njegov manifest.json. Privremeni dodatak uklanja se pri ponovnom pokretanju Firefoxa.
• Opera — otvorite opera://extensions, uključite Developer mode, kliknite Load unpacked i odaberite 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 proširenje, Outlook dodatak i Gmail dodatak ne učitavaju se kao raspakirana proširenja preglednika. Izgradite ih kao gore, zatim:

make deploy-gmail        # postavlja Gmail dodatak na Apps Script
make safari-xcode        # izgradi Safari Xcode projekt, zatim ga pokrenite
                         # iz Safarijeva 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 poveznice u porukama na ugrađenim pružateljima, bez ikakvog 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, 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.

Napomena: adrese e-pošte, URL-ovi i imena na ovoj snimci zaslona maskirani su zvjezdicama radi privatnosti.

Kako se prikazuje stvarni URL

Stvarni URL svake poveznice prikazuje se u vlastitom retku, odmah iznad teksta poveznice. Također se postavlja u opis (title) poveznice, tako da je puni URL uvijek tamo kada zadržite pokazivač iznad poveznice.

Isticanje nepodudaranja

Za web poveznice Reveal URLs uspoređuje URL ili naziv hosta u vidljivom tekstu poveznice s URL-om na koji ona vodi. Usporedba se radi na registrable domeni, pa poddomena bez nepodudarnosti 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. Proširenje za preglednik i Thunderbird također provjeravaju e-poštanske, telefonske i neprozirne poveznice; poveznice javascript:, data: i vbscript: uvijek se označavaju.

Provjera razmatra samo URL koji sama poveznica navodi; preusmjeravanja se nikada ne slijede, pa se poveznica kroz tracker ili preusmjerivač uspoređuje s njegovim URL-om, a ne sa stranicom do koje na kraju vodi.

Nepodudaranje se prikazuje odabranom bojom nepodudaranja i podebljano.

Dvije povezane postavke upravljaju tim ponašanjem:

• Istaknite poveznice koje se ne podudaraju uključuje ili isključuje isticanje nepodudaranja.
• Prikaži samo nepodudarajuće poveznice u retku skriva vidljivo otkrivanje u retku za poveznice bez nepodudarnosti, ali i dalje upisuje njihov odredišni URL u atribut title poveznice, pa se prikazuje pri prelasku mišem.

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.

Dok je Reveal URLs uključen, ikona na alatnoj traci preglednika također vam govori, po kartici, što je pronašla na trenutnoj stranici. Ako stranica ima nepodudarajuće (slične) poveznice, ikona prikazuje taj broj na crvenoj znački; ako stranica ima poveznice, ali nijedna nije nepodudarajuća, prikazuje ukupan broj analiziranih poveznica na sivoj znački; stranica bez poveznica za analizu (i svaka stranica na koju proširenje 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 točan položaj malo razlikuje ovisno o pregledniku): crveni broj nepodudaranja, sivi broj analiziranih poveznica i značka OFF dok je proširenje onemogućeno; njegov je logotip također prigušeno svijetlosiv. Na stranici na kojoj omogućeno proširenje nije aktivno nema značke; izostanak značke OFF razlikuje taj isti prigušeni logotip od onemogućenog stanja.

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

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

• Omogući Reveal URLs — glavni prekidač za uključivanje i isključivanje na samom vrhu stranice. Stupa na snagu odmah, bez spremanja ostatka obrasca.
• Jezik prikaza — 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.
• Istaknite poveznice koje se ne podudaraju — uključite ili isključite isticanje nepodudaranja.
• Neusklađena boja — CSS boja koja se koristi za označenu poveznicu, primjerice red, #cc0000 ili rgb(200, 0, 0). Zadana boja je crvena.
• Boja poveznica bez nepodudarnosti — boja otkrivenog URL-a na poveznicama bez nepodudarnosti (na primjer black ili #b45309). Zadano je jantarni ton opreza (#b45309), odabran tako da poveznica bez upozorenja ne izgleda potvrđeno sigurna.
• Prikaži samo nepodudarajuće poveznice u retku — sakrijte vidljivo otkrivanje u retku za poveznice bez nepodudarnosti; njihov odredišni URL ostaje u atributu title poveznice i prikazuje se pri prelasku mišem.
• Ignorirajte ove domaćine — popis hostnames koje treba potpuno preskočiti, jedan po retku. Preskaču se i poddomene navedenog hosta.
• Maksimalna duljina prikazanog URL-a — dugi URL-ovi skraćuju se nakon ovog broja znakova, uz zadržavanje vidljivog hosta. Dopušteni raspon: 20 do
• Veličina / debljina fonta prikazanog URL-a — neobavezna nadjačavanja tipografije. Ostavite prazno ako želite zadržati zadane vrijednosti.

Osim glavnog prekidača Omogući Reveal URLs i kontrola Aktivna mjesta, koje se primjenjuju odmah, promjene se spremaju gumbom Spremi postavke.

Aktivna mjesta — dodavanje vlastitog webmaila

Odjeljak Aktivna mjesta pri vrhu stranice postavki navodi stranice na kojima Reveal URLs radi. Sada zadržava stalnu visinu: odaberite jednu stranicu iz padajućeg izbornika i uređujte samo postavke te stranice u panelu ispod.

Padajući izbornik prikazuje jednu stavku za svako pravilo stranice:

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

Editor odabrane stranice prikazuje:

• Podudaranje URL-a stranice kao identifikator samo za čitanje;
• uređivi Naziv stranice;
• preklopnik Omogućeno;
• Birač tijela poruke (CSS selector za container koji Reveal URLs označava), a koji možete uređivati;
• preklopnik Podokviri, za stranice čije se tijelo poruke prikazuje unutar iframe-a;
• gumb Ukloniti, samo za stranice koje ste sami dodali.

Ugrađeni pružatelji (FastMail, Gmail, Outlook Live, Outlook 365, Proton, Tuta, Yahoo i Zoho) mogu se isključiti ili preusmjeriti na novi cilj, ali ih nije moguće ukloniti. Njihova se imena ovdje također mogu preimenovati; brisanje imena ugrađenog pružatelja vraća njegovo zadano čitljivo ime.

Za dodavanje vlastite webmail stranice:

1. Pod Dodaj mjesto unesite Podudaranje URL-a — match pattern poput https://mail.example.com/*.
2. Po želji unesite Naziv za padajući izbornik. Ostavite ga praznim kako bi se koristio match URL.
3. Unesite Birač tijela poruke — CSS selector za container koji sadrži tijelo poruke, primjerice .message-body.
4. Ako se tijelo poruke prikazuje unutar podokvira, označite Također izvodite unutar podokvira.
5. Kliknite Dodaj mjesto. 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. Ako želite promijeniti match URL stranice, uklonite je i ponovno dodajte: 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 pružatelja, pa mu popis po hostovima nije potreban. Zbog toga se odjeljak Aktivna mjesta ne prikazuje na stranici postavki u Thunderbirdu. Ondje se prikazuju samo glavni prekidač, jezik prikaza, 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. Dijele http/https URL-/host-detekciju proširenja za preglednik, ali ne analiziraju njegove dodatne scheme poveznica.

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

• 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. Look-alike poveznica označena je crveno s ikonom upozorenja; URL poveznice bez nepodudarnosti prikazuje se zadanom bojom teksta kartice, koja prati svijetlu ili tamnu temu Gmaila. 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.

Gmail dodatak sada je dostupan putem Google Workspace Marketplacea.

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 Jezik prikaza 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č Omogući Reveal URLs na stranici postavki mora biti uključen.
• Provjerite je li stranica obuhvaćena. Ugrađeni pružatelji (FastMail, Gmail, Outlook Live, Outlook 365, Proton, Tuta, Yahoo i Zoho) rade odmah. Svaki drugi webmail treba dodati pod Aktivna mjesta 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.
• Pružatelji s open shadow rootom otkrivaju se batch-po-batch skeniranjem bodyja čim se body-observer batch pokrene nakon što host uđe u DOM. Kasni shadow root nadograđuje se u sljedećem batchu mutacija bodyja. Jedini nepodržani slučaj je kada se host ili shadow root pojavi, a zatim se više nikada ne pokrene nijedna mutacija bodyja na stranici.
• Proširenje za preglednik i Thunderbird otkrivaju i poveznice koje koriste druge scheme — mailto: (e-pošta), tel:/sms: (telefon) i neprozirne scheme poput javascript:, data:, vbscript: ili blob: — i označavaju ih kada vidljivi tekst imenuje odredište različito od onoga na koje poveznica stvarno pokazuje (na primjer adresu prikazanu kao billing@paypal.com čiji mailto: cilja drugu domenu, ili poveznicu koja izgleda kao web adresa, a zapravo je javascript: poveznica); poveznice javascript:, data: i vbscript: uvijek se označavaju. Preskaču se samo poveznice na sidra unutar iste stranice (#…) i prazne ili neraščlanjive poveznice, kao i hostovi na vašem popisu Ignorirajte ove domaćine. Imajte na umu da se ta šira pokrivenost scheme odnosi na inline anotaciju proširenja za preglednik; ploče s nalazima izvornih Outlook i Gmail dodataka trenutačno pokrivaju samo http/https poveznice.

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 Aktivna mjesta uredite message-body selector tog pružatelja tako da odgovara novom containeru.

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

Napomene za Safari

Safari prikazuje značku samo kada se poveznice ne podudaraju; nema sivi brojač sigurne stranice. Ponovno otvorite postavke iz izbornika desnim klikom Reveal URLs — settings, umjesto ponovnog učitavanja stare kartice postavki.