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 го означува тоа, така што несогласувањето е јасно пред да кликнете.

Во проширувањето за прелистувач и во додатокот за Thunderbird сè се случува на вашиот уред и ништо не се пренесува. Во сите свои форми Reveal URLs не испраќа никакви податоци од вашата пошта до нас или до трети страни: нема analytics и нема tracking. Формите се разликуваат само според тоа каде се извршуваат и како се сервира кодот на панелот за Outlook. За целосните подробности видете го делот Приватност и политиката за приватност.

Поддржани прелистувачи и клиент за пошта

Reveal URLs работи на:

Google Chrome
Microsoft Edge
Opera
Mozilla Firefox
Mozilla Thunderbird (десктоп клиентот за пошта)

Верзија за Safari сè уште не е објавена. Таа е планирана за подоцнежна фаза.

Во прелистувачите Reveal URLs ги означува врските во вашиот webmail. Во Thunderbird тој ги означува врските директно во е-поштата што ја читате во самиот клиент.

Инсталирање

Од продавницата на вашиот прелистувач или клиент за пошта (препорачано)

Инсталирајте го Reveal URLs од продавницата за вашиот прелистувач или клиент за пошта. Објавите за Chrome, Edge, Firefox и Thunderbird веќе се достапни. Opera го користи build-от за Chrome, а посебна објава за Opera сè уште се подготвува:

Chrome — the Chrome Web Store
Edge — Microsoft Edge Add-ons
Opera — инсталирајте ја верзијата за Chrome од the Chrome Web Store. Посебна објава за Opera доаѓа наскоро
Firefox — Firefox Add-ons (AMO)
Thunderbird — Thunderbird Add-ons (ATN)

Вчитување на сопствен 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

Потоа вчитајте ја соодветната папка:

Chrome — отворете chrome://extensions, вклучете Developer mode, кликнете Load unpacked и изберете dist/chrome.
Edge — отворете edge://extensions, вклучете Developer mode, кликнете Load unpacked и изберете dist/edge.
Opera — отворете opera://extensions, вклучете Developer mode, кликнете Load unpacked и изберете dist/opera.
Firefox — отворете about:debugging, изберете This Firefox, кликнете Load Temporary Add-on и изберете датотека во dist/firefox, на пример manifest.json. Привремениот додаток се отстранува кога Firefox се рестартира.
Thunderbird — инсталирајте го привремениот додаток од dist/thunderbird на истиот начин преку Tools → Developer Tools → Debug Add-ons → Load Temporary Add-on.

Страницата со поставки се отвора автоматски при првата инсталација на проширувањето.

Користење

Веднаш по инсталацијата Reveal URLs ги означува врските во пораките кај вградените доставувачи без дополнително конфигурирање:

Gmail (mail.google.com)
Outlook Live (outlook.live.com)
Outlook on the web / Microsoft 365 (outlook.office.com)
Proton Mail (mail.proton.me)

Означувањето е ограничено на телото на пораката, така што остатокот од интерфејсот на апликацијата, како страничната лента, прозорецот за составување и алатниците, останува недопрен. Во Thunderbird се опфаќа целата rendered email порака.

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

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

Inline — вистинскиот URL се прикажува на свој ред веднаш над текстот на врската. Ова е стандардната поставка.
In the link's tooltip (title) — вистинскиот URL се става во tooltip-от на врската и се гледа кога ќе го задржите покажувачот над неа.

Истакнување на несогласувања

Кога host-от наведен во видливиот текст на врската не се совпаѓа со host-от до кој врската навистина води, Reveal URLs го означува тоа како несогласување. Споредбата се прави на registrable доменот, така што чесен поддомен како mail.example.com за example.com не се означува, а host look-alike како paypa1.com за paypal.com се означува.

Во режим inline несогласувањето се прикажува со бојата за mismatch што сте ја избрале и со задебелен текст.
Во режим tooltip (title) покрај врската се додава јасна ознака ⚠ URL mismatch.

Две поврзани поставки го контролираат ова однесување:

