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 — Посібник користувача

Reveal URLs — це невелике розширення для браузера (і надбудова для Thunderbird), яке показує, куди насправді веде посилання у вашій електронній пошті, тож ви можете розпізнати фішингове посилання, перш ніж натиснути на нього.

Цей посібник пояснює, як установити Reveal URLs і як ним користуватися. Відповіді на поширені запитання див. у поширених запитаннях; про те, як обробляються ваші дані, див. політику конфіденційності; технічний огляд див. в огляді архітектури.

Знайшли помилку, посилання, яке було позначено неправильно (або пропущено), чи хост вебпошти, який мав би підтримуватися? Будь ласка, повідомте про це у трекері питань Codeberg.

Зміст

Що він робить і навіщо

Фішинговий лист приховує ворожу адресу призначення за текстом посилання, що виглядає надійно. Іноді це схожий на справжній хост: текст читається як paypal.com, тоді як посилання вказує на paypa1.com. Часто це витонченіше — через трекер чи перенаправлювач, тож там, де ви опиняєтеся, немає нічого спільного з брендом, названим у тексті.

Phishing-лист, що видає себе за поштову службу, стверджує, що посилку утримують, доки не буде сплачено прострочені митні збори, і спонукає до оплати через кнопку „Перейти до оплати“. Reveal URLs показує, що кнопка веде не до цієї поштової служби, а до parcel-pay.custom.co.xa, стороннього сайту, тим самим викриваючи повідомлення як шахрайство.
Reveal URLs викриває кнопку „Перейти до оплати“: вона веде на parcel-pay.custom.co.xa, а не до поштової служби, яку імітує.

Примітка: Цей знімок екрана показує шахрайський фішинговий лист, що видає себе за поштову службу. Імітована служба не пов’язана з Reveal URLs і не підтримує його.

Reveal URLs читає кожне посилання в повідомленні, що ви читаєте, і показує вам URL-адресу, на яку воно вказує. У браузерному розширенні та надбудові Thunderbird воно позначає оманливі вебпосилання, посилання електронної пошти, телефону та інші, тож різниця очевидна, перш ніж ви натиснете.

Reveal URLs розкриває та позначає; він не перевіряє. Він не переходить за перенаправленнями: посилання через трекер чи перенаправлювач показується як URL-адреса трекера або перенаправлювача, яку воно фактично називає; Reveal URLs не може знати, де зрештою опиниться це перенаправлення. Посилання без попередження у ньому не виявлено жодної застосовної невідповідності, а не підтверджено як безпечне, тож прочитайте розкриту URL-адресу, перш ніж довіряти посиланню, навіть коли нічого не позначено. Щоб пам’ятати про це, розкрита URL-адреса непозначеного посилання показується бурштиновим кольором „перевірити“ замість заспокійливого зеленого.

Повідомлення в Gmail з активним Reveal URLs: оманливе посилання позначене червоним разом із розкритою над текстом посилання відстежувальною URL-адресою, тоді як URL-адреса посилання без невідповідності розкрита без попередження.

Примітка: адреси електронної пошти, URL-адреси та імена на цьому знімку екрана замасковані зірочками задля приватності.

У браузерному розширенні та надбудові Thunderbird усе відбувається на вашому власному пристрої, нічого не передаючи. У кожній формі Reveal URLs не надсилає жодних ваших поштових даних ані нам, ані будь-якій третій стороні — немає жодної аналітики та жодного відстеження. (Форми різняться тим, де вони працюють і як обслуговується код панелі Outlook; див. розділ Конфіденційність і політику конфіденційності щодо повних подробиць.)

Підтримувані браузери та поштові застосунки

Reveal URLs працює на:

Веб-браузери:

Поштові застосунки:

На браузерних цілях Reveal URLs анотує посилання у вашій вебпошті. У Thunderbird він анотує посилання в листі, який ви читаєте, безпосередньо в поштовому клієнті.

Встановлення

Із магазину вашого браузера чи поштового клієнта (рекомендовано)

Установіть Reveal URLs із магазину для вашого браузера чи поштового клієнта. Усі списки тепер доступні; Opera використовує збірку Chrome.

