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čko uputstvo

Reveal URLs je mala ekstenzija za pregledač i dodatak za Thunderbird koji vam pokazuje kuda link u vašoj e-pošti stvarno vodi, tako da phishing link možete da prepoznate pre nego što kliknete.

Ovo uputstvo objašnjava kako da instalirate Reveal URLs i kako da ga koristite. Za česta pitanja pogledajte često postavljana pitanja; 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 trebalo da bude podržan, prijavite to na Codeberg issue tracker.

Sadržaj

• Šta radi i zašto
• Podržani pregledači i aplikacije e-pošte
• Instalacija
• Korišćenje
• Outlook i Gmail dodaci
• Jezici
• Privatnost
• Rešavanje problema
• Licenca i izvorni kod

Šta radi i zašto

Phishing poruka krije neprijateljsko odredište iza teksta linka koji izgleda pouzdano. Nekada 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 preko tracker-a ili redirector-a, pa mesto na koje stignete nema skoro nikakve veze sa brendom pomenutim u tekstu.

Napomena: Ovaj snimak ekrana prikazuje lažni fišing imejl koji se predstavlja kao poštanska usluga. Oponašana usluga nije povezana sa Reveal URLs i ne podržava ga.

Reveal URLs čita svaku vezu u poruci koju gledate i prikazuje URL na koji ona vodi. U proširenju pregledača i dodatku za Thunderbird označava obmanjujuće veb, e-poštanske, telefonske i druge veze, tako da je razlika jasna pre klika.

Reveal URLs otkriva i označava; ne proverava. Ne prati preusmeravanja: veza koja prolazi kroz pratilac ili preusmerivač prikazuje se kao URL pratioca ili preusmerivača koji zaista navodi; Reveal URLs ne može znati gde to preusmeravanje na kraju vodi. Kod veze bez upozorenja nije utvrđeno nijedno primenljivo neslaganje, ali to ne potvrđuje da je bezbedna, zato pročitajte otkriveni URL pre nego što poverujete vezi, čak i kada ništa nije označeno. Da biste to imali na umu, otkriveni URL neoznačene veze prikazuje se u ćilibarnoj boji „za proveru“ umesto u umirujuće zelenoj.

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

U ekstenziji za pregledač i dodatku za Thunderbird sve se odvija na vašem 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 gde se izvršavaju i kako se isporučuje kod za Outlook panel. Više detalja nalazi se u odeljku Privatnost i u politici privatnosti.

Podržani pregledači i aplikacije e-pošte

Reveal URLs radi u sledećem:

Veb pregledači:

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

Aplikacije za e-poštu:

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

U pregledačima 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 prodavnice vašeg pregledača ili klijenta e-pošte (preporučeno)

Instalirajte Reveal URLs iz prodavnice za vaš pregledač ili klijent e-pošte. Instalirajte Reveal URLs iz prodavnice za svoj pregledač ili klijent e-pošte. Svi unosi su sada dostupni; Opera koristi Chrome verziju.

Veb pregledači:

• 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 build-a (razvoj i rano testiranje)

Ako ste Reveal URLs izgradili iz izvornog koda, možete direktno da učitate raspakovani build. Svaki target se gradi komandom make i nastaje u direktorijumu 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 direktorijum:

• 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 direktorijuma dist/firefox, na primer 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 se ne učitavaju kao raspakovane ekstenzije pregledača. Izgradite ih kao gore, zatim:

make deploy-gmail        # raspoređuje Gmail dodatak na Apps Script
make safari-xcode        # gradi Safari Xcode projekat, zatim ga pokrenite
                         # iz Safari menija Develop (macOS)
                         # Outlook: bočno učitajte dist/outlook

Stranica podešavanja automatski se otvara pri prvoj instalaciji ekstenzije.

Korišćenje

Odmah po instalaciji 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 telo poruke, pa sopstveni chrome aplikacije, kao što su bočna traka, prozor za pisanje i alatne trake, ostaje netaknut. U Thunderbirdu je obuhvaćena cela rendered email poruka.

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

Kako se prikazuje stvarni URL

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

Isticanje nepodudaranja

Za veb-veze Reveal URLs upoređuje nazive URL-ova ili hostova u vidljivom tekstu veze sa URL-om na koji ona vodi. Poređenje se vrši po registrovanom domenu, pa se poddomen bez nepodudaranja kao mail.example.com za example.com ne označava, dok se sličan kao paypa1.com za paypal.com označava. Proširenje pregledača i Thunderbird takođe proveravaju e-poštanske, telefonske i neprozirne veze; veze javascript:, data: i vbscript: se uvek označavaju.