Highlight mismatching links го вклучува или исклучува истакнувањето на несогласувањата.
Only annotate mismatching links ги остава чесните врски целосно недопрени, така што се откриваат само сомнителните.

Копчето на алатникот

Во Chrome, Edge, Opera, Firefox и Thunderbird, иконата на Reveal URLs на алатникот е брз прекинувач за вклучување/исклучување — кликнете на неа за да го префрлите анотирањето. Кога екстензијата е исклучена, на иконата се појавува ознака OFF, а нејзиниот опис ви кажува дали кликнувањето ќе ја вклучи или исклучи. Во прелистувачите промената стапува во сила во сите отворени јазичиња одеднаш; во Thunderbird се применува на следната порака што ќе ја отворите.

(Во Thunderbird копчето ја прикажува само својата икона, па останува компактно во обединетата лента со алатки. Reveal URLs можете да го вклучувате и исклучувате и со прекинувачот Enable на страницата со поставки.)

Страницата со поставки

Страницата со поставки ги содржи сите опции. Отворете ја од страницата со проширувања на вашиот прелистувач, на пример преку Details → Extension options, или таа ќе се отвори автоматски при првата инсталација.

Enable Reveal URLs — главниот прекинувач за вклучување и исклучување на самиот врв од страницата. Тој стапува на сила веднаш, без потреба да се зачува остатокот од формата.
Display language — изберете го јазикот на кој ќе се прикажува страницата со поставки. Стандардно го следи јазикот на вашиот прелистувач и се враќа на англиски кога вашиот јазик не е поддржан. Можете да го надминете тоа со избор на друг јазик од листата. Вашиот избор стапува на сила веднаш, се памети за следниот пат и се чува само на овој уред.
Reveal the URL — изберете inline или tooltip (title) режим, како што е опишано погоре.
Highlight mismatching links — вклучете или исклучете го истакнувањето на несогласувањата.
Mismatch colour — CSS бојата што се користи за означена врска, на пример red, #cc0000 или rgb(200, 0, 0). Стандардната боја е црвена.
Match colour — бојата на откриениот URL кај чесните врски без несогласување, на пример black или #1a1a1a. Стандардно тоа е неутрално многу темно сиво (#1a1a1a), избрано така што бојата да не сугерира дека врската е проверена.
Only annotate mismatching links — оставете ги чесните врски недопрени.
Ignore these hosts — листа на hostnames што треба целосно да се прескокнат, по еден во ред. Се прескокнуваат и поддомените на наведениот host.
Maximum displayed URL length — долгите URL-и се скратуваат по овој број знаци, со тоа што host-от останува видлив. Дозволен опсег: 20 до
Revealed URL font size / weight и Warning badge font size / weight — опционални замени за типографијата. Оставете празно ако сакате да ги задржите стандардните вредности.

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

Активни сајтови — додавање на вашиот webmail

Делот Active sites на врвот од страницата со поставки ги наведува страниците на кои работи Reveal URLs и container-от што го содржи телото на секоја порака.

Секој ред прикажува:

match pattern на сајтот, на пример https://mail.example.com/*
прекинувач Enabled
message-body selector, односно CSS selector-от за container-от што Reveal URLs го означува и кој можете да го уредувате
прекинувач Sub-frames, за сајтови чие тело на порака се прикажува во iframe
копче Remove, само за сајтовите што самите сте ги додале

Вградените доставувачи, како Gmail, Outlook и Proton, може да се исклучуваат или пренасочуваат, но не може да се отстрануваат.

За да додадете сопствен webmail сајт:

