Reveal URLs

Reveal URLs — Потребителско ръководство

Reveal URLs е малко разширение за браузър и добавка за Thunderbird, която ви показва накъде наистина води една връзка в електронната ви поща, за да можете да разпознаете phishing връзка, преди да щракнете върху нея.

Това ръководство обяснява как да инсталирате Reveal URLs и как да го използвате. За начина, по който се обработват вашите данни, вижте политиката за поверителност. За технически преглед на начина, по който е изградено разширението, вижте прегледа на архитектурата.

Открихте бъг, връзка, маркирана погрешно, или host на webmail, който трябва да се поддържа? Докладвайте го в Codeberg issue tracker.

Съдържание

Какво прави и защо

Един phishing имейл скрива враждебна дестинация зад текст на връзка, който изглежда надежден. Понякога това е host, който само прилича на истинския: текстът показва paypal.com, а връзката всъщност води до paypa1.com. Често измамата е по-фина и минава през tracker или redirector, така че мястото, на което попадате, няма почти нищо общо с марката, спомената в текста.

Phishing имейл, който се представя за Български пощи, твърди, че пратка е задържана, докато не бъдат платени дължими митнически такси, и подканва към плащане чрез бутон „Към плащане“. Reveal URLs показва, че бутонът не води към Български пощи, а към parcel-pay.custom.co.xa, несвързан сайт, което разкрива съобщението като измама.
Reveal URLs разкрива бутона „Към плащане“: той води към parcel-pay.custom.co.xa, а не към Български пощи.

Бележка: Тази екранна снимка показва измамно фишинг писмо, което се представя за Български пощи. Български пощи не е свързана с Reveal URLs и не го подкрепя.

Reveal URLs прочита всяка връзка в съобщението, което разглеждате, и ви показва URL-а, към който тя сочи. Когато host-ът, изписан във видимия текст на връзката, не съвпада с host-а, към който тя действително води, Reveal URLs го маркира, така че несъответствието да се вижда ясно, преди да щракнете.

Съобщение в Gmail с активен Reveal URLs: измамна връзка е маркирана в червено, а URL-ът за проследяване, към който води, е показан над текста на връзката, докато URL-ът на коректна връзка се показва без предупреждение.

В разширението за браузър и в добавката за Thunderbird всичко се случва на вашето устройство и нищо не се предава. Във всички свои форми Reveal URLs не изпраща никакви данни от вашата поща до нас или до трети страни: няма analytics и няма tracking. Формите се различават само по мястото, на което се изпълняват, и по начина, по който се обслужва кодът на панела за Outlook. За пълните подробности вижте раздела Поверителност и политиката за поверителност.

Поддържани браузъри и пощенски клиент

Reveal URLs работи в:

Версия за Safari все още не е публикувана. Тя е планирана за по-късен етап.

В браузърите Reveal URLs маркира връзките във вашия webmail. В Thunderbird той маркира връзките директно в имейла, който четете в самия клиент.

Инсталиране

От магазина на вашия браузър или пощенски клиент (препоръчително)

Инсталирайте Reveal URLs от магазина за вашия браузър или пощенски клиент. Публикациите за Chrome, Edge, Firefox и Thunderbird вече са налични. Opera използва build-а за Chrome, а отделна публикация за Opera все още се подготвя:

Зареждане на собствен build (разработчици и ранно тестване)

Ако сте изградили Reveal URLs от изходния код, можете да заредите разархивирания build директно. Всеки target се изгражда с команда make и се създава под 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

След това заредете съответната папка:

Страницата с настройки се отваря автоматично при първото инсталиране на разширението.

Използване

Веднага след инсталацията Reveal URLs маркира връзките в съобщенията на вградените доставчици без допълнителна настройка:

Маркирането е ограничено до тялото на съобщението, така че останалият интерфейс на приложението, като страничната лента, прозорецът за създаване и лентите с инструменти, остава недокоснат. В Thunderbird се обхваща целият rendered email.

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

Двата режима на показване

На страницата с настройки, под Reveal the URL, избирате как да се показва истинският URL:

Подчертаване на несъответствията

Когато host-ът, изписан във видимия текст на връзката, не съвпада с host-а, към който тя всъщност сочи, Reveal URLs го маркира като несъответствие. Сравнението се прави върху registrable домейна, така че коректен поддомейн като mail.example.com за example.com не се маркира, а host look-alike като paypa1.com за paypal.com се маркира.

Две свързани настройки управляват това поведение:

Страницата с настройки: изборът за режим 'Reveal the URL', превключвателят 'Highlight mismatching links' и полетата за цвят на mismatch и match.

Бутонът в лентата с инструменти

В Chrome, Edge, Opera, Firefox и Thunderbird иконата на Reveal URLs в лентата с инструменти е бърз превключвател за вкл./изкл. — щракнете върху нея, за да превключите анотирането. Когато разширението е изключено, върху иконата се появява значка OFF, а подсказката му ви казва дали щракването ще го включи или изключи. В браузърите промяната влиза в сила във всички отворени раздели едновременно; в Thunderbird тя се прилага към следващото съобщение, което отворите.

(В Thunderbird бутонът показва само иконата си, така че остава компактен в обединената лента с инструменти. Можете също да включвате и изключвате Reveal URLs с превключвателя Enable на страницата с настройки.)

