Reveal URLs — Používateľská príručka
Reveal URLs je malé rozšírenie prehliadača (a doplnok pre Thunderbird), ktoré vám ukáže, kam odkaz vo vašom e-maile skutočne vedie, aby ste rozpoznali phishingový odkaz skôr, než naň kliknete.
Táto príručka vysvetľuje, ako Reveal URLs nainštalovať a ako ho používať. To, ako sa zaobchádza s vašimi údajmi, nájdete v zásadách ochrany súkromia; technický prehľad o tom, ako je rozšírenie postavené, nájdete v prehľade architektúry.
Našli ste chybu, odkaz, ktorý bol nesprávne označený (alebo prehliadnutý), alebo webmailového hostiteľa, ktorý by mal byť podporovaný? Nahláste to prosím na nástroji na sledovanie problémov Codeberg.
Obsah
- Čo to robí a prečo
- Podporované prehliadače a poštový klient
- Inštalácia
- Používanie
- Doplnky Outlook a Gmail
- Jazyky
- Súkromie
- Riešenie problémov
- Licencia a zdrojový kód
Čo to robí a prečo
Phishingový e-mail skrýva nepriateľský cieľ za dôveryhodne vyzerajúci text odkazu.
Niekedy ide o napodobeninu hostiteľa: text znie paypal.com, zatiaľ čo odkaz
smeruje na paypa1.com. Často je to nenápadnejšie a smeruje cez sledovač alebo
presmerovač, takže miesto, kam sa dostanete, sa vôbec nepodobá značke uvedenej v texte.

