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 — 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ć. W przypadku typowych pytań zobacz często zadawane pytania; informacje o postępowaniu z twoimi danymi znajdziesz w polityce prywatności; przegląd techniczny 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

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.

E-mail phishingowy podszywający się pod usługę pocztową twierdzi, że paczka została zatrzymana do czasu opłacenia zaległych należności celnych i nakłania do płatności przyciskiem „Przejdź do płatności“. Reveal URLs pokazuje, że przycisk nie prowadzi do tej usługi pocztowej, lecz do parcel-pay.custom.co.xa, niezwiązanej strony, co ujawnia wiadomość jako oszustwo.
Reveal URLs demaskuje przycisk „Przejdź do płatności“: prowadzi do parcel-pay.custom.co.xa, a nie do usługi pocztowej, pod którą się podszywa.

Uwaga: Ten zrzut ekranu pokazuje oszukańczy e-mail phishingowy podszywający się pod usługę pocztową. Podrabiana usługa 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. W rozszerzeniu przeglądarki i Thunderbirdzie oznacza wprowadzające w błąd odnośniki internetowe, e-mailowe, telefoniczne i inne, dzięki czemu różnica jest oczywista, zanim klikniesz.

Reveal URLs ujawnia i oznacza; nie weryfikuje. Nie śledzi przekierowań: odnośnik prowadzący przez tracker lub przekierowujący jest pokazywany jako adres URL przekierowującego, który faktycznie podaje; Reveal URLs nie może wiedzieć, gdzie to przekierowanie ostatecznie prowadzi. W przypadku linku bez ostrzeżenia nie wykryto żadnej mającej zastosowanie niezgodności, lecz nie potwierdzono, że jest bezpieczny, więc przeczytaj ujawniony adres URL, zanim zaufasz linkowi, nawet gdy nic nie jest oznaczone. Aby o tym pamiętać, ujawniony adres URL nieoznaczonego linku jest pokazywany w bursztynowym kolorze „do sprawdzenia“ zamiast uspokajającej zieleni.

Wiadomość Gmail z aktywnym Reveal URLs: zwodniczy odnośnik jest oznaczony na czerwono z ujawnionym nad tekstem odnośnika śledzącym adresem URL, do którego prowadzi, podczas gdy adres URL odnośnika bez rozbieżności jest ujawniony bez ostrzeżenia.

Uwaga: adresy e-mail, adresy URL i nazwy na tym zrzucie ekranu zostały zamaskowane gwiazdkami ze względu na prywatność.

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 aplikacje pocztowe

Reveal URLs działa na:

Przeglądarki internetowe:

Aplikacje pocztowe:

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. Wszystkie pozycje są teraz dostępne; Opera korzysta z builda Chrome.

Przeglądarki internetowe:

Aplikacje pocztowe:

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        # tworzy dist/chrome
make build-edge          # tworzy dist/edge
make build-firefox       # tworzy dist/firefox
make build-gmail         # tworzy dist/gmail
make build-opera         # tworzy dist/opera
make build-outlook       # tworzy dist/outlook
make build-safari        # tworzy dist/safari
make build-thunderbird   # tworzy dist/thunderbird

Następnie załaduj powstały folder:

Rozszerzenie Safari, dodatek Outlook i dodatek Gmail nie są ładowane jako rozpakowane rozszerzenia przeglądarki. Zbuduj je jak powyżej, a następnie:

make deploy-gmail        # wdraża dodatek Gmail do Apps Script
make safari-xcode        # buduje projekt Safari Xcode, a następnie go uruchom
                         # z menu Develop w Safari (macOS)
                         # Outlook: załaduj dist/outlook jako sideload

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:

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.

Reveal URLs adnotujący wiadomość Gmail: adres URL każdego odnośnika jest pokazany we własnym wierszu nad tekstem odnośnika, z niezgodnym śledzącym linkiem oznaczonym na czerwono i ujawnionym bez ostrzeżenia adresem URL odnośnika bez rozbieżności.

Uwaga: adresy e-mail, adresy URL i nazwy na tym zrzucie ekranu zostały zamaskowane gwiazdkami ze względu na prywatność.

Jak wyświetlany jest rzeczywisty URL

Rzeczywisty URL każdego odnośnika jest pokazywany we własnym wierszu, tuż nad tekstem odnośnika. Jest również umieszczany w dymku (tytule) odnośnika, więc pełny URL jest zawsze dostępny, gdy najedziesz kursorem na odnośnik.

Podświetlanie niezgodności

W przypadku odnośników internetowych Reveal URLs porównuje adres URL lub nazwę hosta w widocznym tekście odnośnika z adresem URL, na który on prowadzi. Porównanie odbywa się na rejestrowalnej domenie, więc subdomena bez rozbieżności, taka jak mail.example.com dla example.com, nie jest oznaczana, podczas gdy łudząco podobna, taka jak paypa1.com dla paypal.com, jest. Rozszerzenie przeglądarki i Thunderbird sprawdzają również odnośniki e-mailowe, telefoniczne i nieprzezroczyste; odnośniki javascript:, data: i vbscript: są zawsze oznaczane.

Sprawdzanie uwzględnia tylko adres URL podany przez sam odnośnik; przekierowania nigdy nie są śledzone, więc odnośnik przez tracker lub przekierowujący jest porównywany jako jego adres URL, a nie jako strona, do której ostatecznie trafia.

