Reveal URLs — Naudotojo vadovas
Reveal URLs yra nedidelis naršyklės plėtinys ir Thunderbird priedas, kuris parodo, kur iš tikrųjų veda nuoroda jūsų el. laiške, kad galėtumėte atpažinti phishing nuorodą dar prieš ją paspausdami.
Šiame vadove paaiškinta, kaip įdiegti Reveal URLs ir kaip juo naudotis. Apie tai, kaip tvarkomi jūsų duomenys, skaitykite privatumo politikoje. Techninę apžvalgą, kaip sukurtas plėtinys, rasite architektūros apžvalgoje.
Radote klaidą, neteisingai pažymėtą nuorodą arba webmail host, kuris turėtų būti palaikomas? Praneškite apie tai Codeberg issue tracker.
Turinys
- Ką jis daro ir kodėl
- Palaikomos naršyklės ir pašto klientas
- Diegimas
- Naudojimas
- Outlook ir Gmail priedai
- Kalbos
- Privatumas
- Trikčių šalinimas
- Licencija ir išeities kodas
Ką jis daro ir kodėl
Phishing laiškas slepia kenkėjišką tikslą už patikimai atrodančio nuorodos
teksto. Kartais tai būna host, kuris tik primena tikrąjį: tekstas rodo
paypal.com, o nuoroda iš tiesų veda į paypa1.com. Dažnai triukas yra
subtilesnis ir eina per tracker arba redirector, todėl vieta, į kurią
pakliūvate, beveik niekuo neprimena tekste paminėto prekės ženklo.

