Reveal URLs

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 — Uživatelská příručka

Reveal URLs je malé rozšíření prohlížeče (a doplněk pro Thunderbird), které vám ukáže, kam odkaz ve vašem e-mailu skutečně vede, takže dokážete rozpoznat phishingový odkaz dřív, než na něj kliknete.

Tato příručka vysvětluje, jak Reveal URLs nainstalovat a jak jej používat. Pro časté otázky viz FAQ; pro způsob nakládání s vašimi daty viz zásady ochrany soukromí; technický přehled nabízí přehled architektury.

Našli jste chybu, odkaz, který byl označen chybně (nebo přehlédnut), nebo webmailového hostitele, který by měl být podporován? Nahlaste to prosím na issue trackeru na Codebergu.

Obsah

Co dělá a proč

Phishingový e-mail skrývá nepřátelský cíl za důvěryhodně vypadající text odkazu. Někdy jde o napodobeninu hostitele: text zní paypal.com, zatímco odkaz míří na paypa1.com. Často je to rafinovanější, s přesměrováním přes sledovací prvek nebo přesměrovač, takže místo, kam se dostanete, se vůbec nepodobá značce uvedené v textu.

Phishingový e-mail, který se vydává za poštovní službu, tvrdí, že zásilka je zadržena, dokud nebudou zaplaceny nezaplacené celní poplatky, a vyzývá k platbě tlačítkem „Přejít na platbu“. Reveal URLs ukazuje, že tlačítko nevede na tuto poštovní službu, ale na parcel-pay.custom.co.xa, nesouvisející web, a tím odhaluje zprávu jako podvod.
Reveal URLs odhaluje tlačítko „Přejít na platbu“: vede na parcel-pay.custom.co.xa, ne na poštovní službu, kterou napodobuje.

Poznámka: Tento snímek obrazovky zobrazuje podvodný phishingový e-mail vydávající se za poštovní službu. Napodobovaná služba není spojena s Reveal URLs ani jej nepodporuje.

Reveal URLs čte každý odkaz ve zprávě, kterou právě čtete, a zobrazuje vám URL, na kterou míří. V rozšíření prohlížeče a Thunderbirdu označuje zavádějící webové, e-mailové, telefonní a jiné odkazy, takže je rozdíl zřejmý dřív, než kliknete.

Reveal URLs odhaluje a označuje; neprověřuje. Nesleduje přesměrování: odkaz, který vede přes sledovač nebo přesměrovač, se zobrazí jako URL přesměrovače, kterou skutečně uvádí; Reveal URLs nemůže poznat, kam toto přesměrování nakonec vede. U odkazu bez varování nebyl zjištěn žádný relevantní nesoulad, nikoli potvrzen jako bezpečný, proto si přečtěte odhalenou URL, než odkazu důvěřujete, i když není nic označeno. Abyste na to pamatovali, odhalená URL u neoznačeného odkazu se zobrazuje v jantarové barvě „ke kontrole“ místo uklidňující zelené.

Zpráva v Gmailu s aktivním Reveal URLs: klamavý odkaz je označen červeně se sledovací URL, na kterou míří, zobrazenou nad textem odkazu, zatímco URL odkazu bez nesouladu je zobrazena bez varování.

Poznámka: e-mailové adresy, adresy URL a jména na tomto snímku obrazovky byly kvůli soukromí zakryty hvězdičkami.

V rozšíření prohlížeče a v doplňku pro Thunderbird se vše odehrává ve vašem vlastním zařízení a nic se nepřenáší. Ve všech formách Reveal URLs neposílá žádná vaše e-mailová data nám ani žádné třetí straně — neexistuje žádná analytika ani sledování. (Formy se liší v tom, kde běží a jak je obsluhován kód podokna Outlooku; viz oddíl Soukromí a zásady ochrany soukromí pro úplné podrobnosti.)

Podporované prohlížeče a e-mailové aplikace

Reveal URLs běží na:

Webové prohlížeče:

Poštovní aplikace:

Na cílech prohlížeče Reveal URLs anotuje odkazy ve vašem webmailu. V Thunderbirdu anotuje odkazy v e-mailu, který právě čtete, přímo v e-mailovém klientovi.

Instalace

Z obchodu vašeho prohlížeče nebo e-mailového klienta (doporučeno)