Provera razmatra samo URL koji navodi sama veza; preusmeravanja se nikada ne prate, pa se veza preko pratioca ili preusmerivača upoređuje sa njegovim URL-om, a ne sa stranicom do koje na kraju stiže.

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

To kontrolišu dva povezana podešavanja:

• Istakni linkove koji se ne poklapaju uključuje ili isključuje isticanje nepodudaranja.
• Prikaži u tekstu samo linkove koji se ne podudaraju skriva vidljivo otkrivanje u tekstu za veze bez nepodudaranja, ali njihov odredišni URL i dalje upisuje u atribut title veze, pa se prikazuje pri prelasku mišem.

Dugme alatne trake

U Chromeu, Edgeu, Operi, Firefoxu i Thunderbirdu ikona Reveal URLs na traci sa alatkama je brzi prekidač za uključivanje i isključivanje — kliknite je da biste prebacili anotaciju. Kada je ekstenzija isključena, na ikoni se pojavljuje oznaka OFF, a njen opis vam govori da li će je klik uključiti ili isključiti. U pregledačima promena stupa na snagu u svim otvorenim karticama odjednom; u Thunderbirdu se primenjuje na sledeću poruku koju otvorite.

Dok je Reveal URLs uključen, ikona na traci sa alatkama pregledača vam takođe, za svaku karticu, govori šta je pronašla na trenutnoj stranici. Ako stranica ima nepodudarajuće (slične) linkove, ikona prikazuje taj broj na crvenoj oznaci; ako stranica ima linkove, ali nijedan od njih nije nepodudarajući, prikazuje ukupan broj analiziranih linkova na sivoj oznaci; stranica bez linkova za analizu (i svaka stranica na koju ekstenzija ne deluje) ne prikazuje broj. Svaka kartica zadržava sopstvenu oznaku, 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+.)

Oznaka u svoja tri stanja (pregledač je iscrtava, pa se tačno mesto malo razlikuje od pregledača do pregledača): crveni broj nepodudaranja, sivi broj analiziranih linkova i oznaka OFF dok je ekstenzija onemogućena; njen logo je takođe prigušeno svetlosiv. Na stranici na kojoj omogućena ekstenzija nije aktivna nema oznake; odsustvo oznake OFF razlikuje taj isti prigušeni logo od stanja onemogućene ekstenzije.

Ove ilustracije ne prikazuju svaki ishod bez oznake; aktivna stranica bez linkova za analizu zadržava ikonu normalne boje.

(U Thunderbirdu dugme prikazuje samo svoju ikonu, pa ostaje kompaktno u objedinjenoj traci sa alatkama. Reveal URLs možete da uključujete i isključujete i prekidačem Omogući Reveal URLs na stranici podešavanja.)

Stranica podešavanja