Страницата с настройки

Страницата с настройки съдържа всички опции. Отворете я от страницата с разширения на браузъра, например чрез Details → Extension options, или тя ще се отвори автоматично при първата инсталация.

Освен основния превключвател Enable и контролите Active sites, които се прилагат незабавно, промените се записват с бутона Save settings.

Долните настройки: списъкът 'Ignore these hosts', максималната дължина на показвания URL и незадължителните полета за размер и дебелина на шрифта за показвания URL и предупредителната значка, над бутона 'Save settings'.

Активни сайтове — добавяне на вашия webmail

Разделът Active sites в горната част на страницата с настройки изброява страниците, на които работи Reveal URLs, и container-а, който съдържа тялото на всяко съобщение.

Горната част на страницата с настройки: основният превключвател 'Enable Reveal URLs' и списъкът 'Active sites', където всеки вграден доставчик показва своя match pattern, превключвател 'Enabled', превключвател 'Sub-frames' и selector-а на тялото на съобщението.

Всеки ред показва:

Вградените доставчици, като Gmail, Outlook и Proton, могат да бъдат изключвани или пренасочвани, но не могат да бъдат премахвани.

За да добавите свой webmail сайт:

  1. Под Add site въведете Match URL — match pattern като https://mail.example.com/*.
  2. Въведете Message-body selector — CSS selector за container-а, който съдържа тялото на съобщението, например .message-body.
  3. Ако тялото на съобщението се показва в подрамка, поставете отметка на Also run inside sub-frames.
  4. Натиснете Add site. Вашият браузър ще поиска разрешение за достъп до този сайт. Дайте го. Сайтът се добавя едва след като разрешението бъде одобрено.

Промените тук се прилагат веднага. Премахването на сайт, който сте добавили, също така отменя неговото разрешение, така че Reveal URLs спира да го достъпва.

Thunderbird (и други пощенски клиенти). Thunderbird вече показва всяко съобщение, което четете, независимо от доставчика, така че не му е нужен списък по host. Поради това разделът Active sites не се показва на страницата с настройки в Thunderbird. Там се показват само основният превключвател, езикът на показване, режимът на разкриване, цветовете, шрифтовете и списъкът за игнориране. Всяка конфигурация на активни сайтове, която сте задали в браузър, остава непокътната. Записването на настройките в Thunderbird никога не я изчиства.

Добавките за Outlook и Gmail

Наред с разширението за браузър и добавката за Thunderbird, Reveal URLs съществува и като native добавка за две приложения за поща, до които едно браузърно разширение не може да достигне: Outlook add-in и Gmail add-on. И двете използват същото разпознаване на връзки като разширението, затова разкриват едни и същи URL-и и маркират едни и същи look-alike host-ове.

Единствената разлика е в начина, по който показват своите находки. Разширението за браузър маркира връзките на място, като оцветява URL-а над или до всяка връзка. Outlook и Gmail framework-овете не позволяват на добавката да променя показаното съобщение, затова вместо това всяка добавка показва страничен панел (Outlook) или карта (Gmail) със списък на откритите връзки. За всяка връзка се показват видимият текст, URL-ът на дестинацията и registrable host-ът, а несъответствието се маркира, когато видимият текст назовава различен registrable домейн от този, към който връзката действително сочи.

И двете добавки ще се разпространяват през своите магазини за приложения: Outlook add-in през Microsoft AppSource, а Gmail add-on през Google Workspace Marketplace. Публикуването все още предстои. Преки връзки за инсталиране ще бъдат добавени тук, когато всяка публикация стане активна.

Езици

Reveal URLs е наличен на английски и на много други езици.

Неанглийският текст е машинно преведен и очаква човешки преглед, така че някоя формулировка понякога може да звучи неловко. Целта е смисълът да съвпада с английския оригинал. Ако забележите грешен превод, отворете issue в Codeberg issue tracker.

Поверителност

Reveal URLs не изпраща никакви данни от вашата поща или съобщение до нас или до трети страни, в нито една от своите форми. Няма analytics и няма tracking. Къде и как се върши работата зависи от формата:

Единственото, което се съхранява, са вашите собствени настройки, като това дали Reveal URLs е включен или изключен, режимът на разкриване, цветовете, размерите на шрифтовете, списъкът ви за игнориране и всички сайтове, които сте добавили. Те се пазят в per-user storage на вашия браузър, Outlook или Google и никога не се изпращат до нас.

За пълните подробности вижте политиката за поверителност.

Отстраняване на проблеми

Една връзка не се разкрива.

Вграден доставчик спря да работи след преработка на дизайна.

Доставчиците на webmail променят от време на време markup-а на страниците си. Ако selector-ът на вграден доставчик престане да съвпада след такава промяна, можете сами да го коригирате: в Active sites редактирайте message-body selector-а на този доставчик, така че да сочи към новия container.

Tooltip URL-ът не се показва.

В режим tooltip (title) истинският URL се поставя в tooltip-а на връзката, затова се вижда само когато задържите курсора върху нея. Ако предпочитате да виждате URL-а без hover, превключете Reveal the URL на inline режим.

Лиценз и изходен код

Reveal URLs е свободен софтуер, лицензиран под GNU Affero General Public License v3.0 (AGPL-3.0-only).