Nainstalujte Reveal URLs z obchodu pro svůj prohlížeč nebo e-mailového klienta. Všechny nabídky jsou nyní dostupné; Opera používá sestavení pro Chrome.

Webové prohlížeče:

Poštovní aplikace:

Načtení vlastního sestavení (vývojáři a rané testování)

Pokud jste Reveal URLs sestavili ze zdrojového kódu, můžete rozbalené sestavení načíst přímo. Každý cíl se sestavuje pomocí příkazu make a vzniká v adresáři dist/<target>/:

make build-chrome        # vytvoří dist/chrome
make build-edge          # vytvoří dist/edge
make build-firefox       # vytvoří dist/firefox
make build-gmail         # vytvoří dist/gmail
make build-opera         # vytvoří dist/opera
make build-outlook       # vytvoří dist/outlook
make build-safari        # vytvoří dist/safari
make build-thunderbird   # vytvoří dist/thunderbird

Poté načtěte výslednou složku:

Rozšíření Safari, doplněk Outlook a doplněk Gmail se nenačítají jako rozbalená rozšíření prohlížeče. Sestavte je jako výše a poté:

make deploy-gmail        # nasadí doplněk Gmail do Apps Script
make safari-xcode        # sestaví projekt Safari Xcode, poté jej spusťte
                         # z nabídky Develop v Safari (macOS)
                         # Outlook: načtěte dist/outlook jako sideload

Stránka nastavení se otevře automaticky při první instalaci rozšíření.

Používání

Rovnou po instalaci Reveal URLs anotuje odkazy ve zprávách u vestavěných poskytovatelů — bez jakéhokoli nastavování:

Anotace je omezena na tělo zprávy, takže vlastní rozhraní aplikace — její postranní panel, okno pro psaní a panely nástrojů — zůstává nedotčené. V Thunderbirdu je pokryt celý vykreslený e-mail.

Reveal URLs anotující zprávu v Gmailu: URL každého odkazu je zobrazena na vlastním řádku nad textem odkazu, s neshodným sledovacím odkazem označeným červeně a odkazem bez nesouladu zobrazeným bez varování.

Poznámka: e-mailové adresy, adresy URL a jména na tomto snímku obrazovky byly kvůli soukromí zakryty hvězdičkami.

Jak se skutečná URL zobrazuje

Skutečná URL každého odkazu se zobrazuje na vlastním řádku, těsně nad textem odkazu. Je také umístěna v popisku odkazu (title), takže je úplná URL vždy k dispozici, když nad odkaz najedete kurzorem.

Zvýraznění neshod

U webových odkazů Reveal URLs porovnává URL nebo názvy hostitelů ve viditelném textu odkazu s URL, na kterou míří. Porovnání se provádí na registrovatelné doméně, takže poddoména bez nesouladu jako mail.example.com pro example.com se neoznačí, zatímco napodobenina jako paypa1.com pro paypal.com ano. Rozšíření prohlížeče a Thunderbird kontrolují také e-mailové, telefonní a neprůhledné odkazy; odkazy javascript:, data: a vbscript: se označují vždy.

Kontrola zohledňuje pouze URL, kterou uvádí samotný odkaz; přesměrování se nikdy nesledují, takže odkaz přes sledovač nebo přesměrovač se porovnává jako jeho URL, nikoli jako stránka, na kterou nakonec vede.

Neshoda se zobrazuje ve vámi zvolené barvě neshody a tučně.

Toto řídí dvě související nastavení:

Stránka nastavení: volič režimu „Zobrazit URL“, přepínač „Zvýraznit neshodující se odkazy“ a pole barvy neshody a barvy bez nesouladu.

Tlačítko na panelu nástrojů

V Chromu, Edgi, Opeře, Firefoxu a Thunderbirdu je ikona Reveal URLs na nástrojové liště rychlý přepínač zapnuto/vypnuto — kliknutím přepnete anotaci. Když je rozšíření vypnuté, na ikoně se objeví odznak OFF a jeho popisek vám řekne, zda jej kliknutí zapne, nebo vypne. V prohlížečích se změna projeví ve všech otevřených kartách najednou; v Thunderbirdu se použije na další zprávu, kterou otevřete.