Веб-браузери:

Поштові застосунки:

Самостійне завантаження збірки (розробники та раннє тестування)

Якщо ви зібрали Reveal URLs із вихідного коду, ви можете завантажити розпаковану збірку безпосередньо. Кожну ціль зібрано командою make і створено в dist/<target>/:

make build-chrome        # створює dist/chrome
make build-edge          # створює dist/edge
make build-firefox       # створює dist/firefox
make build-gmail         # створює dist/gmail
make build-opera         # створює dist/opera
make build-outlook       # створює dist/outlook
make build-safari        # створює dist/safari
make build-thunderbird   # створює dist/thunderbird

Потім завантажте отриману теку:

Розширення Safari, надбудова Outlook і надбудова Gmail не завантажуються як розпаковані розширення браузера. Зберіть їх як вище, а потім:

make deploy-gmail        # розгортає надбудову Gmail в Apps Script
make safari-xcode        # збирає проєкт Safari Xcode, потім запустіть його
                         # з меню Develop у Safari (macOS)
                         # Outlook: завантажте dist/outlook збоку

Сторінка налаштувань відкривається автоматично під час першого встановлення розширення.

Використання

За замовчуванням Reveal URLs анотує посилання в повідомленнях у вбудованих провайдерах — жодного налаштування не потрібно:

Анотація обмежена тілом повідомлення, тож власний інтерфейс застосунку — його бічна панель, вікно створення й панелі інструментів — залишається незайманим. У Thunderbird охоплено весь відображений лист.

Reveal URLs анотує повідомлення в Gmail: URL-адреса кожного посилання показана окремим рядком над текстом посилання, невідповідне відстежувальне посилання позначене червоним, а посилання без невідповідності розкрите без попередження.

Примітка: адреси електронної пошти, URL-адреси та імена на цьому знімку екрана замасковані зірочками задля приватності.

Як відображається справжня URL-адреса

Справжня URL-адреса кожного посилання відображається окремим рядком, безпосередньо над текстом посилання. Вона також розміщується в підказці посилання (title), тож повна URL-адреса завжди там, коли ви наводите курсор на посилання.

Виділення невідповідностей

Для вебпосилань Reveal URLs порівнює назви URL-адрес або хостів у видимому тексті посилання з URL-адресою, на яку воно вказує. Порівняння виконується за реєстрованим доменом, тож піддомен без невідповідності, як-от mail.example.com для example.com, не позначається, тоді як схожий на справжній, як-от paypa1.com для paypal.com, позначається. Браузерне розширення та Thunderbird також перевіряють посилання електронної пошти, телефону й непрозорі; посилання javascript:, data: і vbscript: позначаються завжди.

Перевірка розглядає лише URL-адресу, названу самим посиланням; перенаправлення ніколи не відстежуються, тому посилання через трекер чи перенаправлювач порівнюється з його URL-адресою, а не зі сторінкою, якої воно зрештою досягає.

Невідповідність відображається у вибраному вами кольорі невідповідності та напівжирним.

Цим керують два пов'язані налаштування:

Сторінка налаштувань: селектор режиму «Показувати URL-адресу», перемикач «Виділяти невідповідні посилання» та поля кольорів невідповідності й без невідповідності.

Кнопка на панелі інструментів

У Chrome, Edge, Opera, Firefox і Thunderbird піктограма Reveal URLs на панелі інструментів — це швидкий перемикач увімк./вимк. — натисніть її, щоб перемкнути анотацію. Коли розширення вимкнено, на піктограмі з'являється значок OFF, а підказка повідомляє, чи ввімкне його натискання, чи вимкне. У браузерах зміна набуває чинності в усіх відкритих вкладках одночасно; у Thunderbird вона застосовується до наступного повідомлення, яке ви відкриєте.