Под Add site внесете Match URL — match pattern како https://mail.example.com/*.
Внесете Message-body selector — CSS selector за container-от што го содржи телото на пораката, на пример .message-body.
Ако телото на пораката се прикажува во подрамка, означете Also run inside sub-frames.
Кликнете 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 — task pane што ја чита отворената порака и ја анализира на вашиот уред. Никакви податоци за е-пошта или порака не се испраќаат никаде. Кодот на task pane-от, односно HTML, JavaScript, CSS и иконите, се вчитува од https://www.reveal-urls.eu преку HTTPS, како кога отворате било која веб-страница. Тој ги опфаќа Outlook on the web, Windows, Mac, iOS, Android и Outlook.com.
Gmail add-on — картичка во страничната лента на Gmail. Отворете порака, потоа кликнете на иконата Reveal URLs во десната странична лента за да ги видите нејзините врски. Gmail не ја отвора картичката сам, но ако панелот го оставите отворен, тој се освежува додека се движите меѓу пораките. URL-от на секоја врска се прикажува со неутрално темно сиво за чесна врска и со црвено за look-alike. Додатокот го опфаќа Gmail на web, Android и iOS. За разлика од другите форми, Gmail add-on работи на серверите на Google, така функционираат Gmail додатоците. Пораката што ја отворате се чита и проверува таму секој пат кога ќе ја отворите и не се задржува. Во политиката за приватност видете до што има пристап секоја форма и што зачувува.

И двата додатоци ќе се дистрибуираат преку своите продавници за апликации: Outlook add-in преку Microsoft AppSource, а Gmail add-on преку Google Workspace Marketplace. Објавувањето сè уште претстои. Директни врски за инсталација ќе бидат додадени тука кога секоја објава ќе стане активна.

Јазици

Reveal URLs е достапен на англиски и на многу други јазици.

Страницата со поставки автоматски го следи јазикот на вашиот прелистувач и се враќа на англиски кога вашиот јазик не е поддржан. Можете во секое време да го надминете тоа со изборот Display language близу врвот на страницата. Вашиот избор се памети на тој уред. Видете ја Страницата со поставки.
Оваа веб-страница, односно почетната страница и овие документациски страници, исто така го препознава јазикот на вашиот прелистувач и нуди избирач на јазик во заглавието. Прирачникот и страниците за приватност се достапни преведени. Таму каде што уште нема превод за некоја страница, се прикажува англиската верзија.

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

Приватност

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

Проширувањето за прелистувач и додатокот за Thunderbird работат целосно на вашиот уред и не пренесуваат ништо. Тие го читаат текстот на врските, URL-ите и боите на страницата додека таа се render-ира, без да ги зачувуваат или испраќаат.
Outlook add-in ја анализира отворената порака на вашиот уред и не испраќа никаде податоци за е-пошта или порака. Кодот на task pane-от, односно HTML, JavaScript, CSS и иконите, се вчитува од https://www.reveal-urls.eu преку HTTPS, како и секоја друга веб-страница.
Gmail add-on работи на серверите на Google, така функционираат Gmail додатоците. Отворената порака се чита и проверува таму секој пат кога ќе ја отворите и не се задржува.

Единственото што се зачувува се вашите сопствени поставки, како тоа дали Reveal URLs е вклучен или исклучен, режимот на откривање, боите, големините на фонтот, листата за игнорирање и сите сајтови што сте ги додале. Тие се чуваат во per-user storage на вашиот прелистувач, Outlook или Google и никогаш не ни се испраќаат нам.

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

Решавање проблеми

Една врска не се открива.

Проверете дали Reveal URLs е вклучен. Иконата во алатникот не смее да ја прикажува ознаката OFF, а прекинувачот Enable Reveal URLs на страницата со поставки мора да биде вклучен.
Проверете дали сајтот е опфатен. Вградените доставувачи Gmail, Outlook и Proton работат веднаш. Секој друг webmail мора да биде додаден под Active sites со својот match URL и message-body selector.
Проверете го message-body selector-от. Ако тој не се совпаѓа со container-от што го содржи телото на пораката, врските во тој container нема да бидат откриени.
Имајте предвид дека врски до сидра во страница и врски што користат scheme-и различни од http/https, како mailto:, намерно се прескокнуваат. Истото важи и за host-овите во вашата листа Ignore these hosts.

Вграден доставувач престана да работи по редизајн.

Доставувачите на 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).

Изворен код: https://codeberg.org/Magentron/reveal-urls
Технички преглед: Architecture
Повеќе за phishing со врски: Email link phishing: your app should always show the URL