Reveal URLs — Kasutusjuhend
Reveal URLs on väike brauserilaiendus ja Thunderbirdi lisand, mis näitab, kuhu üks link teie e-kirjas tegelikult viib, et saaksite phishing-lingi ära tunda enne sellel klõpsamist.
See juhend selgitab, kuidas Reveal URLs paigaldada ja kuidas seda kasutada. Teie andmete käsitlemise kohta vaadake privaatsuspoliitikat. Tehnilise ülevaate saamiseks selle kohta, kuidas laiendus on ehitatud, vaadake arhitektuuri ülevaadet.
Leidsid vea, valesti märgistatud lingi või webmaili host-i, mis peaks olema toetatud? Anna sellest teada Codeberg issue tracker.
Sisukord
- Mida see teeb ja miks
- Toetatud brauserid ja meiliklient
- Paigaldamine
- Kasutamine
- Outlooki ja Gmaili lisad
- Keeled
- Privaatsus
- Tõrkeotsing
- Litsents ja lähtekood
Mida see teeb ja miks
Phishing-kiri peidab pahatahtliku sihtkoha usaldusväärsena näiva lingiteksti
taha. Mõnikord on see host, mis meenutab tõelist: tekst näitab
paypal.com, kuid link viib aadressile paypa1.com. Sageli on trikk
peenem ja käib läbi tracker-i või redirector-i, nii et koht, kuhu lõpuks
jõuate, ei sarnane peaaegu üldse tekstis nimetatud brändiga.

