Reveal URLs — Podręcznik użytkownika
Reveal URLs to małe rozszerzenie przeglądarki (oraz dodatek do Thunderbirda), które pokazuje ci, dokąd odnośnik w twojej poczcie naprawdę prowadzi, dzięki czemu możesz rozpoznać link phishingowy, zanim w niego klikniesz.
Ten podręcznik wyjaśnia, jak zainstalować Reveal URLs i jak z niego korzystać. To, jak obchodzimy się z twoimi danymi, opisuje polityka prywatności; techniczny przegląd tego, jak rozszerzenie jest zbudowane, znajdziesz w przeglądzie architektury.
Znalazłeś błąd, odnośnik, który został niesłusznie oznaczony (lub pominięty), albo hosta webmaila, który powinien być obsługiwany? Zgłoś to na trackerze zgłoszeń Codeberg.
Spis treści
- Co robi i dlaczego
- Obsługiwane przeglądarki i klient poczty
- Instalacja
- Korzystanie
- Dodatki do Outlooka i Gmaila
- Języki
- Prywatność
- Rozwiązywanie problemów
- Licencja i kod źródłowy
Co robi i dlaczego
E-mail phishingowy ukrywa wrogie miejsce docelowe za wiarygodnie wyglądającym
tekstem odnośnika. Czasem jest to podobny host: tekst pokazuje paypal.com,
podczas gdy odnośnik prowadzi do paypa1.com. Często jest to subtelniejsze i
przebiega przez narzędzie śledzące lub przekierowanie, więc miejsce, w którym się
znajdziesz, w niczym nie przypomina marki wymienionej w tekście.