Když je Reveal URLs zapnutý, ikona na panelu nástrojů prohlížeče vám také pro každou kartu sděluje, co našla na aktuální stránce. Pokud stránka obsahuje nějaké neshodné (podobně vypadající) odkazy, ikona zobrazí tento počet na červeném odznaku; pokud stránka obsahuje odkazy, ale žádný z nich není neshodný, zobrazí celkový počet analyzovaných odkazů na šedém odznaku; stránka bez analyzovatelných odkazů (a jakákoli stránka, na kterou rozšíření nepůsobí) nezobrazuje žádný počet. Každá karta si udržuje vlastní odznak, takže přepnutí mezi kartami aktualizuje číslo a odchod ze stránky nebo zavření karty jej vymaže. (Počty nad 99 se zobrazují jako 99+.)

Odznak ve svých třech stavech (vykresluje jej prohlížeč, takže přesné umístění se mírně liší podle prohlížeče): červený počet neshod, šedý počet analyzovaných odkazů a odznak OFF, když je rozšíření vypnuté; jeho logo je také tlumeně světle šedé. Na stránce, kde je rozšíření zapnuté, ale není aktivní, není žádný odznak; chybějící odznak OFF odlišuje stejné tlumené logo od vypnutého stavu.

Tyto ilustrace nezobrazují každý případ bez odznaku; aktivní stránka bez analyzovatelných odkazů si zachová normálně zbarvenou ikonu.

Ikona na panelu nástrojů zobrazující červený odznak s počtem neshodných odkazů na aktuální stránce Ikona na panelu nástrojů zobrazující šedý odznak s počtem analyzovaných odkazů na aktuální stránce Ikona na panelu nástrojů s tlumeným světle šedým logem bez odznaku, když povolené rozšíření není na této stránce aktivní Ikona na panelu nástrojů zobrazující červený odznak OFF, když je rozšíření vypnuté

(V Thunderbirdu tlačítko zobrazuje jen svou ikonu, takže zůstává kompaktní v sjednocené nástrojové liště. Reveal URLs můžete také zapínat a vypínat přepínačem Povolit na stránce nastavení.)

Stránka nastavení

Stránka nastavení obsahuje všechny možnosti. Otevřete ji ze stránky rozšíření svého prohlížeče (například Podrobnosti → Možnosti rozšíření), nebo se otevře automaticky při první instalaci.

Kromě hlavního přepínače Povolit a ovládacích prvků Aktivní weby (které se projeví okamžitě) se změny ukládají tlačítkem Uložit nastavení.

Spodní nastavení: seznam „Ignorovat tyto hostitele“, maximální zobrazená délka URL a volitelná pole velikosti a tloušťky písma zobrazené URL, nad tlačítkem „Uložit nastavení“.

Aktivní weby — přidání vlastního webmailu

Oddíl Aktivní weby, v horní části stránky nastavení, uvádí stránky, na kterých Reveal URLs běží. Nyní zůstává stále stejně vysoký: v rozbalovací nabídce si vyberte jeden web a v panelu pod ní upravujte jen nastavení tohoto webu.

Horní část stránky nastavení: hlavní přepínač „Povolit Reveal URLs“ a oddíl „Active sites“, s rozbalovací nabídkou „Active site“ nad jedním editorem vybraného webu, který zobrazuje match pattern, přepínač „Enabled“, přepínač „Sub-frames“ a jeho message-body selector.

Rozbalovací nabídka zobrazuje jednu položku pro každé pravidlo webu:

Editor vybraného webu zobrazuje:

Vestavěné poskytovatele (FastMail, Gmail, Outlook Live, Outlook 365, Proton, Tuta, Yahoo a Zoho) lze vypnout a přesměrovat, ale nelze je odstranit. Jejich názvy lze zde také přejmenovat; vymazání názvu vestavěného poskytovatele obnoví jeho výchozí přívětivý název.

Chcete-li přidat vlastní webmailový web:

  1. Pod Přidat web zadejte URL shody — vzor shody jako například https://mail.example.com/*.
  2. Volitelně zadejte Name pro rozbalovací nabídku. Když jej necháte prázdný, použije se match URL.
  3. Zadejte Message-body selector — CSS selektor pro kontejner, který obsahuje tělo zprávy, například .message-body.
  4. Pokud je tělo zprávy vykresleno uvnitř podrámce, zaškrtněte Also run inside sub-frames.
  5. Klikněte na Add site. Váš prohlížeč požádá o oprávnění k přístupu na tento web; udělte jej. Web se přidá až poté, co oprávnění udělíte.

