Reveal URLs — Uporabniški priročnik

Reveal URLs je majhna razširitev za brskalnik (in dodatek za Thunderbird), ki vam pokaže, kam povezava v vaši e-pošti v resnici vodi, tako da lahko prepoznate phishing povezavo, preden nanjo kliknete.

Ta priročnik pojasnjuje, kako namestiti Reveal URLs in kako ga uporabljati. O tem, kako se ravna z vašimi podatki, glejte pravilnik o zasebnosti; za tehnični pregled zgradbe razširitve glejte pregled arhitekture.

Ste našli napako, povezavo, ki je bila napačno označena (ali spregledana), ali gostitelja spletne pošte, ki bi moral biti podprt? Prosimo, prijavite jo na sledilniku težav Codeberg.

Kaj počne in zakaj

Phishing e-pošta skrije sovražni cilj za besedilom povezave, ki je videti zaupanja vredno. Včasih gre za podobnega gostitelja: besedilo se glasi paypal.com, medtem ko povezava kaže na paypa1.com. Pogosto je bolj prefinjeno, z usmerjanjem prek sledilnika ali preusmerjevalnika, tako da cilj nima nič skupnega z blagovno znamko, navedeno v besedilu.

Phishing sporočilo, ki se izdaja za Pošto Slovenije, trdi, da je paket zadržan, dokler niso plačane neporavnane carinske dajatve, in spodbuja k plačilu prek gumba „Pojdi na plačilo“. Reveal URLs pokaže, da gumb ne vodi na Pošto Slovenije, temveč na parcel-pay.custom.co.xa, nepovezano spletno mesto, in tako razkrije sporočilo kot prevaro. — Reveal URLs razkrinka gumb „Pojdi na plačilo“: vodi na `parcel-pay.custom.co.xa`, ne na Pošto Slovenije.

Opomba: Ta posnetek zaslona prikazuje goljufivo phishing sporočilo, ki se izdaja za Pošto Slovenije. Pošta Slovenije ni povezana z Reveal URLs in ga ne podpira.

Reveal URLs prebere vsako povezavo v sporočilu, ki ga berete, in vam prikaže URL, na katerega kaže. Kadar se gostitelj, naveden v besedilu povezave, ne ujema z gostiteljem, na katerega povezava dejansko kaže, Reveal URLs to označi, tako da je neujemanje očitno, preden kliknete.

V razširitvi za brskalnik in dodatku za Thunderbird se vse dogaja na vaši lastni napravi in ne prenaša ničesar. V vseh oblikah Reveal URLs ne pošlje nobenih vaših e-poštnih podatkov nam ali kateri koli tretji osebi — ni analitike in ni sledenja. (Oblike se razlikujejo v tem, kje se izvajajo in kako se streže koda Outlookovega podokna; glejte razdelek Zasebnost in pravilnik o zasebnosti za vse podrobnosti.)

Podprti brskalniki in e-poštni odjemalec

Reveal URLs se izvaja na:

Google Chrome
Microsoft Edge
Opera
Mozilla Firefox
Mozilla Thunderbird (namizni e-poštni odjemalec)

Gradnja za Safari še ni na voljo; načrtovana je za poznejšo fazo.

Na brskalniških ciljih Reveal URLs označuje povezave v vaši spletni pošti. V Thunderbirdu označuje povezave v e-pošti, ki jo berete, neposredno v e-poštnem odjemalcu.

Namestitev

Iz trgovine vašega brskalnika ali e-poštnega odjemalca (priporočeno)

Namestite Reveal URLs iz trgovine za vaš brskalnik ali e-poštni odjemalec. Objave za Chrome, Edge, Firefox in Thunderbird so na voljo; Opera poganja gradnjo za Chrome, namenska objava za Opero pa je še na poti:

Chrome — trgovina Chrome Web Store
Edge — Microsoft Edge Add-ons
Opera — namestite različico za Chrome iz trgovine Chrome Web Store; namenska objava za Opero bo kmalu na voljo
Firefox — Firefox Add-ons (AMO)
Thunderbird — Thunderbird Add-ons (ATN)