parcel-pay.custom.co.xa, nie na Slovenskú poštu.Poznámka: Táto snímka obrazovky zobrazuje podvodný phishingový e-mail vydávajúci sa za Slovenskú poštu. Slovenská pošta nie je prepojená s Reveal URLs ani ho nepodporuje.
Reveal URLs číta každý odkaz v správe, ktorú čítate, a zobrazuje vám URL, na ktorú smeruje. Keď sa hostiteľ uvedený v texte odkazu nezhoduje s hostiteľom, na ktorý odkaz skutočne smeruje, Reveal URLs ho označí, takže nezhoda je zjavná skôr, než kliknete.
V rozšírení prehliadača a v doplnku pre Thunderbird sa všetko deje vo vašom vlastnom zariadení a nič sa neprenáša. Vo všetkých podobách Reveal URLs neposiela žiadne vaše e-mailové údaje nám ani žiadnej tretej strane — neexistujú žiadne analytické nástroje ani sledovanie. (Podoby sa líšia v tom, kde bežia a ako sa poskytuje kód panela Outlooku; pozri časť Súkromie a zásady ochrany súkromia pre všetky podrobnosti.)
Podporované prehliadače a poštový klient
Reveal URLs beží na:
- Google Chrome
- Microsoft Edge
- Opera
- Mozilla Firefox
- Mozilla Thunderbird (desktopový poštový klient)
Zostava pre Safari zatiaľ nie je vydaná; plánuje sa v neskoršej fáze.
Na cieľových prehliadačoch Reveal URLs anotuje odkazy vo vašom webmaile. V Thunderbirde anotuje odkazy v e-maile, ktorý čítate, priamo v poštovom klientovi.
Inštalácia
Z obchodu vášho prehliadača alebo poštového klienta (odporúčané)
Nainštalujte Reveal URLs z obchodu pre váš prehliadač alebo poštového klienta. Vydania pre Chrome, Edge, Firefox a Thunderbird sú aktívne; Opera používa zostavu pre Chrome a samostatné vydanie pre Operu je ešte na ceste:
- Chrome — Chrome Web Store
- Edge — Microsoft Edge Add-ons
- Opera — nainštalujte verziu pre Chrome z Chrome Web Store; samostatné vydanie pre Operu je čoskoro
- Firefox — Firefox Add-ons (AMO)
- Thunderbird — Thunderbird Add-ons (ATN)
Načítanie vlastnej zostavy (vývojári a rané testovanie)
Ak ste Reveal URLs zostavili zo zdrojového kódu, môžete rozbalenú zostavu načítať
priamo. Každý cieľ sa zostavuje príkazom make a vytvára sa v
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
Potom načítajte výsledný priečinok:
- Chrome — otvorte
chrome://extensions, zapnite Režim pre vývojárov, kliknite na Načítať rozbalené a vybertedist/chrome. - Edge — otvorte
edge://extensions, zapnite Režim pre vývojárov, kliknite na Načítať rozbalené a vybertedist/edge. - Opera — otvorte
opera://extensions, zapnite Režim pre vývojárov, kliknite na Načítať rozbalené a vybertedist/opera. - Firefox — otvorte
about:debugging, zvoľte Tento Firefox, kliknite na Načítať dočasný doplnok a vyberte ľubovoľný súbor vnútridist/firefox(napríklad jehomanifest.json). Dočasný doplnok sa odstráni po reštarte Firefoxu. - Thunderbird — nainštalujte dočasný doplnok z
dist/thunderbirdrovnakým spôsobom (cez Nástroje → Vývojárske nástroje → Ladiť doplnky → Načítať dočasný doplnok).
Stránka nastavení sa otvorí automaticky pri prvej inštalácii rozšírenia.
Používanie
Bez akéhokoľvek nastavovania Reveal URLs anotuje odkazy v správach na vstavaných poskytovateľoch — nie je potrebné žiadne nastavenie:
- Gmail (
mail.google.com) - Outlook Live (
outlook.live.com) - Outlook na webe / Microsoft 365 (
outlook.office.com) - Proton Mail (
mail.proton.me)
Anotácia je obmedzená na telo správy, takže vlastné rozhranie aplikácie — jej bočný panel, okno na písanie a panely s nástrojmi — zostáva nedotknuté. V Thunderbirde je pokrytý celý vykreslený e-mail.
Dva režimy odhalenia
Zvolíte si, ako sa skutočná URL zobrazí, v položke Odhaliť URL na stránke nastavení:
- V riadku — skutočná URL sa zobrazí na vlastnom riadku, tesne nad textom odkazu. Toto je predvolené.
- V popise odkazu (title) — skutočná URL sa umiestni do popisu odkazu, takže sa objaví, keď na odkaz prejdete ukazovateľom.
Zvýraznenie nezhody
Keď sa hostiteľ uvedený vo viditeľnom texte odkazu nezhoduje s hostiteľom, na
ktorý odkaz skutočne smeruje, Reveal URLs ho označí ako nezhodu. Porovnanie sa
robí na registrovateľnej doméne, takže poctivá poddoména ako mail.example.com
pre example.com sa neoznačí, zatiaľ čo napodobenina ako paypa1.com pre
paypal.com áno.
- V režime v riadku sa nezhoda zobrazí vo vami zvolenej farbe nezhody a tučným písmom.
- V režime popis (title) sa vedľa odkazu pridá výrazný odznak ⚠ URL nezhoda.
Toto ovládajú dve súvisiace nastavenia:
- Zvýrazniť nezhodné odkazy zapína alebo vypína zvýraznenie nezhody.
- Anotovať iba nezhodné odkazy ponecháva poctivé odkazy úplne nedotknuté, takže sa odhalia len tie podozrivé.
Tlačidlo na paneli s nástrojmi
V Chrome, Edgei, Opere, Firefoxe a Thunderbirde je ikona Reveal URLs na paneli nástrojov rýchly prepínač zap./vyp. — kliknite na ňu, aby ste prepli anotáciu. Keď je rozšírenie vypnuté, na ikone sa zobrazí odznak OFF a jeho popis vám povie, či ho kliknutie zapne alebo vypne. V prehliadačoch sa zmena prejaví vo všetkých otvorených kartách naraz; v Thunderbirde sa použije na ďalšiu správu, ktorú otvoríte.
(V Thunderbirde tlačidlo zobrazuje iba svoju ikonu, takže zostáva kompaktné v zjednotenom paneli nástrojov. Reveal URLs môžete zapínať a vypínať aj prepínačom Povoliť na stránke nastavení.)
Stránka nastavení
Stránka nastavení obsahuje všetky možnosti. Otvorte ju zo stránky rozšírení vášho prehliadača (napríklad Podrobnosti → Možnosti rozšírenia), alebo sa otvorí automaticky pri prvej inštalácii.
- Povoliť Reveal URLs — hlavný vypínač úplne na vrchu stránky. Prejaví sa okamžite, bez potreby uloženia zvyšku formulára.
- Jazyk zobrazenia — zvoľte jazyk, v ktorom sa stránka nastavení zobrazuje. Predvolene sleduje jazyk vášho prehliadača a vracia sa k angličtine; iný zvoľte zo zoznamu, aby ste ho prepísali. Vaša voľba sa prejaví ihneď, zapamätá sa na nabudúce a ukladá sa len na tomto zariadení (nikdy nemení zvyšok vašich nastavení).
- Odhaliť URL — zvoľte režim v riadku alebo popis (title) (pozri vyššie).
- Zvýrazniť nezhodné odkazy — zapnite alebo vypnite zvýraznenie nezhody.
- Farba pri nezhode — CSS farba použitá pre označený odkaz (napríklad
red,#cc0000aleborgb(200, 0, 0)). Predvolená je červená. - Farba pri zhode — farba odhalenej URL na poctivých (nezhodných) odkazoch
(napríklad
blackalebo#1a1a1a). Predvolená je neutrálna veľmi tmavá sivá (#1a1a1a), zvolená tak, aby farba nenaznačovala, že odkaz bol skontrolovaný. - Anotovať iba nezhodné odkazy — poctivé odkazy ponechajte nedotknuté.
- Ignorovať týchto hostiteľov — zoznam názvov hostiteľov, ktoré sa úplne preskočia, jeden na riadok. Poddomény uvedeného hostiteľa sa preskočia tiež.
- Maximálna dĺžka zobrazenej URL — dlhé URL sa za týmto počtom znakov skrátia, pričom hostiteľ zostane viditeľný. Povolený rozsah: 20 až 2000.
- Veľkosť / hrúbka písma odhalenej URL a Veľkosť / hrúbka písma výstražného odznaku — voliteľné typografické prepisy; ponechajte prázdne, aby ste zachovali predvolené hodnoty.
Okrem hlavného prepínača Povoliť a ovládacích prvkov Aktívne lokality (ktoré sa uplatnia okamžite) sa zmeny ukladajú tlačidlom Uložiť nastavenia.
Aktívne lokality — pridanie vlastného webmailu
Časť Aktívne lokality na vrchu stránky nastavení uvádza stránky, na ktorých Reveal URLs beží, a kontajner, ktorý obsahuje telo každej správy.
Každý riadok zobrazuje:
- vzor zhody lokality (napríklad
https://mail.example.com/*); - prepínač Povolené;
- selektor tela správy (CSS selektor pre kontajner, ktorý Reveal URLs anotuje), ktorý môžete upraviť;
- prepínač Podrámy pre lokality, ktorých telo správy je vykreslené vnútri prvku iframe;
- tlačidlo Odstrániť (len pre vaše vlastné lokality).
Vstavaných poskytovateľov (Gmail, Outlook a Proton) možno vypnúť a znovu zacieliť, ale nemožno ich odstrániť.
Ak chcete pridať vlastnú webmailovú lokalitu:
- V časti Pridať lokalitu zadajte Zhodnú URL — vzor zhody, ako napríklad
https://mail.example.com/*. - Zadajte Selektor tela správy — CSS selektor pre kontajner, ktorý obsahuje
telo správy, napríklad
.message-body. - Ak je telo správy vykreslené vnútri podrámu, zaškrtnite Spustiť aj v podrámoch.
- Kliknite na Pridať lokalitu. Váš prehliadač si vyžiada povolenie na prístup k danej lokalite; udeľte ho. Lokalita sa pridá až po udelení povolenia.
Zmeny tu sa uplatnia okamžite. Odstránenie lokality, ktorú ste pridali, zároveň zruší jej povolenie, takže Reveal URLs k nej prestane pristupovať.
Thunderbird (a iní poštoví klienti). Thunderbird už zobrazuje každú správu, ktorú čítate, bez ohľadu na poskytovateľa, takže nepotrebuje zoznam podľa hostiteľa. Časť Aktívne lokality sa preto na stránke nastavení Thunderbirdu nezobrazuje — objaví sa len hlavný prepínač, jazyk zobrazenia, režim odhalenia, farby, písma a zoznam ignorovaných. Akékoľvek nastavenie aktívnych lokalít, ktoré ste mohli nastaviť v prehliadači, zostáva nedotknuté: uloženie nastavení Thunderbirdu ho nikdy nevymaže.
Doplnky Outlook a Gmail
Popri rozšírení prehliadača a doplnku pre Thunderbird prichádza Reveal URLs ako natívny doplnok pre dve poštové aplikácie, ku ktorým sa rozšírenie prehliadača nedostane: doplnok pre Outlook a doplnok pre Gmail. Oba používajú rovnakú detekciu odkazov ako rozšírenie, takže odhaľujú rovnaké URL a označujú rovnakých napodobených hostiteľov.
Jediný rozdiel je v tom, ako zobrazujú svoje zistenia. Rozšírenie prehliadača anotuje odkazy priamo na mieste — zafarbí URL nad alebo vedľa každého odkazu. Frameworky Outlooku a Gmailu neumožňujú doplnku meniť vykreslenú správu, takže namiesto toho každý doplnok zobrazí bočný panel (Outlook) alebo kartu (Gmail) so zoznamom odkazov, ktoré našiel. Pri každom odkaze zobrazuje viditeľný text, cieľovú URL a registrovateľného hostiteľa a označí nezhodu, keď viditeľný text uvádza inú registrovateľnú doménu, než na ktorú odkaz skutočne smeruje.
- Doplnok pre Outlook — pracovný panel, ktorý číta správu, ktorú máte otvorenú, a analyzuje ju vo vašom vlastnom zariadení; nikam sa neposielajú žiadne e-mailové ani správové údaje. Jeho kód pracovného panela (HTML, JavaScript, CSS a ikony) sa načítava z https://www.reveal-urls.eu cez HTTPS, ako keď otvoríte ľubovoľnú webovú stránku. Dosahuje Outlook na webe, vo Windowse, na Macu, iOS a Androide a Outlook.com.
- Doplnok pre Gmail — karta v bočnom paneli Gmailu. Otvorte správu a potom kliknite na ikonu Reveal URLs v pravom bočnom paneli, aby ste videli jej odkazy: Gmail kartu sám neotvorí, ale ak necháte panel otvorený, obnovuje sa, keď sa presúvate medzi správami. URL každého odkazu sa zobrazí v neutrálnej tmavej sivej pri poctivom odkaze a červenej pri napodobenine. Dosahuje Gmail na webe, Androide a iOS. Na rozdiel od ostatných podôb doplnok pre Gmail beží na serveroch spoločnosti Google (takto doplnky pre Gmail fungujú): správa, ktorú otvoríte, sa tam číta a kontroluje pri každom otvorení a neuchováva sa. Pozri zásady ochrany súkromia, čo každá podoba sprístupňuje a ukladá.
Oba doplnky budú distribuované cez svoje obchody s aplikáciami — doplnok pre Outlook cez Microsoft AppSource, doplnok pre Gmail cez Google Workspace Marketplace. Publikácia sa pripravuje; priame inštalačné odkazy sem budú pridané, keď bude každé vydanie aktívne.
Jazyky
Reveal URLs je dostupné v angličtine a mnohých ďalších jazykoch.
- Stránka nastavení automaticky sleduje jazyk vášho prehliadača a vracia sa k angličtine, keď váš jazyk nie je jedným z uvedených. Kedykoľvek ho môžete prepísať prepínačom Jazyk zobrazenia blízko vrchu stránky; vaša voľba sa zapamätá na danom zariadení (pozri Stránka nastavení).
- Táto webová stránka (domovská stránka a tieto dokumentačné stránky) tiež zisťuje jazyk vášho prehliadača a ponúka prepínač jazyka v hlavičke. Stránky príručky a súkromia sú dostupné preložené; kde stránka ešte nemá preklad, zobrazuje sa v angličtine.
Text v inom ako anglickom jazyku je strojovo preložený a čaká na ľudskú kontrolu, takže niektorá fráza môže občas znieť nemotorne; význam má zodpovedať anglickému originálu. Ak spozorujete nesprávny preklad, otvorte prosím problém na nástroji na sledovanie problémov Codeberg.
Súkromie
Reveal URLs neposiela žiadne vaše e-mailové ani správové údaje nám ani žiadnej tretej strane, v žiadnej zo svojich podôb — neexistujú žiadne analytické nástroje ani sledovanie. Ako a kde sa práca deje, závisí od podoby:
- Rozšírenie prehliadača a doplnok pre Thunderbird pracujú úplne vo vašom vlastnom zariadení a nič neprenášajú: čítajú text odkazu, URL a farby stránky, keď sa stránka vykresľuje, nikdy ich neukladajú ani neposielajú.
- Doplnok pre Outlook analyzuje otvorenú správu vo vašom vlastnom zariadení a nikam neposiela žiadne e-mailové ani správové údaje; jeho kód pracovného panela (HTML, JavaScript, CSS a ikony) sa načítava z https://www.reveal-urls.eu cez HTTPS, ako keď otvoríte ľubovoľnú webovú stránku.
- Doplnok pre Gmail beží na vlastných serveroch spoločnosti Google (takto doplnky pre Gmail fungujú): otvorená správa sa tam číta a kontroluje pri každom otvorení a neuchováva sa.
Jediné, čo sa ukladá, sú vaše vlastné nastavenia (napríklad povolené/zakázané, režim odhalenia, farby, veľkosti písma, váš zoznam ignorovaných a akékoľvek lokality, ktoré ste pridali), uchovávané v úložisku vášho prehliadača, Outlooku alebo Googlu pre každého používateľa a nikdy sa neposielajú nám.
Pozri zásady ochrany súkromia pre všetky podrobnosti.
Riešenie problémov
Odkaz sa neodhaľuje.
- Skontrolujte, či je Reveal URLs zapnuté — ikona na paneli s nástrojmi nesmie zobrazovať odznak OFF a prepínač Povoliť Reveal URLs na stránke nastavení musí byť zapnutý.
- Skontrolujte, či je lokalita pokrytá. Vstavaní poskytovatelia (Gmail, Outlook, Proton) fungujú hneď; akýkoľvek iný webmail treba pridať v časti Aktívne lokality s jeho zhodnou URL a selektorom tela správy.
- Skontrolujte selektor tela správy. Ak sa nezhoduje s kontajnerom, ktorý obsahuje telo správy, odkazy vnútri tohto kontajnera sa neodhalia.
- Vezmite na vedomie, že odkazy na kotvy v rámci stránky a odkazy používajúce iné
schémy než
http/https(napríkladmailto:) sa zámerne preskakujú — rovnako ako hostitelia na vašom zozname Ignorovať týchto hostiteľov.
Vstavaný poskytovateľ prestal fungovať po prepracovaní.
Poskytovatelia webmailu z času na čas menia značkovanie svojich stránok. Ak sa selektor vstavaného poskytovateľa po takejto zmene už nezhoduje, môžete ho opraviť sami: v časti Aktívne lokality upravte selektor tela správy tohto poskytovateľa na nový kontajner.
Popis URL sa nezobrazuje.
V režime popis (title) sa skutočná URL umiestni do popisu odkazu, takže sa objaví, len keď na odkaz prejdete ukazovateľom. Ak by ste radšej videli URL bez prechádzania ukazovateľom, prepnite Odhaliť URL do režimu v riadku.
Licencia a zdrojový kód
Reveal URLs je slobodný softvér, licencovaný pod GNU Affero General Public License v3.0 (AGPL-3.0-only).
- Zdrojový kód: https://codeberg.org/Magentron/reveal-urls
- Technický prehľad: Architektúra
- Ďalšie čítanie o phishingu odkazov: Email link phishing: your app should always show the URL




