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 от магазина за вашия браузър или пощенски клиент. Всички обяви вече са налични; 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 или имена на host във видимия текст на връзката с URL адреса, към който тя сочи. Сравнението се прави върху registrable домейна, така че поддомейн без несъответствие като mail.example.com за example.com не се маркира, а host look-alike като paypa1.com за paypal.com се маркира. Разширението за браузър и Thunderbird проверяват също имейл, телефонни и непрозрачни връзки; връзките javascript:, data: и vbscript: винаги се маркират.

Проверката разглежда само URL адреса, посочен от самата връзка; пренасочванията никога не се следват, затова връзка през тракер или пренасочвач се сравнява като негов URL адрес, а не като страницата, до която в крайна сметка стига.

Несъответствието се показва с избрания от вас цвят за mismatch и с удебелен текст.

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

Страницата с настройки: изборът за режим '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 адреси и host-ове на разширението за браузър, но не анализират допълнителните му схеми за връзки.

Единствената разлика е в начина, по който показват своите находки. Разширението за браузър маркира връзките на място, като оцветява URL-а над или до всяка връзка. Outlook и Gmail framework-овете не позволяват на добавката да променя показаното съобщение, затова вместо това всяка добавка показва страничен панел (Outlook) или карта (Gmail) със списък на откритите връзки. За всяка http/https връзка се показват видимият текст и URL-ът на дестинацията и се маркира несъответствие само когато видимият текст посочва URL адрес или име на host, чийто 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, вместо да презареждате стар раздел с настройки.