parcel-pay.custom.co.xa, a nie do Poczty Polskiej.Uwaga: Ten zrzut ekranu pokazuje oszukańczy e-mail phishingowy podszywający się pod Pocztę Polską. Poczta Polska nie jest powiązana z Reveal URLs i go nie popiera.
Reveal URLs odczytuje każdy odnośnik w wiadomości, którą czytasz, i pokazuje ci adres URL, na który faktycznie wskazuje. Gdy host wymieniony w tekście odnośnika nie zgadza się z tym hostem, Reveal URLs oznacza go, dzięki czemu niezgodność jest oczywista, zanim klikniesz.
W rozszerzeniu przeglądarki oraz dodatku do Thunderbirda wszystko odbywa się na twoim własnym urządzeniu, nic nie przesyłając. We wszystkich formach Reveal URLs nie wysyła żadnych twoich danych e-mailowych do nas ani do żadnej strony trzeciej — nie ma analityki ani śledzenia. (Formy różnią się tym, gdzie działają i jak serwowany jest kod panelu Outlooka; zobacz sekcję Prywatność oraz politykę prywatności, aby poznać wszystkie szczegóły.)
Obsługiwane przeglądarki i klient poczty
Reveal URLs działa na:
- Google Chrome
- Microsoft Edge
- Opera
- Mozilla Firefox
- Mozilla Thunderbird (desktopowy klient poczty)
Wersja dla Safari nie jest jeszcze dostarczana; planowana jest na późniejszą fazę.
Na celach przeglądarkowych Reveal URLs adnotuje odnośniki w twoim webmailu. W Thunderbirdzie adnotuje odnośniki w e-mailu, który czytasz, bezpośrednio w kliencie poczty.
Instalacja
Ze sklepu twojej przeglądarki lub klienta poczty (zalecane)
Zainstaluj Reveal URLs ze sklepu dla swojej przeglądarki lub klienta poczty. Pozycje Chrome, Edge, Firefox i Thunderbird są już dostępne; Opera korzysta z builda Chrome, a dedykowana pozycja Opery jest jeszcze w drodze:
- Chrome — Chrome Web Store
- Edge — Microsoft Edge Add-ons
- Opera — zainstaluj wersję Chrome ze sklepu Chrome Web Store; dedykowana pozycja Opery wkrótce
- Firefox — Firefox Add-ons (AMO)
- Thunderbird — Thunderbird Add-ons (ATN)
Samodzielne ładowanie builda (programiści i wczesne testowanie)
Jeśli zbudowałeś Reveal URLs ze źródeł, możesz załadować rozpakowany build bezpośrednio.
Każdy cel jest budowany poleceniem make i tworzony 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
Następnie załaduj powstały folder:
- Chrome — otwórz
chrome://extensions, włącz Tryb programisty, kliknij Załaduj rozpakowane i wybierzdist/chrome. - Edge — otwórz
edge://extensions, włącz Tryb programisty, kliknij Załaduj rozpakowane i wybierzdist/edge. - Opera — otwórz
opera://extensions, włącz Tryb programisty, kliknij Załaduj rozpakowane i wybierzdist/opera. - Firefox — otwórz
about:debugging, wybierz Ten Firefox, kliknij Załaduj tymczasowy dodatek i wybierz dowolny plik wewnątrzdist/firefox(na przykład jegomanifest.json). Tymczasowy dodatek jest usuwany po ponownym uruchomieniu Firefoksa. - Thunderbird — zainstaluj tymczasowy dodatek z
dist/thunderbirdw ten sam sposób (przez Narzędzia → Narzędzia programistyczne → Debuguj dodatki → Załaduj tymczasowy dodatek).
Strona ustawień otwiera się automatycznie przy pierwszej instalacji rozszerzenia.
Korzystanie
Od razu po instalacji Reveal URLs adnotuje odnośniki w wiadomościach u wbudowanych dostawców — bez żadnej konfiguracji:
- Gmail (
mail.google.com) - Outlook Live (
outlook.live.com) - Outlook w sieci / Microsoft 365 (
outlook.office.com) - Proton Mail (
mail.proton.me)
Adnotacja jest ograniczona do treści wiadomości, więc własny interfejs aplikacji — jej pasek boczny, okno tworzenia wiadomości i paski narzędzi — pozostaje nietknięty. W Thunderbirdzie objęty jest cały wyrenderowany e-mail.
Dwa tryby ujawniania
Wybierasz, jak rzeczywisty URL jest pokazywany, w sekcji Ujawnij URL na stronie ustawień:
- W wierszu — rzeczywisty URL jest pokazywany we własnym wierszu, tuż nad tekstem odnośnika. To ustawienie domyślne.
- W dymku (tytule) odnośnika — rzeczywisty URL jest umieszczany w dymku odnośnika, dzięki czemu pojawia się, gdy najedziesz na odnośnik.
Podświetlanie niezgodności
Gdy host wymieniony w widocznym tekście odnośnika nie zgadza się z hostem, na który
odnośnik faktycznie wskazuje, Reveal URLs oznacza to jako niezgodność. Porównanie odbywa
się na rejestrowalnej domenie, więc uczciwa subdomena, taka jak mail.example.com dla
example.com, nie jest oznaczana, podczas gdy łudząco podobna, taka jak paypa1.com dla
paypal.com, jest.
- W trybie w wierszu niezgodność jest pokazywana w wybranym przez ciebie kolorze niezgodności i pogrubiona.
- W trybie dymka (tytułu) obok odnośnika dodawana jest wyróżniająca się odznaka ⚠ niezgodność URL.
Steruje tym dwa powiązane ustawienia:
- Podświetlaj niezgodne odnośniki włącza lub wyłącza wyróżnienie niezgodności.
- Adnotuj tylko niezgodne odnośniki pozostawia uczciwe odnośniki całkowicie nietknięte, dzięki czemu ujawniane są tylko te podejrzane.
Przycisk na pasku narzędzi
W Chrome, Edge, Operze, Firefoksie i Thunderbirdzie ikona Reveal URLs na pasku narzędzi to szybki przełącznik włącz/wyłącz — kliknij ją, aby przełączyć adnotację. Gdy rozszerzenie jest wyłączone, na ikonie pojawia się odznaka OFF, a jej dymek mówi ci, czy kliknięcie je włączy, czy wyłączy. W przeglądarkach zmiana zaczyna działać we wszystkich otwartych kartach naraz; w Thunderbirdzie dotyczy następnej wiadomości, którą otworzysz.
(W Thunderbirdzie przycisk pokazuje tylko swoją ikonę, więc pozostaje kompaktowy na zunifikowanym pasku narzędzi. Reveal URLs możesz też włączać i wyłączać przełącznikiem Włącz na stronie ustawień.)
Strona ustawień
Strona ustawień zawiera każdą opcję. Otwórz ją ze strony rozszerzeń swojej przeglądarki (na przykład Szczegóły → Opcje rozszerzenia) lub otwiera się automatycznie przy pierwszej instalacji.
- Włącz Reveal URLs — główny przełącznik włącz/wyłącz, na samej górze strony. Wchodzi w życie natychmiast, bez potrzeby zapisywania reszty formularza.
- Język wyświetlania — wybierz język, w którym pokazywana jest strona ustawień. Domyślnie podąża za językiem twojej przeglądarki, z angielskim jako rozwiązaniem awaryjnym; wybierz inny z listy, aby to nadpisać. Twój wybór wchodzi w życie od razu, jest zapamiętywany na następny raz i jest przechowywany tylko na tym urządzeniu (nigdy nie zmienia reszty twoich ustawień).
- Ujawnij URL — wybierz tryb w wierszu lub w dymku (tytule) (zobacz powyżej).
- Podświetlaj niezgodne odnośniki — włącz lub wyłącz wyróżnienie niezgodności.
- Kolor niezgodności — kolor CSS używany dla oznaczonego odnośnika (na przykład
red,#cc0000lubrgb(200, 0, 0)). Domyślny jest czerwony. - Kolor zgodności — kolor ujawnionego URL na uczciwych (niewykazujących niezgodności)
odnośnikach (na przykład
blacklub#1a1a1a). Domyślny jest neutralny, bardzo ciemny szary (#1a1a1a), wybrany tak, aby kolor nie sugerował, że odnośnik został sprawdzony. - Adnotuj tylko niezgodne odnośniki — pozostaw uczciwe odnośniki nietknięte.
- Ignoruj te hosty — lista nazw hostów do całkowitego pominięcia, po jednej w wierszu. Subdomeny wymienionego hosta są również pomijane.
- Maksymalna wyświetlana długość URL — długie URL-e są skracane powyżej tej liczby znaków, z zachowaniem widocznego hosta. Dozwolony zakres: od 20 do 2000.
- Rozmiar / grubość czcionki ujawnionego URL oraz Rozmiar / grubość czcionki odznaki ostrzegawczej — opcjonalne nadpisania typografii; pozostaw puste, aby zachować wartości domyślne.
Poza głównym przełącznikiem Włącz i sterowaniem Aktywnymi witrynami (które są stosowane od razu) zmiany są zapisywane przyciskiem Zapisz ustawienia.
Aktywne witryny — dodawanie własnego webmaila
Sekcja Aktywne witryny, na górze strony ustawień, wymienia strony, na których działa Reveal URLs, oraz kontener mieszczący każdą treść wiadomości.
Każdy wiersz pokazuje:
- wzorzec dopasowania witryny (na przykład
https://mail.example.com/*); - przełącznik Włączone;
- selektor treści wiadomości (selektor CSS dla kontenera, który Reveal URLs adnotuje), który możesz edytować;
- przełącznik Podramki, dla witryn, których treść wiadomości jest renderowana wewnątrz iframe;
- przycisk Usuń (tylko dla twoich własnych witryn).
Wbudowani dostawcy (Gmail, Outlook i Proton) mogą być wyłączeni i przekierowani, ale nie mogą zostać usunięci.
Aby dodać własną witrynę webmaila:
- W sekcji Dodaj witrynę wprowadź URL dopasowania — wzorzec dopasowania, taki jak
https://mail.example.com/*. - Wprowadź Selektor treści wiadomości — selektor CSS dla kontenera, który mieści treść
wiadomości, na przykład
.message-body. - Jeśli treść wiadomości jest renderowana wewnątrz podramki, zaznacz Uruchamiaj również wewnątrz podramek.
- Kliknij Dodaj witrynę. Twoja przeglądarka poprosi o pozwolenie na dostęp do tej witryny; udziel go. Witryna jest dodawana dopiero po udzieleniu pozwolenia.
Zmiany tutaj są stosowane od razu. Usunięcie witryny, którą dodałeś, cofa również jej pozwolenie, więc Reveal URLs przestaje uzyskiwać do niej dostęp.
Thunderbird (i inne klienty poczty). Thunderbird i tak pokazuje każdą czytaną przez ciebie wiadomość, niezależnie od dostawcy, więc nie potrzebuje listy per-host. Sekcja Aktywne witryny nie jest zatem pokazywana na stronie ustawień Thunderbirda — pojawiają się tylko główny przełącznik, język wyświetlania, tryb ujawniania, kolory, czcionki i lista ignorowania. Wszelka konfiguracja aktywnych witryn, którą mogłeś ustawić w przeglądarce, jest zachowywana nietknięta: zapisanie ustawień Thunderbirda nigdy jej nie czyści.
Dodatki do Outlooka i Gmaila
Obok rozszerzenia przeglądarki i dodatku do Thunderbirda Reveal URLs występuje jako natywny dodatek do dwóch aplikacji pocztowych, których rozszerzenie przeglądarki nie jest w stanie objąć: dodatek do Outlooka oraz dodatek do Gmaila. Oba używają tego samego wykrywania odnośników co rozszerzenie, więc ujawniają te same adresy URL i oznaczają te same łudząco podobne hosty.
Jedyna różnica to sposób, w jaki pokazują swoje ustalenia. Rozszerzenie przeglądarki adnotuje odnośniki w miejscu — kolorując URL nad lub obok każdego odnośnika. Frameworki Outlooka i Gmaila nie pozwalają dodatkowi zmieniać wyrenderowanej wiadomości, więc zamiast tego każdy dodatek pokazuje panel boczny (Outlook) lub kartę (Gmail) z listą znalezionych odnośników. Dla każdego odnośnika pokazuje widoczny tekst, docelowy adres URL i rejestrowalnego hosta oraz oznacza niezgodność, gdy widoczny tekst wymienia inną rejestrowalną domenę niż ta, na którą odnośnik faktycznie wskazuje.
- Dodatek do Outlooka — panel zadań, który odczytuje otwartą przez ciebie wiadomość i analizuje ją na twoim własnym urządzeniu; żadne dane e-maila ani wiadomości nie są nigdzie wysyłane. Jego kod panelu zadań (HTML, JavaScript, CSS i ikony) jest ładowany z Codeberg Pages przez HTTPS, tak jak dzieje się to przy otwieraniu dowolnej strony internetowej. Obejmuje Outlooka w sieci, na Windowsie, Macu, iOS i Androidzie oraz Outlook.com.
- Dodatek do Gmaila — karta w pasku bocznym Gmaila. Otwórz wiadomość, a następnie kliknij ikonę Reveal URLs w prawym pasku bocznym, aby zobaczyć jej odnośniki: Gmail nie otwiera karty samodzielnie, ale jeśli zostawisz panel otwarty, odświeża się on, gdy przechodzisz między wiadomościami. Adres URL każdego odnośnika jest pokazywany w neutralnym ciemnym szarym dla uczciwego odnośnika i na czerwono dla łudząco podobnego. Obejmuje Gmaila w sieci, na Androidzie i iOS. W odróżnieniu od pozostałych form dodatek do Gmaila działa na serwerach Google (tak właśnie działają dodatki do Gmaila): otwierana przez ciebie wiadomość jest tam odczytywana i sprawdzana, za każdym razem, gdy ją otwierasz, i nie jest zachowywana. Zobacz politykę prywatności, aby dowiedzieć się, do czego każda forma uzyskuje dostęp i co przechowuje.
Oba dodatki będą rozpowszechniane przez swoje sklepy z aplikacjami — dodatek do Outlooka przez Microsoft AppSource, dodatek do Gmaila przez Google Workspace Marketplace. Publikacja jest w toku; bezpośrednie linki do instalacji zostaną tu dodane, gdy każda pozycja będzie już dostępna.
Języki
Reveal URLs jest dostępny w języku angielskim oraz wielu innych językach.
- Strona ustawień automatycznie podąża za językiem twojej przeglądarki, wracając do angielskiego, gdy twój język nie jest jednym z powyższych. Możesz to nadpisać w dowolnym momencie przełącznikiem Język wyświetlania w pobliżu góry strony; twój wybór jest zapamiętywany na tym urządzeniu (zobacz Strona ustawień).
- Ta witryna (strona główna i te strony dokumentacji) również wykrywa język twojej przeglądarki i oferuje przełącznik języka w nagłówku. Strony podręcznika i prywatności są dostępne w przekładzie; tam gdzie strona nie ma jeszcze tłumaczenia, jest pokazywana po angielsku.
Tekst nieanglojęzyczny jest przetłumaczony maszynowo i oczekuje na weryfikację przez człowieka, więc jakieś sformułowanie może się czasem czytać niezgrabnie; znaczenie ma być zgodne z angielskim oryginałem. Jeśli zauważysz błędny przekład, otwórz zgłoszenie na trackerze zgłoszeń Codeberg.
Prywatność
Reveal URLs nie wysyła żadnych twoich danych e-mailowych ani danych wiadomości do nas ani do żadnej strony trzeciej, w żadnej ze swoich form — nie ma analityki ani śledzenia. To, jak i gdzie odbywa się praca, zależy od formy:
- Rozszerzenie przeglądarki oraz dodatek do Thunderbirda działają w całości na twoim własnym urządzeniu i niczego nie przesyłają: odczytują tekst odnośników, adresy URL oraz kolory strony podczas jej renderowania, nigdy ich nie przechowując ani nie wysyłając.
- Dodatek do Outlooka analizuje otwartą wiadomość na twoim własnym urządzeniu i nie wysyła nigdzie żadnych danych e-maila ani wiadomości; jego kod panelu zadań (HTML, JavaScript, CSS i ikony) jest ładowany z https://www.reveal-urls.eu przez HTTPS, tak jak dzieje się to przy otwieraniu dowolnej strony internetowej.
- Dodatek do Gmaila działa na własnych serwerach Google (tak właśnie działają dodatki do Gmaila): otwarta wiadomość jest tam odczytywana i sprawdzana, za każdym razem, gdy ją otwierasz, i nie jest zachowywana.
Jedyne, co jest przechowywane, to twoje własne ustawienia (takie jak włączone/wyłączone, tryb ujawniania, kolory, rozmiary czcionek, twoja lista ignorowania i wszelkie dodane przez ciebie witryny), trzymane w pamięci per-użytkownik twojej przeglądarki, Outlooka lub Google i nigdy nie wysyłane do nas.
Zobacz politykę prywatności, aby poznać wszystkie szczegóły.
Rozwiązywanie problemów
Odnośnik nie jest ujawniany.
- Sprawdź, czy Reveal URLs jest włączone — ikona na pasku narzędzi nie może pokazywać odznaki OFF, a przełącznik Włącz Reveal URLs na stronie ustawień musi być włączony.
- Sprawdź, czy witryna jest objęta. Wbudowani dostawcy (Gmail, Outlook, Proton) działają od razu; każdy inny webmail musi zostać dodany w Aktywnych witrynach wraz z jego URL dopasowania i selektorem treści wiadomości.
- Sprawdź selektor treści wiadomości. Jeśli nie pasuje do kontenera, który mieści treść wiadomości, odnośniki wewnątrz tego kontenera nie zostaną ujawnione.
- Zauważ, że odnośniki do kotwic w obrębie strony oraz odnośniki używające schematów innych
niż
http/https(takie jakmailto:) są celowo pomijane — podobnie jak hosty na twojej liście Ignoruj te hosty.
Wbudowany dostawca przestał działać po przeprojektowaniu.
Dostawcy webmaila od czasu do czasu zmieniają znaczniki swoich stron. Jeśli selektor wbudowanego dostawcy po takiej zmianie już nie pasuje, możesz to poprawić samodzielnie: w Aktywnych witrynach zmień selektor treści wiadomości tego dostawcy na nowy kontener.
URL w dymku się nie pokazuje.
W trybie dymka (tytułu) rzeczywisty URL jest umieszczany w dymku odnośnika, więc pojawia się tylko wtedy, gdy najedziesz na odnośnik. Jeśli wolisz zobaczyć URL bez najeżdżania, przełącz Ujawnij URL na tryb w wierszu.
Licencja i kod źródłowy
Reveal URLs jest wolnym oprogramowaniem, licencjonowanym na warunkach GNU Affero General Public License v3.0 (AGPL-3.0-only).
- Kod źródłowy: https://codeberg.org/Magentron/reveal-urls
- Przegląd techniczny: Architektura
- Dalsza lektura o phishingu odnośników: Email link phishing: your app should always show the URL