parcel-pay.custom.co.xa, o ne į Lietuvos paštą.Pastaba: Šioje ekrano nuotraukoje matomas apgaulingas sukčiavimo el. laiškas, apsimetantis Lietuvos paštu. Lietuvos paštas nėra susijęs su Reveal URLs ir jo neremia.
Reveal URLs perskaito kiekvieną nuorodą žinutėje, kurią žiūrite, ir parodo URL, į kurį ji veda. Kai host, nurodytas matomame nuorodos tekste, nesutampa su host, į kurį nuoroda iš tiesų veda, Reveal URLs tai pažymi, kad neatitikimas būtų aiškiai matomas dar prieš paspaudžiant.
Naršyklės plėtinyje ir Thunderbird priede viskas vyksta jūsų įrenginyje, o niekas nėra perduodama. Jokia Reveal URLs forma nesiunčia jūsų el. pašto duomenų mums ar trečiosioms šalims: nėra analytics ir nėra tracking. Skirtingos formos skiriasi tik tuo, kur jos vykdomos ir kaip pateikiamas Outlook skydelio kodas. Išsamią informaciją rasite skiltyje Privatumas ir privatumo politikoje.
Palaikomos naršyklės ir pašto klientas
Reveal URLs veikia:
- Google Chrome
- Microsoft Edge
- Opera
- Mozilla Firefox
- Mozilla Thunderbird (darbalaukio pašto klientas)
Safari versija dar neišleista. Ji planuojama vėlesniame etape.
Naršyklėse Reveal URLs pažymi nuorodas jūsų webmail žinutėse. Thunderbird jis pažymi nuorodas tiesiogiai el. laiške, kurį skaitote pačiame kliente.
Diegimas
Iš jūsų naršyklės arba pašto kliento parduotuvės (rekomenduojama)
Įdiekite Reveal URLs iš savo naršyklės arba pašto kliento parduotuvės. Chrome, Edge, Firefox ir Thunderbird įrašai jau paskelbti. Opera naudoja Chrome build, o atskiras Opera įrašas dar tik ruošiamas:
- Chrome — the Chrome Web Store
- Edge — Microsoft Edge Add-ons
- Opera — įdiekite Chrome versiją iš the Chrome Web Store. Atskiras Opera įrašas pasirodys netrukus
- Firefox — Firefox Add-ons (AMO)
- Thunderbird — Thunderbird Add-ons (ATN)
Savo build įkėlimas (kūrėjams ir ankstyvam testavimui)
Jei Reveal URLs susikūrėte iš išeities kodo, galite tiesiogiai įkelti
išpakuotą build. Kiekvienas target kuriamas komanda make ir sugeneruojamas
aplanke 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
Tada įkelkite atitinkamą aplanką:
- Chrome — atidarykite
chrome://extensions, įjunkite Developer mode, spustelėkite Load unpacked ir pasirinkitedist/chrome. - Edge — atidarykite
edge://extensions, įjunkite Developer mode, spustelėkite Load unpacked ir pasirinkitedist/edge. - Opera — atidarykite
opera://extensions, įjunkite Developer mode, spustelėkite Load unpacked ir pasirinkitedist/opera. - Firefox — atidarykite
about:debugging, pasirinkite This Firefox, spustelėkite Load Temporary Add-on ir pasirinkite bet kurį failą katalogedist/firefox, pavyzdžiui,manifest.json. Laikinas priedas pašalinamas, kai Firefox paleidžiama iš naujo. - Thunderbird — įdiekite laikiną priedą iš
dist/thunderbirdtokiu pat būdu per Tools → Developer Tools → Debug Add-ons → Load Temporary Add-on.
Nustatymų puslapis automatiškai atsidaro pirmą kartą įdiegus plėtinį.
Naudojimas
Vos įdiegus, Reveal URLs pažymi nuorodas įmontuotų paslaugų laiškuose be papildomo nustatymo:
- Gmail (
mail.google.com) - Outlook Live (
outlook.live.com) - Outlook on the web / Microsoft 365 (
outlook.office.com) - Proton Mail (
mail.proton.me)
Žymėjimas apsiriboja žinutės turiniu, todėl likęs programos chrome, kaip šoninė juosta, rašymo langas ir įrankių juostos, lieka nepaliesti. Thunderbird aplinkoje apimamas visas rendered email.
Du atskleidimo režimai
Nustatymų puslapyje, skiltyje Reveal the URL, pasirenkate, kaip bus rodomas tikrasis URL:
- Inline — tikrasis URL rodomas atskiroje eilutėje tiesiai virš nuorodos teksto. Tai numatytoji reikšmė.
- In the link's tooltip (title) — tikrasis URL įdedamas į nuorodos tooltip ir tampa matomas, kai ant jos užlaikote žymeklį.
Neatitikimų paryškinimas
Kai host, nurodytas matomame nuorodos tekste, nesutampa su host, į kurį
nuoroda iš tikrųjų veda, Reveal URLs pažymi tai kaip neatitikimą.
Palyginimas atliekamas pagal registrable domeną, todėl sąžiningas
sub-domain, pavyzdžiui, mail.example.com domenui example.com, nėra
pažymimas, tačiau look-alike host, pavyzdžiui, paypa1.com domenui
paypal.com, yra pažymimas.
- Inline režimu neatitikimas rodomas jūsų pasirinkta mismatch spalva ir paryškintu tekstu.
- Tooltip (title) režimu prie nuorodos pridedama aiški ⚠ URL mismatch žyma.
Tai valdo du susiję nustatymai:
- Highlight mismatching links įjungia arba išjungia neatitikimų paryškinimą.
- Only annotate mismatching links palieka sąžiningas nuorodas visiškai nepaliestas, kad būtų atskleidžiamos tik įtartinos.
Įrankių juostos mygtukas
Chrome, Edge, Opera, Firefox ir Thunderbird programose Reveal URLs įrankių juostos piktograma yra greitas įjungimo / išjungimo jungiklis — spustelėkite ją, kad perjungtumėte anotavimą. Kai plėtinys išjungtas, ant piktogramos atsiranda ženklelis OFF, o jo paaiškinimas nurodo, ar spustelėjimas jį įjungs, ar išjungs. Naršyklėse pakeitimas iš karto įsigalioja visuose atidarytuose skirtukuose; Thunderbird programoje jis taikomas kitam jūsų atidarytam laiškui.
(Thunderbird programoje mygtukas rodo tik savo piktogramą, todėl vieningoje įrankių juostoje išlieka kompaktiškas. Reveal URLs taip pat galite įjungti ir išjungti nustatymų puslapyje esančiu jungikliu Enable.)
Nustatymų puslapis
Nustatymų puslapyje yra visos parinktys. Atidarykite jį iš savo naršyklės plėtinių puslapio, pavyzdžiui, per Details → Extension options, arba jis pats atsidarys pirmojo diegimo metu.
- Enable Reveal URLs — pagrindinis įjungimo ir išjungimo jungiklis puslapio viršuje. Jis įsigalioja iškart, nereikalaujant išsaugoti likusios formos.
- Display language — pasirinkite kalbą, kuria bus rodomas nustatymų puslapis. Pagal numatymą jis seka jūsų naršyklės kalbą ir grįžta prie anglų kalbos, jei jūsų kalba nepalaikoma. Galite tai perrašyti pasirinkdami kitą kalbą iš sąrašo. Jūsų pasirinkimas įsigalioja iškart, įsimenamas ir išsaugomas tik šiame įrenginyje.
- Reveal the URL — pasirinkite inline arba tooltip (title) režimą, kaip aprašyta aukščiau.
- Highlight mismatching links — įjunkite arba išjunkite neatitikimų paryškinimą.
- Mismatch colour — CSS spalva pažymėtai nuorodai, pavyzdžiui,
red,#cc0000arbargb(200, 0, 0). Numatytoji spalva yra raudona. - Match colour — atskleisto URL spalva sąžiningoms nuorodoms be
neatitikimo, pavyzdžiui,
blackarba#1a1a1a. Pagal nutylėjimą tai neutrali labai tamsiai pilka (#1a1a1a). - Only annotate mismatching links — palikite sąžiningas nuorodas nepaliestas.
- Ignore these hosts — hostnames sąrašas, kuriuos reikia visiškai praleisti, po vieną kiekvienoje eilutėje. Praleidžiami ir išvardyto host sub-domain.
- Maximum displayed URL length — ilgi URL sutrumpinami po šio simbolių skaičiaus, paliekant host matomą. Leidžiamas intervalas: nuo 20 iki 2000.
- Revealed URL font size / weight ir Warning badge font size / weight — pasirenkami tipografijos pakeitimai. Palikite tuščia, jei norite išsaugoti numatytąsias reikšmes.
Be pagrindinio Enable jungiklio ir Active sites valdiklių, kurie pritaikomi iškart, pakeitimai išsaugomi mygtuku Save settings.
Aktyvios svetainės — savo webmail pridėjimas
Nustatymų puslapio viršuje esanti skiltis Active sites išvardija puslapius, kuriuose veikia Reveal URLs, ir container, kuriame yra kiekvieno pranešimo turinys.
Kiekviena eilutė rodo:
- svetainės match pattern, pavyzdžiui,
https://mail.example.com/* - jungiklį Enabled
- message-body selector, tai yra CSS selector container, kurį Reveal URLs žymi ir kurį galite redaguoti
- jungiklį Sub-frames, svetainėms, kurių pranešimo turinys rodomas iframe
- mygtuką Remove, tik jūsų pačių pridėtoms svetainėms
Įmontuotas paslaugas, tokias kaip Gmail, Outlook ir Proton, galima išjungti arba peradresuoti, tačiau jų negalima pašalinti.
Norėdami pridėti savo webmail svetainę:
- Skiltyje Add site įveskite Match URL — match pattern, pvz.,
https://mail.example.com/*. - Įveskite Message-body selector — CSS selector container, kuriame yra
pranešimo turinys, pavyzdžiui,
.message-body. - Jei pranešimo turinys rodomas po-rėmyje, pažymėkite Also run inside sub-frames.
- Spustelėkite Add site. Jūsų naršyklė paprašys leidimo šiai svetainei. Suteikite jį. Svetainė pridedama tik tada, kai leidimas patvirtinamas.
Pakeitimai čia pritaikomi iškart. Jūsų pridėtos svetainės pašalinimas taip pat atšaukia jos leidimą, todėl Reveal URLs prie jos daugiau nebeprieina.
Thunderbird (ir kiti pašto klientai). Thunderbird jau rodo kiekvieną jūsų skaitomą pranešimą nepriklausomai nuo paslaugos teikėjo, todėl jam nereikia host pagrįsto sąrašo. Dėl to Active sites skiltis Thunderbird nustatymų puslapyje nerodoma. Ten rodomas tik pagrindinis jungiklis, rodymo kalba, atskleidimo režimas, spalvos, šriftai ir ignoravimo sąrašas. Bet kokia aktyvių svetainių konfigūracija, kurią galbūt nustatėte naršyklėje, lieka nepaliesta. Nustatymų išsaugojimas Thunderbird jos niekada neišvalo.
Outlook ir Gmail priedai
Be naršyklės plėtinio ir Thunderbird priedo, Reveal URLs taip pat pateikiamas kaip native priedas dviem pašto programoms, kurių naršyklės plėtinys negali pasiekti: Outlook add-in ir Gmail add-on. Abu naudoja tą patį nuorodų aptikimą kaip ir plėtinys, todėl atskleidžia tuos pačius URL ir pažymi tuos pačius look-alike host.
Vienintelis skirtumas yra tai, kaip jie pateikia radinius. Naršyklės plėtinys pažymi nuorodas vietoje, nuspalvindamas URL virš kiekvienos nuorodos arba šalia jos. Outlook ir Gmail karkasai neleidžia priedui keisti rodomo pranešimo, todėl vietoje to kiekvienas priedas rodo šoninį skydelį (Outlook) arba kortelę (Gmail) su rastomis nuorodomis. Kiekvienai nuorodai rodomas matomas tekstas, paskirties URL ir registrable host, o mismatch pažymimas tada, kai matomas tekstas įvardija kitą registrable domeną nei tas, į kurį nuoroda iš tiesų veda.
- Outlook add-in — task pane, kuris perskaito atidarytą pranešimą ir analizuoja jį jūsų įrenginyje. Jokie el. pašto ar pranešimo duomenys niekur nesiunčiami. Task pane kodas, tai yra HTML, JavaScript, CSS ir piktogramos, įkeliamas iš https://www.reveal-urls.eu per HTTPS, kaip ir bet kuris kitas tinklalapis. Jis apima Outlook on the web, Windows, Mac, iOS, Android ir Outlook.com.
- Gmail add-on — kortelė Gmail šoninėje juostoje. Atidarykite pranešimą ir tada spustelėkite Reveal URLs piktogramą dešinėje šoninėje juostoje, kad pamatytumėte jo nuorodas. Gmail kortelės pats neatidaro, tačiau jei paliksite skydelį atidarytą, jis atsinaujins judant tarp pranešimų. Kiekvienos nuorodos URL sąžiningos nuorodos atveju rodomas neutralia tamsiai pilka spalva, o look-alike atveju — raudonai. Tai apima Gmail web versijoje, Android ir iOS. Skirtingai nei kitos formos, Gmail add-on veikia Google serveriuose — taip veikia Gmail priedai. Atidarytas pranešimas ten perskaitomas ir patikrinamas kiekvieną kartą, kai jį atidarote, ir nėra išsaugomas. Žiūrėkite privatumo politiką, kad matytumėte, prie ko kiekviena forma prieina ir ką ji saugo.
Abu priedai bus platinami per savo programėlių parduotuves: Outlook add-in per Microsoft AppSource, o Gmail add-on per Google Workspace Marketplace. Publikavimas dar vyksta. Tiesioginės įdiegimo nuorodos bus pridėtos čia, kai tik kiekvienas įrašas taps aktyvus.
Kalbos
Reveal URLs galima naudoti anglų ir daugeliu kitų kalbų.
- Nustatymų puslapis automatiškai seka jūsų naršyklės kalbą ir grįžta prie anglų kalbos, jei jūsų kalba nepalaikoma. Bet kada galite tai pakeisti parinktimi Display language puslapio viršuje. Jūsų pasirinkimas įsimenamas šiame įrenginyje. Žr. Nustatymų puslapis.
- Ši svetainė, tai yra pradinis puslapis ir šie dokumentacijos puslapiai, taip pat atpažįsta jūsų naršyklės kalbą ir antraštėje siūlo kalbos perjungiklį. Vadovas ir privatumo puslapiai yra išversti. Jei kurio nors puslapio vertimo dar nėra, rodoma anglų versija.
Neangliškas tekstas yra išverstas automatiškai ir laukia žmogaus peržiūros, todėl kai kurios formuluotės kartais gali skambėti nejaukiai. Tikslas yra išlaikyti tą pačią prasmę kaip anglų originalo. Jei pastebite neteisingą vertimą, atidarykite issue Codeberg issue tracker.
Privatumas
Reveal URLs nesiunčia jūsų el. pašto ar pranešimo duomenų mums ar trečiosioms šalims jokia savo forma. Nėra analytics ir nėra tracking. Kur ir kaip darbas atliekamas, priklauso nuo formos:
- Naršyklės plėtinys ir Thunderbird priedas veikia visiškai jūsų įrenginyje ir nieko neperduoda. Jie skaito nuorodų tekstą, URL ir puslapio spalvas renderinimo metu, jų nesaugodami ir nesiųsdami.
- Outlook add-in analizuoja atidarytą pranešimą jūsų įrenginyje ir niekur nesiunčia jokių el. pašto ar pranešimo duomenų. Jo task pane kodas, t. y. HTML, JavaScript, CSS ir piktogramos, įkeliamas iš https://www.reveal-urls.eu per HTTPS kaip ir bet kuris kitas tinklalapis.
- Gmail add-on veikia Google serveriuose — taip veikia Gmail priedai. Atidarytas pranešimas ten perskaitomas ir patikrinamas kiekvieną kartą, kai jį atidarote, ir nėra išsaugomas.
Vienintelis dalykas, kuris saugomas, yra jūsų pačių nustatymai, tokie kaip Reveal URLs įjungimas arba išjungimas, atskleidimo režimas, spalvos, šriftų dydžiai, jūsų ignoravimo sąrašas ir visos pridėtos svetainės. Jie saugomi jūsų naršyklės, Outlook arba Google per-user storage ir niekada nesiunčiami mums.
Išsamią informaciją rasite privatumo politikoje.
Trikčių šalinimas
Kažkuri nuoroda neatskleidžiama.
- Patikrinkite, ar Reveal URLs įjungtas. Įrankių juostos piktograma neturi rodyti ženklo OFF, o jungiklis Enable Reveal URLs nustatymų puslapyje turi būti įjungtas.
- Patikrinkite, ar svetainė yra apimta. Įmontuotos paslaugos Gmail, Outlook ir Proton veikia iškart. Bet kuri kita webmail svetainė turi būti pridėta skiltyje Active sites su savo match URL ir message-body selector.
- Patikrinkite message-body selector. Jei jis nesutampa su container, kuriame yra laiško turinys, to container nuorodos nebus atskleistos.
- Atminkite, kad nuorodos į puslapio inkarus ir nuorodos, kurios naudoja
scheme'us, kitokius nei
http/https, pavyzdžiui,mailto:, tyčia praleidžiamos. Tas pats taikoma ir host jūsų sąraše Ignore these hosts.
Įmontuota paslauga nustojo veikti po perprojektavimo.
Webmail paslaugos kartais keičia savo puslapių markup. Jei įmontuotos paslaugos selector po tokio pakeitimo nebetinka, galite jį pataisyti patys: skiltyje Active sites paredaguokite tos paslaugos message-body selector, kad jis rodytų į naują container.
Tooltip URL nerodomas.
Tooltip (title) režimu tikrasis URL įdedamas į nuorodos tooltip, todėl jis matomas tik tada, kai ant jos laikote žymeklį. Jei norite matyti URL be hover, perjunkite Reveal the URL į inline režimą.
Licencija ir išeities kodas
Reveal URLs yra laisva programinė įranga, licencijuota pagal GNU Affero General Public License v3.0 (AGPL-3.0-only).
- Išeities kodas: https://codeberg.org/Magentron/reveal-urls
- Techninė apžvalga: Architecture
- Daugiau apie phishing nuorodas: Email link phishing: your app should always show the URL