Změny zde se projeví okamžitě. Odstranění webu, který jste přidali, také odvolá jeho oprávnění, takže Reveal URLs k němu přestane přistupovat. Chcete-li změnit match URL webu, odstraňte jej a přidejte znovu: match zůstává jen pro čtení, protože je identitou pravidla.

Thunderbird (a další e-mailoví klienti). Thunderbird již zobrazuje každou zprávu, kterou čtete, ať už u kteréhokoli poskytovatele, takže nepotřebuje seznam podle hostitelů. Oddíl Aktivní weby se proto na stránce nastavení Thunderbirdu nezobrazuje — objeví se pouze hlavní přepínač, jazyk zobrazení, barvy, písma a seznam ignorovaných. Jakékoli nastavení aktivních webů, které jste mohli nastavit v prohlížeči, zůstává nedotčeno: uložení nastavení Thunderbirdu jej nikdy nevymaže.

Doplňky pro Outlook a Gmail

Vedle rozšíření prohlížeče a doplňku pro Thunderbird přichází Reveal URLs jako nativní doplněk pro dvě poštovní aplikace, na které rozšíření prohlížeče nedosáhne: doplněk pro Outlook a doplněk pro Gmail. Oba používají stejnou detekci odkazů jako rozšíření, takže odhalují stejné URL a označují stejné napodobené hostitele.

Jediný rozdíl je v tom, jak zobrazují svá zjištění. Rozšíření prohlížeče anotuje odkazy na místě — obarvuje URL nad každým odkazem nebo vedle něj. Frameworky Outlooku a Gmailu neumožňují doplňku měnit vykreslenou zprávu, takže místo toho každý doplněk zobrazuje postranní panel (Outlook) nebo kartu (Gmail) se seznamem nalezených odkazů. U každého odkazu http/https zobrazuje viditelný text a cílovou URL a označuje neshodu pouze tehdy, když viditelný text uvádí URL nebo název hostitele, jehož registrovatelná doména neodpovídá cíli odkazu.

Doplněk pro Gmail je nyní k dispozici přes Google Workspace Marketplace.

Jazyky

Reveal URLs je k dispozici v angličtině a mnoha dalších jazycích.

Text mimo angličtinu je strojově přeložený a čeká na lidskou revizi, takže se fráze může občas číst neobratně; význam má odpovídat anglickému originálu. Pokud narazíte na chybný překlad, otevřete prosím issue na issue trackeru na Codebergu.

Soukromí

Reveal URLs neposílá žádná vaše e-mailová ani zprávová data nám ani žádné třetí straně, v žádné ze svých forem — neexistuje žádná analytika ani sledování. Jak a kde se práce odehrává, závisí na formě:

Jediné, co se ukládá, jsou vaše vlastní nastavení (například povoleno/zakázáno, režim zobrazení, barvy, velikosti písma, váš seznam ignorovaných a jakékoli weby, které jste přidali), uchovávaná v úložišti vašeho prohlížeče, Outlooku nebo Googlu pro jednotlivé uživatele a nikdy se neposílají nám.

Viz zásady ochrany soukromí pro úplné podrobnosti.

Řešení potíží

Odkaz se neodhaluje.

Vestavěný poskytovatel po přepracování přestal fungovat.

Poskytovatelé webmailu čas od času mění značkování svých stránek. Pokud selektor vestavěného poskytovatele po takové změně již neodpovídá, můžete jej opravit sami: v Aktivních webech upravte selektor těla zprávy tohoto poskytovatele na nový kontejner.

Licence a zdrojový kód

Reveal URLs je svobodný software, licencovaný pod GNU Affero General Public License v3.0 (AGPL-3.0-only).

Poznámky k Safari

Safari zobrazuje odznak jen při neshodě odkazů; nemá šedý počet bezpečné stránky. Nastavení znovu otevřete z nabídky po kliknutí pravým tlačítkem Reveal URLs — settings, místo načítání zastaralé karty nastavení.