Поки Reveal URLs увімкнено, піктограма на панелі інструментів браузера також повідомляє вам, для кожної вкладки, що вона знайшла на поточній сторінці. Якщо на сторінці є невідповідні (схожі на вигляд) посилання, піктограма показує цю кількість на червоному значку; якщо на сторінці є посилання, але жодне з них не є невідповідним, вона показує загальну кількість проаналізованих посилань на сірому значку; сторінка без посилань для аналізу (і будь-яка сторінка, на яку розширення не діє) не показує жодної кількості. Кожна вкладка зберігає власний значок, тож перемикання між вкладками оновлює число, а перехід на іншу сторінку або закриття вкладки очищає його. (Кількості понад 99 показуються як 99+.)

Значок у трьох його станах (його малює браузер, тому точне розташування дещо відрізняється залежно від браузера): червона кількість невідповідностей, сіра кількість проаналізованих посилань і значок OFF, поки розширення вимкнено; його логотип також приглушено світло-сірий. На сторінці, де ввімкнене розширення не є активним, значка немає; відсутність значка OFF відрізняє той самий приглушений логотип від вимкненого стану.

Ці ілюстрації не показують кожен випадок без значка; активна сторінка без посилань, які можна проаналізувати, зберігає піктограму звичайного кольору.

Піктограма панелі інструментів, що показує червоний значок із кількістю невідповідних посилань на поточній сторінці Піктограма панелі інструментів, що показує сірий значок із кількістю проаналізованих посилань на поточній сторінці Піктограма панелі інструментів із приглушеним світло-сірим логотипом без значка, поки ввімкнене розширення не активне на цій сторінці Піктограма панелі інструментів, що показує червоний значок OFF, поки розширення вимкнено

