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

Reveal URLs открива и означува; не проверува. Не следи пренасочувања: врска што води преку тракер или пренасочувач се прикажува како URL на пренасочувачот што навистина ја наведува; Reveal URLs не може да знае каде тоа пренасочување на крајот завршува. Кај врска без предупредување не е откриена никаква применлива неусогласеност, а не е потврдена како безбедна, затоа прочитајте го откриениот URL пред да ѝ верувате на врска, дури и кога ништо не е означено. За да го запомните тоа, откриениот URL на неозначена врска се прикажува во килибарна боја „за проверка“ наместо во смирувачки зелена.

Порака во Gmail со активен Reveal URLs: измамна врска е означена со црвено, а URL-от за следење до кој води е прикажан над текстот на врската, додека URL-от на врска без несовпаѓање се прикажува без предупредување.

Забелешка: адресите на е-пошта, URL-адресите и имињата на оваа слика од екранот се маскирани со ѕвездички за приватност.

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

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

Reveal URLs работи на:

Веб-прелистувачи:

Апликации за пошта:

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

Инсталирање

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

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

Веб-прелистувачи:

Апликации за пошта:

Вчитување на сопствен build (развивачи и рано тестирање)

Ако сте го изградиле Reveal URLs од изворниот код, можете директно да го вчитате распакуваниот build. Секој target се гради со команда 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 се опфаќа целата rendered email порака.

Reveal URLs означува порака во Gmail: URL-от на секоја врска е прикажан на свој ред над текстот на врската, а несогласувачка tracker врска е означена со црвено, додека врска без несовпаѓање се прикажува без предупредување.

Забелешка: адресите на е-пошта, URL-адресите и имињата на оваа слика од екранот се маскирани со ѕвездички за приватност.

Како се прикажува вистинската URL

Вистинската URL на секоја врска се прикажува на сопствен ред, веднаш над текстот на врската. Таа се става и во tooltip-от (title) на врската, така што целосната URL е секогаш таму кога го задржувате покажувачот над врската.

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

Кај веб-врските, Reveal URLs споредува URL или име на домаќин во видливиот текст на врската со URL-от кон кој таа води. Споредбата се прави на registrable доменот, така што поддомен без несовпаѓање како mail.example.com за example.com не се означува, а сличен како paypa1.com за paypal.com се означува. Проширувањето за прелистувач и Thunderbird исто така проверуваат врски за е-пошта, телефонски и непрозирни врски; врските javascript:, data: и vbscript: секогаш се означуваат.

Проверката го разгледува само URL-от што самата врска го наведува; пренасочувањата никогаш не се следат, па врска преку тракер или пренасочувач се споредува како негов URL, а не како страницата до која на крајот стигнува.

Несовпаѓањето се прикажува во избраната боја за несовпаѓање и со задебелени букви.

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

Страницата со поставки: избирачот за режимот 'Reveal the URL', прекинувачот 'Истакни несоодветни врски' и полињата 'Боја при несовпаѓање' и 'Боја без несовпаѓање'.

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

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

Додека Reveal URLs е вклучен, иконата во лентата со алатки на прелистувачот исто така ви кажува, по картичка, што пронашла на тековната страница. Ако страницата има непоклопувачки (слични на изглед) врски, иконата го прикажува тој број на црвена значка; ако страницата има врски, но ниту една не е непоклопувачка, го прикажува вкупниот број на анализирани врски на сива значка; страница без врски за анализа (и секоја страница на која додатокот не дејствува) не прикажува број. Секоја картичка ја задржува својата значка, па префрлањето меѓу картичките го ажурира бројот, а напуштањето на страницата или затворањето на картичката го брише. (Броевите над 99 се прикажуваат како 99+.)

Значката во нејзините состојби (прелистувачот ја црта, па точното поставување малку варира според прелистувачот): црвен број на непоклопувања, сив број на анализирани врски и значката OFF додека додатокот е оневозможен; неговото лого исто така е пригушено светлосиво. На страница каде овозможениот додаток не е активен нема значка; отсутната значка OFF го разликува истото пригушено лого од оневозможената состојба.

Овие илустрации не го покажуваат секој случај без значка; активна страница без врски што можат да се анализираат ја задржува иконата со нормална боја.

Икона во лентата со алатки што прикажува црвена значка со бројот на непоклопувачки врски на тековната страница Икона во лентата со алатки што прикажува сива значка со бројот на анализирани врски на тековната страница Икона во лентата со алатки со пригушено светлосиво лого без значка, додека овозможениот додаток не е активен на оваа страница Икона во лентата со алатки што ја прикажува црвената значка OFF додека додатокот е оневозможен

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

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

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