parcel-pay.custom.co.xa, mitte Omniva lehele.Märkus: See kuvatõmmis näitab petlikku andmepüügimeili, mis esineb Omniva nimel. Omniva ei ole Reveal URLs-iga seotud ega toeta seda.
Reveal URLs loeb läbi kõik vaadatavas kirjas olevad lingid ja näitab URL-i, kuhu iga link osutab. Kui lingi nähtavas tekstis nimetatud host ei ühti host-iga, kuhu link tegelikult läheb, märgib Reveal URLs selle ära, nii et ebakõla on nähtav juba enne klõpsamist.
Brauserilaienduses ja Thunderbirdi lisas toimub kõik teie enda seadmes ning midagi ei edastata. Üheski vormis ei saada Reveal URLs teie e-posti andmeid meile ega kolmandatele osapooltele: analytics puudub ja tracking puudub. Vormid erinevad ainult selle poolest, kus need töötavad ja kuidas Outlooki paneeli kood serveeritakse. Täpsemad üksikasjad leiate jaotisest Privaatsus ning privaatsuspoliitikast.
Toetatud brauserid ja meiliklient
Reveal URLs töötab järgmistes keskkondades:
- Google Chrome
- Microsoft Edge
- Opera
- Mozilla Firefox
- Mozilla Thunderbird (lauaarvuti meiliklient)
Safari versiooni ei ole veel välja antud. See on planeeritud hilisemasse etappi.
Brauserites märgistab Reveal URLs teie webmaili sõnumites olevaid linke. Thunderbirdis märgistab see lingid otse loetavas e-kirjas.
Paigaldamine
Brauseri või meilikliendi poest (soovitatav)
Paigaldage Reveal URLs oma brauseri või meilikliendi poest. Chrome'i, Edge'i, Firefoxi ja Thunderbirdi kirjed on juba avaldatud. Opera kasutab Chrome'i build-i ning eraldi Opera kirje on veel tulekul:
- Chrome — the Chrome Web Store
- Edge — Microsoft Edge Add-ons
- Opera — paigaldage Chrome'i versioon the Chrome Web Store kaudu. Eraldi Opera kirje tuleb peagi
- Firefox — Firefox Add-ons (AMO)
- Thunderbird — Thunderbird Add-ons (ATN)
Oma build-i laadimine (arendajad ja varajane testimine)
Kui olete Reveal URLs-i lähtekoodist ehitanud, saate pakkimata build-i
otse laadida. Iga target ehitatakse käsuga make ja luuakse kausta
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
Seejärel laadige vastav kaust:
- Chrome — avage
chrome://extensions, lülitage sisse Developer mode, klõpsake Load unpacked ja valigedist/chrome. - Edge — avage
edge://extensions, lülitage sisse Developer mode, klõpsake Load unpacked ja valigedist/edge. - Opera — avage
opera://extensions, lülitage sisse Developer mode, klõpsake Load unpacked ja valigedist/opera. - Firefox — avage
about:debugging, valige This Firefox, klõpsake Load Temporary Add-on ja valige mõni fail kaustasdist/firefox, näiteksmanifest.json. Ajutine lisand eemaldatakse, kui Firefox taaskäivitub. - Thunderbird — paigaldage ajutine lisand kaustast
dist/thunderbirdsamal viisil menüü kaudu Tools → Developer Tools → Debug Add-ons → Load Temporary Add-on.
Seadete leht avaneb automaatselt laienduse esimesel paigaldamisel.
Kasutamine
Kohe pärast paigaldamist märgistab Reveal URLs sisseehitatud teenuste sõnumites olevaid linke ilma täiendava seadistamiseta:
- Gmail (
mail.google.com) - Outlook Live (
outlook.live.com) - Outlook on the web / Microsoft 365 (
outlook.office.com) - Proton Mail (
mail.proton.me)
Märgistamine on piiratud sõnumi sisuga, nii et rakenduse ülejäänud chrome, nagu külgriba, koostamisaken ja tööriistaribad, jäävad puutumata. Thunderbirdis on hõlmatud kogu rendered email.
Kaks kuvamisrežiimi
Seadete lehel jaotises Reveal the URL valite, kuidas tegelik URL kuvatakse:
- Inline — tegelik URL kuvatakse oma real vahetult lingiteksti kohal. See on vaikeväärtus.
- In the link's tooltip (title) — tegelik URL paigutatakse lingi tooltip-i ja ilmub nähtavale, kui hoiate hiirekursorit selle kohal.
Ebakõlade esiletõstmine
Kui lingi nähtavas tekstis nimetatud host ei ühti host-iga, kuhu link
tegelikult osutab, märgib Reveal URLs selle ebakõlana. Võrdlus toimub
registrable domeeni põhjal, seega aus alamdomeen nagu mail.example.com
aadressi example.com jaoks ei saa märget, kuid look-alike host nagu
paypa1.com aadressi paypal.com jaoks saab.
- Inline režiimis kuvatakse ebakõla teie valitud mismatch-värviga ja paksus kirjas.
- Tooltip (title) režiimis lisatakse lingi kõrvale selge ⚠ URL mismatch märgis.
Seda juhivad kaks seotud seadistust:
- Highlight mismatching links lülitab ebakõlade rõhutamise sisse või välja.
- Only annotate mismatching links jätab ausad lingid täiesti puutumata, nii et nähtavale tuuakse ainult kahtlased.
Tööriistariba nupp
Chrome'is, Edge'is, Operas, Firefoxis ja Thunderbirdis on Reveal URLs tööriistaribaikoon kiire sisse/välja-lüliti — klõpsa sellel, et annotatsiooni ümber lülitada. Kui laiendus on välja lülitatud, ilmub ikoonile märk OFF ja selle kohtspikker ütleb, kas klõps lülitab selle sisse või välja. Brauserites jõustub muudatus kõigis avatud kaartides korraga; Thunderbirdis rakendub see järgmisele sõnumile, mille avad.
(Thunderbirdis näitab nupp ainult oma ikooni, nii et see jääb ühendatud tööriistaribal kompaktseks. Samuti saab Reveal URLs sisse ja välja lülitada seadete lehel oleva lülitiga Enable.)
Seadete leht
Seadete leht sisaldab kõiki valikuid. Avage see brauseri laienduste lehelt, näiteks käsu Details → Extension options kaudu, või see avaneb ise esimesel paigaldamisel.
- Enable Reveal URLs — peamine sisse-välja lüliti lehe ülaosas. See rakendub kohe, ilma et peaks ülejäänud vormi salvestama.
- Display language — valige keel, milles seadete leht kuvatakse. Vaikimisi järgib see teie brauseri keelt ja naaseb inglise keele juurde, kui teie keel ei ole toetatud. Võite selle loendist muu keelega üle kirjutada. Teie valik rakendub kohe, jäetakse meelde ja salvestatakse ainult selles seadmes.
- Reveal the URL — valige inline või tooltip (title) režiim, nagu eespool kirjeldatud.
- Highlight mismatching links — lülitage ebakõlade rõhutamine sisse või välja.
- Mismatch colour — CSS-värv märgistatud lingi jaoks, näiteks
red,#cc0000võirgb(200, 0, 0). Vaikevärv on punane. - Match colour — ausa lingi puhul kuvatava URL-i värv, näiteks
blackvõi#1a1a1a. Vaikimisi on see neutraalne väga tume hall (#1a1a1a). - Only annotate mismatching links — jätke ausad lingid puutumata.
- Ignore these hosts — loend hostnames-idest, mida tuleb täielikult vahele jätta, üks rea kohta. Vahele jäetakse ka loetletud host-i alamdomeenid.
- Maximum displayed URL length — pikad URL-id kärbitakse pärast seda tähemärkide arvu, host jääb nähtavaks. Lubatud vahemik: 20 kuni 2000.
- Revealed URL font size / weight ja Warning badge font size / weight — valikulised tüpograafilised ülekirjutused. Vaikeväärtuste säilitamiseks jätke tühjaks.
Lisaks peamisele Enable lülitile ja kontrollidele Active sites, mis rakenduvad kohe, salvestatakse muudatused nupuga Save settings.
Aktiivsed saidid — oma webmaili lisamine
Seadete lehe ülaosas asuv jaotis Active sites loetleb lehed, millel Reveal URLs töötab, ja container-i, mis sisaldab iga sõnumi sisu.
Iga rida näitab:
- saidi match pattern-it, näiteks
https://mail.example.com/* - lülitit Enabled
- message-body selector-it ehk CSS selector-it container-i jaoks, mida Reveal URLs märgistab ja mida saate muuta
- lülitit Sub-frames, saitide jaoks, mille sõnumi sisu kuvatakse iframe-is
- nuppu Remove, ainult teie endi lisatud saitide jaoks
Sisseehitatud teenuseid nagu Gmail, Outlook ja Proton saab välja lülitada või ümber suunata, kuid mitte eemaldada.
Oma webmaili lisamiseks:
- Sisestage jaotises Add site Match URL — match pattern nagu
https://mail.example.com/*. - Sisestage Message-body selector — CSS selector container-i jaoks,
mis hoiab sõnumi sisu, näiteks
.message-body. - Kui sõnumi sisu kuvatakse alamraamis, märkige Also run inside sub-frames.
- Klõpsake Add site. Teie brauser küsib selle saidi jaoks luba. Andke see. Sait lisatakse alles pärast loa kinnitamist.
Siinsed muudatused rakenduvad kohe. Teie lisatud saidi eemaldamine tühistab ka selle loa, nii et Reveal URLs ei pääse sellele enam ligi.
Thunderbird (ja teised meilikliendid). Thunderbird näitab juba kõiki loetavaid sõnumeid olenemata teenusepakkujast, seega ei vaja ta host-i põhist loendit. Seepärast ei kuvata Active sites jaotist Thunderbirdi seadete lehel. Seal kuvatakse ainult peamine lüliti, kuvakeel, avastamisrežiim, värvid, fondid ja ignoreerimisloend. Iga aktiivsete saitide seadistus, mille võisite brauseris teha, jääb puutumata. Thunderbirdis seadete salvestamine ei tühjenda seda kunagi.
Outlooki ja Gmaili lisad
Lisaks brauserilaiendusele ja Thunderbirdi lisale on Reveal URLs olemas ka native lisadena kahele meilirakendusele, kuhu brauserilaiendus ei ulatu: Outlook add-in ja Gmail add-on. Mõlemad kasutavad sama lingituvastust kui laiendus, seega paljastavad nad samad URL-id ja märgistavad samad look-alike host-id.
Ainus erinevus on selles, kuidas nad tulemusi näitavad. Brauserilaiendus märgistab lingid kohapeal, värvides URL-i iga lingi kohal või kõrval. Outlooki ja Gmaili raamistikud ei luba lisal renderdatud sõnumit muuta, nii et kumbki lisand näitab selle asemel külgpaneeli (Outlook) või kaarti (Gmail) leitud linkidega. Iga lingi puhul kuvatakse nähtav tekst, siht-URL ja registrable host ning mismatch märgitakse siis, kui nähtav tekst nimetab teist registrable domeeni kui see, kuhu link tegelikult osutab.
- Outlook add-in — task pane, mis loeb avatud sõnumit ja analüüsib seda teie seadmes. Mingeid e-kirja või sõnumi andmeid ei saadeta kuhugi. Task pane'i kood, st HTML, JavaScript, CSS ja ikoonid, laaditakse Codeberg Pages-ist üle HTTPS-i, nagu iga muu veebileht. See katab Outlook on the web, Windowsi, Maci, iOS-i, Androidi ja Outlook.com-i.
- Gmail add-on — kaart Gmaili külgribal. Avage sõnum ja klõpsake siis paremas külgribas Reveal URLs-i ikooni, et näha selle linke. Gmail ei ava kaarti ise, kuid kui jätate paneeli lahti, värskendub see sõnumite vahel liikudes. Iga lingi URL kuvatakse ausa lingi puhul neutraalses tumedas hallis ja look-alike puhul punases. See katab Gmaili web-is, Androidis ja iOS-is. Erinevalt teistest vormidest töötab Gmail add-on Google'i serverites, nii Gmaili lisad toimivadki. Avatud sõnum loetakse ja kontrollitakse seal iga kord, kui selle avate, ning seda ei säilitata. Vaadake privaatsuspoliitikast, millele iga vorm ligi pääseb ja mida ta salvestab.
Mõlemad lisad levitatakse nende rakenduspoodide kaudu: Outlook add-in Microsoft AppSource'i kaudu ja Gmail add-on Google Workspace Marketplace'i kaudu. Avaldamine on veel pooleli. Otsesed paigalduslingid lisatakse siia kohe, kui kumbki kirje on aktiivne.
Keeled
Reveal URLs on saadaval inglise keeles ja paljudes teistes keeltes.
- Seadete leht järgib automaatselt teie brauseri keelt ja naaseb inglise keele juurde, kui teie keel ei ole toetatud. Seda saate igal ajal muuta valijaga Display language lehe ülaosas. Teie valik jäetakse selles seadmes meelde. Vaadake Seadete leht.
- See veebisait, st avaleht ja need dokumentatsioonilehed, tuvastab samuti teie brauseri keele ja pakub päises keelevalijat. Juhend ja privaatsuslehed on tõlgitud. Kui mingi lehe tõlge veel puudub, kuvatakse ingliskeelne versioon.
Mitteingliskeelne tekst on masintõlgitud ja ootab inimülevaatust, seega mõni sõnastus võib aeg-ajalt kohmakas tunduda. Eesmärk on, et tähendus langeks kokku ingliskeelse originaaliga. Kui märkate valet tõlget, avage issue aadressil Codeberg issue tracker.
Privaatsus
Reveal URLs ei saada üheski oma vormis teie e-kirja ega sõnumi andmeid meile ega kolmandatele osapooltele. Analytics puudub ja tracking puudub. See, kus ja kuidas töö tehakse, sõltub vormist:
- Brauserilaiendus ja Thunderbirdi lisand töötavad täielikult teie seadmes ega edasta midagi. Nad loevad lingiteksti, URL-e ja lehe värve renderdamise ajal, ilma neid salvestamata või saatmata.
- Outlook add-in analüüsib avatud sõnumit teie seadmes ega saada kuhugi mingeid e-kirja või sõnumi andmeid. Selle task pane'i kood, st HTML, JavaScript, CSS ja ikoonid, laaditakse aadressilt https://www.reveal-urls.eu üle HTTPS-i nagu iga teine veebileht.
- Gmail add-on töötab Google'i serverites, nii Gmaili lisad toimivadki. Avatud sõnum loetakse ja kontrollitakse seal iga kord, kui selle avate, ning seda ei säilitata.
Ainus asi, mida salvestatakse, on teie enda seaded, nagu kas Reveal URLs on lubatud või keelatud, avastamisrežiim, värvid, fondisuurused, teie ignoreerimisloend ja kõik lisatud saidid. Need hoitakse teie brauseri, Outlooki või Google'i per-user storage'is ning neid ei saadeta kunagi meile.
Täielikud üksikasjad leiate privaatsuspoliitikast.
Tõrkeotsing
Mõni link ei ilmu nähtavale.
- Kontrollige, et Reveal URLs oleks sisse lülitatud. Tööriistariba ikoon ei tohi näidata märki OFF ning seadete lehel olev lüliti Enable Reveal URLs peab olema sees.
- Kontrollige, et sait oleks kaetud. Sisseehitatud teenused Gmail, Outlook ja Proton töötavad kohe. Iga muu webmail tuleb lisada jaotisesse Active sites oma match URL-i ja message-body selector-iga.
- Kontrollige message-body selector-it. Kui see ei sobi container-iga, mis sisaldab sõnumi sisu, siis selles container-is olevaid linke ei paljastata.
- Pidage meeles, et lehesiseste ankruteni viivad lingid ja lingid, mis
kasutavad scheme'e, mis ei ole
http/https, nagumailto:, jäetakse teadlikult vahele. Sama kehtib host-ide kohta teie loendis Ignore these hosts.
Sisseehitatud teenus lakkas pärast ümberkujundust töötamast.
Webmaili teenused muudavad aeg-ajalt oma lehtede markup-it. Kui sisseehitatud teenuse selector pärast sellist muudatust enam ei sobi, saate selle ise parandada: redigeerige Active sites jaotises selle teenuse message-body selector-it nii, et see osutaks uuele container-ile.
Tooltip-URL ei ilmu.
Tooltip (title) režiimis paigutatakse tegelik URL lingi tooltip-i, seega kuvatakse see ainult siis, kui hoiate hiirekursorit selle kohal. Kui soovite URL-i näha ilma hover-ita, lülitage Reveal the URL inline-režiimi.
Litsents ja lähtekood
Reveal URLs on vaba tarkvara, mis on litsentseeritud GNU Affero General Public License v3.0 alusel (AGPL-3.0-only).
- Lähtekood: https://codeberg.org/Magentron/reveal-urls
- Tehniline ülevaade: Architecture
- Rohkem phishing-linkide kohta: Email link phishing: your app should always show the URL