(У Thunderbird кнопка показує лише свою піктограму, тож залишається компактною в об'єднаній панелі інструментів. Ви також можете вмикати й вимикати Reveal URLs перемикачем Увімкнути на сторінці налаштувань.)

Сторінка налаштувань

Сторінка налаштувань містить кожну опцію. Відкрийте її зі сторінки розширень вашого браузера (наприклад Подробиці → Опції розширення), або вона відкривається автоматично під час першого встановлення.

Окрім головного вимикача Увімкнути та елементів керування Активні сайти (які застосовуються негайно), зміни зберігаються кнопкою Зберегти налаштування.

Нижні налаштування: список «Ігнорувати ці хости», максимальна довжина показаної URL-адреси та необов'язкові поля розміру й товщини шрифту показаної URL-адреси, над кнопкою «Зберегти налаштування».

Активні сайти — додавання власної вебпошти

Розділ Активні сайти вгорі сторінки налаштувань використовує dropdown, який показує по одному сайту за раз. Виберіть сайт, щоб показати його редактор під списком, разом зі сторінкою, де працює Reveal URLs, і контейнером, що містить тіло кожного повідомлення.

Верх сторінки налаштувань: головний вимикач «Увімкнути Reveal URLs», dropdown «Активні сайти» та редактор вибраного сайту з полем Match URL лише для читання, перемикачем «Увімкнено», полем селектора тіла повідомлення та перемикачем «Вкладені фрейми».

Dropdown показує один варіант для кожного активного сайту. Його мітка використовує назву сайту, коли вона є, інакше шаблон відповідності. Коли ту саму назву мають кілька сайтів, у дужках додається хост, щоб їх розрізняти, наприклад Gmail, Proton Mail, Outlook (Live), Tuta (app.tuta.com) або Zoho Mail (mail.zoho.eu).

Редактор вибраного сайту показує:

Вбудовані провайдери (FastMail, Gmail, Outlook Live, Outlook 365, Proton, Tuta, Yahoo і Zoho) мають фіксовані назви, їх можна вимкнути чи перенаправити, але не можна видалити. Їхні назви тут також можна перейменовувати; очищення назви вбудованого провайдера відновлює його типову дружню назву. Match URL є лише для читання для кожного наявного сайту; щоб змінити його, видаліть сайт і додайте його знову з новим значенням.

Щоб додати власний сайт вебпошти:

  1. У розділі Додати сайт введіть URL-адресу відповідності — шаблон відповідності, як-от https://mail.example.com/*.
  2. За бажанням введіть Name, якщо хочете, щоб dropdown показував дружнішу назву замість URL-адреси.
  3. Введіть Селектор тіла повідомлення — CSS-селектор контейнера, що містить тіло повідомлення, наприклад .message-body.
  4. Якщо тіло повідомлення відображається у вкладеному фреймі, поставте позначку Виконувати також у вкладених фреймах.
  5. Натисніть Додати сайт. Ваш браузер попросить дозволу на доступ до цього сайту; надайте його. Сайт додається лише після того, як ви надасте дозвіл.

Зміни тут застосовуються негайно. Видалення сайту, який ви додали, також відкликає його дозвіл, тож Reveal URLs припиняє доступ до нього. Щоб змінити URL-адресу відповідності сайту, видаліть його й додайте знову: відповідність залишається лише для читання, оскільки це ідентичність правила.

Thunderbird (та інші поштові клієнти). Thunderbird уже показує кожне повідомлення, яке ви читаєте, хоч би який був провайдер, тож йому не потрібен список за хостами. Розділ Активні сайти тому не показується на сторінці налаштувань Thunderbird — з'являються лише головний вимикач, мова відображення, кольори, шрифти та список ігнорування. Будь-яка конфігурація активних сайтів, яку ви могли встановити в браузері, зберігається незайманою: збереження налаштувань Thunderbird ніколи її не очищає.

Надбудови Outlook і Gmail

Поряд із браузерним розширенням і надбудовою Thunderbird, Reveal URLs постачається як рідна надбудова для двох поштових застосунків, до яких браузерне розширення не може дістатися: надбудова Outlook і надбудова Gmail. Вони спільно використовують виявлення http/https URL-адрес/хостів браузерного розширення, але не аналізують його додаткові схеми посилань.

Єдина відмінність — у тому, як вони показують свої знахідки. Браузерне розширення анотує посилання на місці — розфарбовуючи URL-адресу над кожним посиланням або поряд із ним. Фреймворки Outlook і Gmail не дозволяють надбудові змінювати відображене повідомлення, тож натомість кожна надбудова показує бічну панель (Outlook) або картку (Gmail) зі списком знайдених посилань. Для кожного http/https-посилання вона показує видимий текст і URL-адресу призначення та позначає невідповідність лише коли видимий текст називає URL-адресу або хост, чий реєстрований домен не збігається з доменом цілі посилання.

Надбудова Gmail тепер доступна через Google Workspace Marketplace.

Мови

Reveal URLs доступний англійською та багатьма іншими мовами.

Неанглійський текст машинно перекладений і очікує перевірки людиною, тож фраза може подекуди читатися незграбно; значення покликане відповідати англійському оригіналу. Якщо ви помітили хибний переклад, будь ласка, відкрийте питання у трекері питань Codeberg.

Конфіденційність

Reveal URLs не надсилає жодних ваших поштових даних чи даних повідомлень ані нам, ані будь-якій третій стороні, у жодній зі своїх форм — немає жодної аналітики та жодного відстеження. Як і де відбувається робота, залежить від форми:

Єдине, що зберігається, — це ваші власні налаштування (як-от увімкнено/вимкнено, режим показу, кольори, розміри шрифтів, ваш список ігнорування та будь-які додані вами сайти), які зберігаються у сховищі вашого браузера, Outlook чи Google для кожного користувача й ніколи не надсилаються нам.

Див. політику конфіденційності щодо повних подробиць.

Усунення несправностей

Посилання не розкривається.

Вбудований провайдер перестав працювати після редизайну.

Провайдери вебпошти час від часу змінюють розмітку своїх сторінок. Якщо селектор вбудованого провайдера більше не збігається після такої зміни, ви можете виправити його самостійно: у розділі Активні сайти відредагуйте селектор тіла повідомлення цього провайдера на новий контейнер.

Ліцензія та вихідний код

Reveal URLs — вільне програмне забезпечення, ліцензоване за GNU Affero General Public License v3.0 (AGPL-3.0-only).

Примітки щодо Safari

Safari показує значок лише коли посилання не збігаються; сірого лічильника безпечної сторінки немає. Відкрийте налаштування знову з меню правої кнопки Reveal URLs — settings, а не перезавантажуйте стару вкладку налаштувань.