Освен главниот прекинувач Овозможи Reveal URLs и контролите Активни сајтови, кои се применуваат веднаш, промените се зачувуваат со копчето Зачувај поставки.

Долните поставки: листата 'Игнорирај ги овие хостови', максималната должина на прикажаниот URL и опционалните полиња за големина и дебелина на фонтот за прикажаниот URL, над копчето 'Зачувај поставки'.

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

Делот Активни сајтови на врвот од страницата со поставки ги наведува страниците на кои работи Reveal URLs. Сега одржува постојана висина: изберете еден сајт од паѓачкото мени и уредувајте ги само поставките на тој сајт во панелот подолу.

Горниот дел од страницата со поставки: главниот прекинувач 'Овозможи Reveal URLs' и делот 'Активни сајтови', со паѓачко мени 'Активна страница' над еден уредувач на избраниот сајт кој ги прикажува match pattern, прекинувачот 'Овозможено', прекинувачот 'Подрамки' и неговиот message-body selector.

Паѓачкото мени прикажува по еден запис за секое правило за сајт:

Уредувачот на избраниот сајт прикажува:

Вградените доставувачи (FastMail, Gmail, Outlook Live, Outlook 365, Proton, Tuta, Yahoo и Zoho) може да се исклучуваат или пренасочуваат, но не може да се отстрануваат. Нивните имиња исто така може да се преименуваат тука; бришењето на името на вграден доставувач го враќа неговото стандардно пријателско име.

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

  1. Под Додај сајт внесете URL за совпаѓање — match pattern како https://mail.example.com/*.
  2. По желба внесете Име за паѓачкото мени. Оставете го празно за да се користи match URL.
  3. Внесете Селектор за телото на пораката — CSS selector за container-от што го содржи телото на пораката, на пример .message-body.
  4. Ако телото на пораката се прикажува во подрамка, означете Извршувај и во подрамки.
  5. Кликнете Додај сајт. Вашиот прелистувач ќе побара дозвола за пристап до тој сајт. Дадете ја. Сајтот се додава дури откако дозволата ќе биде одобрена.

Промените тука се применуваат веднаш. Отстранувањето на сајт што сте го додале исто така ја поништува неговата дозвола, така што Reveal URLs престанува да пристапува до него. За да смените match URL на сајт, отстранете го и додадете го повторно: match-от останува само за читање затоа што е идентитетот на правилото.

Thunderbird (и други клиенти за пошта). Thunderbird веќе ја прикажува секоја порака што ја читате, без оглед на доставувачот, па затоа не му е потребна листа по host. Поради тоа делот Активни сајтови не се прикажува на страницата со поставки во Thunderbird. Таму се прикажуваат само главниот прекинувач, јазикот на прикажување, боите, фонтовите и листата за игнорирање. Секоја конфигурација на активни сајтови што можеби сте ја поставиле во прелистувачот останува недопрена. Зачувувањето на поставките во Thunderbird никогаш не ја брише.

Додатоците за Outlook и Gmail

Покрај проширувањето за прелистувач и додатокот за Thunderbird, Reveal URLs постои и како native додаток за две апликации за пошта до кои едно проширување за прелистувач не може да стигне: Outlook add-in и Gmail add-on. Тие ја делат http/https URL-/домаќин-препознавањето на проширувањето за прелистувач, но не ги анализираат неговите дополнителни шеми на врски.

Единствената разлика е во начинот на прикажување на наодите. Проширувањето за прелистувач ги означува врските на самото место, со обојување на URL-от над или покрај секоја врска. Outlook и Gmail framework-овите не ѝ дозволуваат на додатокот да ја менува прикажаната порака, па наместо тоа секој додаток прикажува страничен панел (Outlook) или картичка (Gmail) со пронајдените врски. За секоја http/https-врска се прикажуваат видливиот текст и URL-от и се означува несогласување само кога видливиот текст наведува URL или име на домаќин чиј registrable домен не се совпаѓа со оној на целта на врската.

Додатокот за Gmail сега е достапен преку Google Workspace Marketplace.

Јазици

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

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

Приватност

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

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

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

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

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

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

Доставувачите на webmail одвреме-навреме го менуваат markup-от на своите страници. Ако selector-от на вграден доставувач престане да се совпаѓа по таква промена, можете сами да го исправите: во Активни сајтови уредете го message-body selector-от на тој доставувач, така што да покажува кон новиот container.

Лиценца и изворен код

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

Белешки за Safari

Safari прикажува значка само кога врските не се совпаѓаат; нема сив бројач за безбедна страница. Отворете ги поставките повторно од менито со десен клик Reveal URLs — settings, наместо да вчитате стара картичка со поставки.