Na stranici podešavanja nalaze se sve opcije. Otvorite je sa stranice ekstenzija u vašem pregledaču, na primer 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. Deluje odmah, bez potrebe da sačuvate ostatak forme.
• Jezik prikaza — izaberite jezik na kome će biti prikazana stranica podešavanja. Podrazumevano prati jezik vašeg pregledača i vraća se na engleski ako vaš jezik nije podržan. To možete promeniti izborom drugog jezika sa liste. Vaš izbor deluje odmah, pamti se i čuva samo na ovom uređaju.
• Istakni linkove koji se ne poklapaju — uključite ili isključite isticanje nepodudaranja.
• Boja nepodudaranja — CSS boja za označeni link, na primer red, #cc0000 ili rgb(200, 0, 0). Podrazumevana vrednost je crvena.
• Boja bez nepodudaranja — boja otkrivenog URL-a na vezama bez nepodudaranja (na primer black ili #b45309). Podrazumevana je ćilibarni ton opreza (#b45309), izabran tako da veza bez upozorenja ne deluje potvrđeno bezbedno.
• Prikaži u tekstu samo linkove koji se ne podudaraju — sakrijte vidljivo otkrivanje u tekstu za veze bez nepodudaranja; njihov odredišni URL ostaje u atributu title veze 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 posle ovog broja znakova, pri čemu host ostaje vidljiv. Dozvoljeni raspon je od 20 do 2000.
• Veličina / debljina fonta otkrivenog URL-a — opciona tipografska podešavanja. Ostavite prazno ako želite da zadržite podrazumevane vrednosti.

Osim glavnog prekidača Omogući Reveal URLs i kontrola Aktivni sajtovi, koje se primenjuju odmah, promene se čuvaju dugmetom Sačuvaj podešavanja.

Aktivni sajtovi — dodavanje sopstvenog webmaila

Odeljak Aktivni sajtovi pri vrhu stranice podešavanja koristi dropdown koji prikazuje jedan sajt odjednom. Izaberite sajt da biste ispod njega prikazali njegov editor, koji obuhvata stranicu na kojoj Reveal URLs radi i container koji sadrži telo svake poruke.

Dropdown prikazuje jednu opciju za svaki aktivni sajt. Njegova oznaka koristi ime sajta kada je dostupno, a u suprotnom match pattern. Kada više sajtova deli isto ime, host se dodaje u zagradama radi razlikovanja, na primer Gmail, Proton Mail, Outlook (Live), Tuta (app.tuta.com) ili Zoho Mail (mail.zoho.eu).

Editor izabranog sajta prikazuje:

• samo-za-čitanje URL za podudaranje sajta
• uređivo Naziv sajta
• prekidač Omogućeno
• message-body selector, odnosno CSS selector za container koji Reveal URLs označava i koji možete da uredite
• prekidač Podokviri, za sajtove čije se telo poruke prikazuje unutar iframe
• dugme Ukloni, samo za sajtove koje ste sami dodali

Ugrađeni servisi (FastMail, Gmail, Outlook Live, Outlook 365, Proton, Tuta, Yahoo i Zoho) imaju određena imena i mogu da se isključe ili preusmere, ali ne mogu da se uklone. Njihova imena ovde takođe mogu da se preimenuju; brisanje imena ugrađenog servisa vraća njegovo podrazumevano prijateljsko ime. Match URL je samo za čitanje za svaki postojeći sajt; ako želite da ga promenite, uklonite sajt i ponovo ga dodajte sa novom vrednošću.

Da biste dodali sopstveni webmail sajt:

1. U odeljku Dodaj sajt unesite URL za podudaranje — match pattern kao što je https://mail.example.com/*.
2. Opciono unesite Naziv ako želite da dropdown prikazuje prijatnije ime umesto URL-a.
3. Unesite Birač tela poruke — CSS selector za container koji sadrži telo poruke, na primer .message-body.
4. Ako se telo poruke prikazuje unutar podokvira, označite Pokreni i unutar podokvira.
5. Kliknite Dodaj sajt. Vaš pregledač tražiće dozvolu za pristup tom sajtu. Dodelite je. Sajt se dodaje tek kada je dozvola potvrđena.

Promene ovde deluju odmah. Uklanjanje sajta koji ste dodali takođe opoziva njegovu dozvolu, pa Reveal URLs prestaje da pristupa tom sajtu. Da biste promenili match URL sajta, uklonite ga i ponovo dodajte: match ostaje samo za čitanje zato što je 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 odeljak Aktivni sajtovi ne prikazuje na Thunderbird stranici podešavanja. Tamo su prikazani samo glavni prekidač, jezik prikaza, boje, fontovi i lista ignorisanja. Svaka konfiguracija aktivnih sajtova koju ste možda postavili u pregledaču ostaje netaknuta. Čuvanje podešavanja u Thunderbirdu nikada je ne briše.

Outlook i Gmail dodaci

Pored ekstenzije za pregledač i dodatka za Thunderbird, Reveal URLs dostupan je i kao native dodatak za dve aplikacije za poštu do kojih ekstenzija za pregledač ne može da dosegne: Outlook dodatak i Gmail dodatak. Oni dele otkrivanje http/https URL-ova/hostova proširenja pregledača, ali ne analiziraju njegove dodatne šeme veza.

Jedina razlika je u tome kako prikazuju nalaze. Ekstenzija za pregledač označava linkove na samom mestu, bojeći URL iznad ili pored svakog linka. Outlook i Gmail okviri ne dozvoljavaju dodatku da menja prikazanu poruku, pa zato svaki dodatak umesto toga prikazuje bočnu tablu (Outlook) ili karticu (Gmail) sa spiskom pronađenih veza. Za svaku http/https vezu prikazuje vidljivi tekst i odredišni URL i označava nepodudaranje samo kada vidljivi tekst navodi URL ili host čiji se registrabilni domen ne podudara sa odredištem veze.

• 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, osvežavaće se dok prelazite između poruka. Look-alike link se označava crveno ikonom upozorenja; URL veze bez nepodudaranja prikazuje se podrazumevanom bojom teksta kartice, koja prati Gmailovu svetlu ili tamnu 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 proveri svaki put kada je otvorite, i ne zadržava se. Pogledajte politiku privatnosti za detalje o tome čemu svaki oblik pristupa i šta skladišti.

Gmail dodatak je sada dostupan putem Google Workspace Marketplacea.

Jezici

Reveal URLs dostupan je na engleskom i na mnogim drugim jezicima.

• Stranica podešavanja automatski prati jezik vašeg pregledača i vraća se na engleski ako vaš jezik nije podržan. To možete u svakom trenutku da promenite pomoću birača Jezik prikaza pri vrhu stranice. Vaš izbor pamti se na tom uređaju. Pogledajte Stranica podešavanja.
• Ova web stranica, odnosno početna stranica i ove dokumentacione stranice, takođe prepoznaje jezik vašeg pregledača i nudi birač jezika u zaglavlju. Uputstvo 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 proveru, pa neka formulacija ponekad može da zvuči nespretno. Nazivra je da značenje ostane isto kao u engleskom originalu. Ako primetite 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. Gde i kako se posao obavlja zavisi od oblika:

• Ekstenzija za pregledač 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 renderovanja, bez skladištenja 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 proveri svaki put kada je otvorite, i ne zadržava se.

Jedino što se skladišti jesu vaša sopstvena podešavanja, 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. Ona se čuvaju u per-user storage vašeg pregledača, Outlook-a ili Google-a i nikada nam se ne šalju.

Više detalja potražite u politici privatnosti.

Rešavanje problema

Neki link se ne otkriva.

• Proverite da li je Reveal URLs uključen. Ikona u alatnoj traci ne sme da prikazuje oznaku OFF, a prekidač Omogući Reveal URLs na stranici podešavanja mora biti uključen.
• Proverite da li je sajt pokriven. Ugrađeni servisi (FastMail, Gmail, Outlook Live, Outlook 365, Proton, Tuta, Yahoo i Zoho) rade odmah. Svaki drugi webmail mora biti dodat u Aktivni sajtovi sa svojim match URL-om i message-body selector-om.
• Proverite message-body selector. Ako se ne podudara sa container-om koji sadrži telo poruke, linkovi unutar tog container-a neće biti otkriveni.
• Imajte u vidu da se neki webmail provajderi, kao što je Tuta, renderuju unutar open shadow root-a. Reveal URLs otkriva takve hostove pomoću batch skeniranja tela dokumenta i nadograđuje ih u sledećem batch-u mutacija body ako se shadow root pojavi kasnije. Jedini nepodržani slučaj je kada se host ili njegov shadow root pojavi, a stranica posle toga više nema nijednu DOM mutaciju.
• Proširenje pregledača i Thunderbird otkrivaju i veze koje koriste druge šeme — mailto: (e-pošta), tel:/sms: (telefon) i neprozirne šeme kao što su javascript:, data:, vbscript: ili blob: — i označavaju ih kada vidljivi tekst navodi drugačije odredište od onog na koje veza zaista vodi; veze javascript:, data: i vbscript: se uvek označavaju (na primer adresa prikazana kao billing@paypal.com čiji mailto: vodi na drugi domen, ili veza koja izgleda kao veb-adresa, a zapravo je javascript: veza). Preskaču se samo linkovi ka sidrima unutar stranice (#…) i prazni ili neraščlanjivi linkovi, kao i hostovi sa vaše liste Ignoriši ove hostove. Imajte u vidu da se ovo šire pokrivanje scheme-ova odnosi na inline anotaciju ekstenzije za pregledač; izvorni paneli nalaza dodataka za Outlook i Gmail trenutno pokrivaju samo http/https linkove.

Ugrađeni servis je prestao da radi posle redizajna.

Webmail servisi s vremena na vreme menjaju markup svojih stranica. Ako se selector ugrađenog servisa posle takve promene više ne podudara, možete sami da ga ispravite: u odeljku 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 sivi brojač za sigurnu stranicu. Ponovo otvorite podešavanja iz menija desnim klikom Reveal URLs — settings, umesto ponovnog učitavanja stare kartice podešavanja.