Ročno nalaganje gradnje (razvijalci in zgodnje preizkušanje)

Če ste Reveal URLs zgradili iz izvorne kode, lahko neposredno naložite razpakirano gradnjo. Vsak cilj se zgradi z ukazom make in nastane 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

Nato naložite nastalo mapo:

Chrome — odprite chrome://extensions, vklopite Developer mode, kliknite Load unpacked in izberite dist/chrome.
Edge — odprite edge://extensions, vklopite Developer mode, kliknite Load unpacked in izberite dist/edge.
Opera — odprite opera://extensions, vklopite Developer mode, kliknite Load unpacked in izberite dist/opera.
Firefox — odprite about:debugging, izberite This Firefox, kliknite Load Temporary Add-on in izberite katero koli datoteko znotraj dist/firefox (na primer njeno manifest.json). Začasni dodatek se odstrani, ko se Firefox znova zažene.
Thunderbird — začasni dodatek namestite iz dist/thunderbird na enak način (prek Tools → Developer Tools → Debug Add-ons → Load Temporary Add-on).

Stran z nastavitvami se samodejno odpre ob prvi namestitvi razširitve.

Uporaba

Reveal URLs takoj po namestitvi označuje povezave v sporočilih pri vgrajenih ponudnikih — brez kakršne koli nastavitve:

Gmail (mail.google.com)
Outlook Live (outlook.live.com)
Outlook na spletu / Microsoft 365 (outlook.office.com)
Proton Mail (mail.proton.me)

Označevanje je omejeno na telo sporočila, tako da lasten vmesnik aplikacije — njena stranska vrstica, okno za sestavljanje in orodne vrstice — ostane nedotaknjen. V Thunderbirdu je pokrita celotna upodobljena e-pošta.

Dva načina razkrivanja

Način prikaza dejanskega URL-ja izberete pod Razkrij URL na strani z nastavitvami:

V vrstici — dejanski URL je prikazan v svoji vrstici, tik nad besedilom povezave. To je privzeto.
V opisu povezave (title) — dejanski URL je postavljen v opis povezave, tako da se pojavi, ko z miško zapeljete čez povezavo.

Označevanje neujemanj

Kadar se gostitelj, naveden v vidnem besedilu povezave, ne ujema z gostiteljem, na katerega povezava dejansko kaže, Reveal URLs to označi kot neujemanje. Primerjava se opravi na registrabilni domeni, tako da pošten poddomen, kot je mail.example.com za example.com, ni označen, medtem ko je podoben, kot je paypa1.com za paypal.com, označen.

V načinu v vrstici je neujemanje prikazano v vaši izbrani barvi neujemanja in krepko.
V načinu opis (title) je poleg povezave dodana značilna oznaka ⚠ URL mismatch.

To nadzirata dve povezani nastavitvi:

Označi neujemajoče povezave vklopi ali izklopi poudarjanje neujemanj.
Označi samo neujemajoče povezave poštene povezave pusti povsem nedotaknjene, tako da so razkrite le sumljive.

Gumb v orodni vrstici

V Chromu, Edgeu, Operi, Firefoxu in Thunderbirdu je ikona Reveal URLs v orodni vrstici hitro stikalo za vklop/izklop — kliknite nanjo, da preklopite anotacijo. Ko je razširitev izklopljena, se na ikoni prikaže oznaka OFF, njen opis pa vam pove, ali jo bo klik vklopil ali izklopil. V brskalnikih sprememba začne veljati v vseh odprtih zavihkih hkrati; v Thunderbirdu velja za naslednje sporočilo, ki ga odprete.

(V Thunderbirdu gumb prikazuje samo svojo ikono, zato ostane kompakten v enotni orodni vrstici. Reveal URLs lahko vklopite in izklopite tudi s stikalom Omogoči na strani z nastavitvami.)

Stran z nastavitvami