Niezgodność jest pokazywana w wybranym przez ciebie kolorze niezgodności i pogrubiona.

Steruje tym dwa powiązane ustawienia:

Strona ustawień: selektor trybu 'Ujawnij URL', przełącznik 'Podświetlaj niezgodne odnośniki' oraz pola koloru niezgodności i koloru bez rozbieżności.

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.

Gdy Reveal URLs jest włączony, ikona na pasku narzędzi przeglądarki informuje Cię również, dla każdej karty, co znalazła na bieżącej stronie. Jeśli strona zawiera niezgodne (łudząco podobne) łącza, ikona pokazuje tę liczbę na czerwonej plakietce; jeśli strona zawiera łącza, ale żadne z nich nie jest niezgodne, pokazuje łączną liczbę przeanalizowanych łączy na szarej plakietce; strona bez łączy do analizy (oraz każda strona, na którą rozszerzenie nie działa) nie pokazuje żadnej liczby. Każda karta zachowuje własną plakietkę, więc przełączanie kart aktualizuje liczbę, a opuszczenie strony lub zamknięcie karty ją czyści. (Liczby powyżej 99 są pokazywane jako 99+.)

Plakietka w swoich stanach (rysuje ją przeglądarka, więc dokładne położenie nieco różni się w zależności od przeglądarki): czerwona liczba niezgodności, szara liczba przeanalizowanych łączy oraz plakietka OFF, gdy rozszerzenie jest wyłączone; jego logo jest wtedy również stonowane, jasnoszare. Na stronie, na której włączone rozszerzenie nie jest aktywne, nie ma plakietki; brak plakietki OFF odróżnia to samo stonowane logo od stanu wyłączenia.

Te ilustracje nie pokazują każdego przypadku bez plakietki; aktywna strona bez łączy możliwych do przeanalizowania zachowuje ikonę w normalnym kolorze.

Ikona paska narzędzi pokazująca czerwoną plakietkę z liczbą niezgodnych łączy na bieżącej stronie Ikona paska narzędzi pokazująca szarą plakietkę z liczbą przeanalizowanych łączy na bieżącej stronie Ikona paska narzędzi z przygaszonym jasnoszarym logo bez plakietki, gdy włączone rozszerzenie nie jest aktywne na tej stronie Ikona paska narzędzi pokazująca czerwoną plakietkę OFF, gdy rozszerzenie jest wyłączone

(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.

Poza głównym przełącznikiem Włącz i sterowaniem Aktywnymi witrynami (które są stosowane od razu) zmiany są zapisywane przyciskiem Zapisz ustawienia.

Dolne ustawienia: lista 'Ignoruj te hosty', maksymalna wyświetlana długość URL oraz opcjonalne pola rozmiaru i grubości czcionki ujawnionego URL, nad 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. Teraz zachowuje stałą wysokość: wybierz jedną witrynę z listy rozwijanej i edytuj tylko ustawienia tej witryny w panelu poniżej.

Górna część strony ustawień: główny przełącznik 'Enable Reveal URLs' i sekcja 'Active sites', z listą rozwijaną 'Active site' nad jednym edytorem wybranej witryny pokazującym match pattern, przełącznik 'Enabled', przełącznik 'Sub-frames' i jego message-body selector.

Lista rozwijana pokazuje po jednej pozycji dla każdej reguły witryny:

Edytor wybranej witryny pokazuje:

Wbudowani dostawcy (FastMail, Gmail, Outlook Live, Outlook 365, Proton, Tuta, Yahoo i Zoho) mogą być wyłączeni i przekierowani, ale nie mogą zostać usunięci. Ich nazwy również można tu zmieniać; wyczyszczenie nazwy wbudowanego dostawcy przywraca jego domyślną przyjazną nazwę.

Aby dodać własną witrynę webmaila:

  1. W sekcji Dodaj witrynę wprowadź URL dopasowania — wzorzec dopasowania, taki jak https://mail.example.com/*.
  2. Opcjonalnie wprowadź Name dla listy rozwijanej. Pozostaw puste, aby wrócić do match URL.
  3. Wprowadź Message-body selector — selektor CSS dla kontenera, który mieści treść wiadomości, na przykład .message-body.
  4. Jeśli treść wiadomości jest renderowana wewnątrz podramki, zaznacz Also run inside sub-frames.
  5. Kliknij Add site. 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. Aby zmienić match URL witryny, usuń ją i dodaj ponownie: match pozostaje tylko do odczytu, bo jest to tożsamość reguły.

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, 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. Współdzielą rozpoznawanie adresów URL/hostów http/https rozszerzenia przeglądarki, lecz nie analizują jego dodatkowych schematów odnośników.

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 http/https pokazuje widoczny tekst i adres URL oraz oznacza niezgodność tylko wtedy, gdy widoczny tekst wymienia adres URL lub nazwę hosta, których rejestrowalna domena nie zgadza się z domeną celu odnośnika.

Dodatek do Gmaila jest teraz dostępny w Google Workspace Marketplace.

Języki

Reveal URLs jest dostępny w języku angielskim oraz wielu innych językach.

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:

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.

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

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).

Uwagi dotyczące Safari

Safari pokazuje plakietkę tylko wtedy, gdy łącza nie są zgodne; nie ma szarego licznika bezpiecznej strony. Otwórz ustawienia ponownie z menu po kliknięciu prawym przyciskiem Reveal URLs — settings, zamiast ładować starą kartę.