Stran z nastavitvami vsebuje vse možnosti. Odprite jo s strani razširitev vašega brskalnika (na primer Details → Extension options) ali pa se odpre samodejno ob prvi namestitvi.

Omogoči Reveal URLs — glavno stikalo za vklop/izklop, čisto na vrhu strani. Začne veljati takoj, brez shranjevanja preostalega obrazca.
Jezik prikaza — izberite jezik, v katerem je prikazana stran z nastavitvami. Privzeto sledi jeziku vašega brskalnika in se povrne na angleščino; iz seznama izberite drugega, da ga preglasite. Vaša izbira začne veljati takoj, je zapomnjena za naslednjič in je shranjena le na tej napravi (nikoli ne spremeni preostalih vaših nastavitev).
Razkrij URL — izberite način v vrstici ali opisu (title) (glejte zgoraj).
Označi neujemajoče povezave — vklopite ali izklopite poudarjanje neujemanj.
Barva neujemanja — barva CSS, uporabljena za označeno povezavo (na primer red, #cc0000 ali rgb(200, 0, 0)). Privzeta je rdeča.
Barva ujemanja — barva razkritega URL-ja na poštenih (neujemajočih) povezavah (na primer black ali #1a1a1a). Privzeta je nevtralno zelo temno siva (#1a1a1a), izbrana tako, da barva ne namiguje, da je bila povezava preverjena.
Označi samo neujemajoče povezave — poštene povezave pustite nedotaknjene.
Prezri te gostitelje — seznam imen gostiteljev, ki jih je treba povsem preskočiti, enega na vrstico. Poddomene navedenega gostitelja se prav tako preskočijo.
Največja prikazana dolžina URL-ja — dolgi URL-ji se prek tega števila znakov skrajšajo, pri čemer gostitelj ostane viden. Dovoljen razpon: 20 do 2000.
Velikost/debelina pisave razkritega URL-ja in Velikost/debelina pisave opozorilne oznake — neobvezni tipografski preglasi; pustite prazno, da ohranite privzete vrednosti.

Razen glavnega stikala Omogoči in kontrolnikov Aktivna spletna mesta (ki začnejo veljati takoj) se spremembe shranijo z gumbom Shrani nastavitve.

Aktivna spletna mesta — dodajanje lastne spletne pošte

Razdelek Aktivna spletna mesta na vrhu strani z nastavitvami navaja strani, na katerih se izvaja Reveal URLs, in vsebnik, ki vsebuje telo posameznega sporočila.

Vsaka vrstica prikazuje:

ujemalni vzorec spletnega mesta (na primer https://mail.example.com/*);
preklop Omogočeno;
izbirnik telesa sporočila (izbirnik CSS za vsebnik, ki ga Reveal URLs označuje), ki ga lahko urejate;
preklop Podokviri za spletna mesta, katerih telo sporočila je upodobljeno znotraj iframe;
gumb Odstrani (samo za vaša lastna spletna mesta).

Vgrajene ponudnike (Gmail, Outlook in Proton) je mogoče izklopiti in preusmeriti, ni pa jih mogoče odstraniti.

Za dodajanje lastnega spletnega mesta s pošto:

Pod Dodaj spletno mesto vnesite Ujemalni URL — ujemalni vzorec, kot je https://mail.example.com/*.
Vnesite Izbirnik telesa sporočila — izbirnik CSS za vsebnik, ki vsebuje telo sporočila, na primer .message-body.
Če je telo sporočila upodobljeno znotraj podokvira, obkljukajte Izvajaj tudi v podokvirih.
Kliknite Dodaj spletno mesto. Vaš brskalnik bo zahteval dovoljenje za dostop do tega spletnega mesta; dodelite ga. Spletno mesto se doda šele, ko dodelite dovoljenje.

Spremembe tukaj začnejo veljati takoj. Odstranitev spletnega mesta, ki ste ga dodali, prav tako prekliče njegovo dovoljenje, tako da Reveal URLs preneha dostopati do njega.

Thunderbird (in drugi e-poštni odjemalci). Thunderbird že prikaže vsako sporočilo, ki ga berete, ne glede na ponudnika, zato ne potrebuje seznama po gostiteljih. Razdelek Aktivna spletna mesta zato ni prikazan na strani z nastavitvami Thunderbirda — pojavijo se le glavno stikalo, jezik prikaza, način razkrivanja, barve, pisave in seznam za prezrtje. Kakršna koli konfiguracija aktivnih spletnih mest, ki ste jo morda nastavili v brskalniku, ostane nedotaknjena: shranjevanje nastavitev Thunderbirda je nikoli ne izbriše.

Dodatka za Outlook in Gmail

Poleg razširitve za brskalnik in dodatka za Thunderbird je Reveal URLs na voljo kot domači dodatek za dve poštni aplikaciji, ki ju razširitev za brskalnik ne more doseči: dodatek za Outlook in dodatek za Gmail. Oba uporabljata isto zaznavanje povezav kot razširitev, zato razkrivata iste URL-je in označujeta iste podobne gostitelje.

Edina razlika je v tem, kako prikazujeta svoje ugotovitve. Razširitev za brskalnik označuje povezave na mestu — obarva URL nad ali poleg vsake povezave. Ogrodji Outlooka in Gmaila dodatku ne dovolita spreminjanja upodobljenega sporočila, zato namesto tega vsak dodatek prikaže stransko okno (Outlook) ali kartico (Gmail) s seznamom najdenih povezav. Za vsako povezavo prikaže vidno besedilo, ciljni URL in registrabilni gostitelja, neujemanje pa označi, kadar vidno besedilo navaja drugo registrabilno domeno, kot je tista, na katero povezava dejansko kaže.

Dodatek za Outlook — opravilno podokno, ki prebere sporočilo, ki ga imate odprto, in ga analizira na vaši lastni napravi; nobena e-pošta ali podatki sporočila se nikamor ne pošljejo. Koda njegovega opravilnega podokna (HTML, JavaScript, CSS in ikone) se nalaga s https://www.reveal-urls.eu prek HTTPS, kot se zgodi, ko odprete katero koli spletno stran. Doseže Outlook na spletu, v sistemu Windows, na Macu, v sistemu iOS in Android ter Outlook.com.
Dodatek za Gmail — kartica v Gmailovi stranski vrstici. Odprite sporočilo, nato kliknite ikono Reveal URLs v desni stranski vrstici, da vidite njegove povezave: Gmail kartice ne odpre sam od sebe, če pa pustite podokno odprto, se osveži, ko se premikate med sporočili. URL vsake povezave je prikazan v nevtralno temno sivi za pošteno povezavo in rdeči za podobno. Doseže Gmail na spletu, v sistemu Android in iOS. V nasprotju z drugimi oblikami se dodatek za Gmail izvaja na Googlovih strežnikih (tako delujejo Gmailovi dodatki): sporočilo, ki ga odprete, se tam prebere in preveri vsakič, ko ga odprete, in se ne obdrži. Glejte pravilnik o zasebnosti za to, do česa vsaka oblika dostopa in kaj shranjuje.

Oba dodatka bosta distribuirana prek svojih trgovin z aplikacijami — dodatek za Outlook prek Microsoft AppSource, dodatek za Gmail prek Google Workspace Marketplace. Objava je v pripravi; neposredne namestitvene povezave bodo dodane tukaj, ko bo vsaka objava na voljo.

Jeziki

Reveal URLs je na voljo v angleščini in mnogih drugih jezikih.

Stran z nastavitvami samodejno sledi jeziku vašega brskalnika in se povrne na angleščino, kadar vaš jezik ni med zgornjimi. Kadar koli jo lahko preglasite s preklopnikom Jezik prikaza blizu vrha strani; vaša izbira je zapomnjena na tej napravi (glejte Stran z nastavitvami).
To spletno mesto (domača stran in te dokumentacijske strani) prav tako zazna jezik vašega brskalnika in ponuja preklopnik jezika v glavi. Priročnik in strani o zasebnosti so na voljo prevedeni; kadar prevoda za stran še ni, je prikazana v angleščini.

Neangleško besedilo je strojno prevedeno in čaka na pregled človeka, zato se lahko kdaj kakšna fraza bere okorno; pomen naj bi ustrezal angleškemu izvirniku. Če opazite napačen prevod, prosimo, odprite prijavo na sledilniku težav Codeberg.

Zasebnost

Reveal URLs ne pošlje nobenih vaših e-poštnih podatkov ali podatkov sporočil nam ali kateri koli tretji osebi, v nobeni od svojih oblik — ni analitike in ni sledenja. Kako in kje se delo dogaja, je odvisno od oblike:

Razširitev za brskalnik in dodatek za Thunderbird delujeta povsem na vaši lastni napravi in ne prenašata ničesar: preberejo besedilo povezave, URL-je in barve strani, ko se stran upodablja, jih nikoli ne shranjujejo ali pošiljajo.
Dodatek za Outlook analizira odprto sporočilo na vaši lastni napravi in nikamor ne pošlje nobene e-pošte ali podatkov sporočila; koda njegovega opravilnega podokna (HTML, JavaScript, CSS in ikone) se nalaga s https://www.reveal-urls.eu prek HTTPS, kot se zgodi, ko odprete katero koli spletno stran.
Dodatek za Gmail se izvaja na Googlovih lastnih strežnikih (tako delujejo Gmailovi dodatki): odprto sporočilo se tam prebere in preveri vsakič, ko ga odprete, in se ne obdrži.

Edino, kar se shrani, so vaše lastne nastavitve (kot so omogočeno/onemogočeno, način razkrivanja, barve, velikosti pisave, vaš seznam za prezrtje in katera koli spletna mesta, ki ste jih dodali), shranjene v shrambi vašega brskalnika, Outlooka ali Googla za posameznega uporabnika in nikoli poslane nam.

Glejte pravilnik o zasebnosti za vse podrobnosti.

Odpravljanje težav

Povezava se ne razkrije.

Preverite, ali je Reveal URLs vklopljen — ikona v orodni vrstici ne sme prikazovati oznake OFF, stikalo Omogoči Reveal URLs na strani z nastavitvami pa mora biti vklopljeno.
Preverite, ali je spletno mesto pokrito. Vgrajeni ponudniki (Gmail, Outlook, Proton) delujejo takoj; vsako drugo spletno pošto je treba dodati pod Aktivna spletna mesta z njenim ujemalnim URL-jem in izbirnikom telesa sporočila.
Preverite izbirnik telesa sporočila. Če se ne ujema z vsebnikom, ki vsebuje telo sporočila, povezave znotraj tega vsebnika ne bodo razkrite.
Upoštevajte, da so povezave do sidrišč znotraj strani in povezave, ki uporabljajo sheme, ki niso http/https (kot je mailto:), namerno preskočene — prav tako gostitelji na vašem seznamu Prezri te gostitelje.

Vgrajeni ponudnik je po preoblikovanju prenehal delovati.

Ponudniki spletne pošte občasno spremenijo oznake svoje strani. Če se izbirnik vgrajenega ponudnika po taki spremembi ne ujema več, ga lahko popravite sami: v Aktivnih spletnih mestih uredite izbirnik telesa sporočila tega ponudnika na nov vsebnik.

URL v opisu se ne prikaže.

V načinu opis (title) je dejanski URL postavljen v opis povezave, tako da se pojavi le, ko z miško zapeljete čez povezavo. Če bi raje videli URL brez postavitve miške, preklopite Razkrij URL na način v vrstici.

Licenca in vir

Reveal URLs je prosta programska oprema, licencirana pod GNU Affero General Public License v3.0 (AGPL-3.0-only).

Izvorna koda: https://codeberg.org/Magentron/reveal-urls
Tehnični pregled: Arhitektura
Nadaljnje branje o phishingu povezav: Email link phishing: your app should always show the URL