Reveal URLs — Käyttöopas
Reveal URLs on pieni selainlaajennus (ja Thunderbird-lisäosa), joka näyttää sinulle, minne sähköpostissasi oleva linkki todella johtaa, jotta voit tunnistaa tietojenkalastelulinkin ennen kuin napsautat sitä.
Tämä käyttöopas selittää, kuinka Reveal URLs asennetaan ja kuinka sitä käytetään. Tietoa siitä, kuinka tietojasi käsitellään, on tietosuojakäytännössä; teknisen yleiskatsauksen siitä, kuinka laajennus on rakennettu, löydät arkkitehtuurin yleiskatsauksesta.
Löysitkö virheen, väärin merkityn (tai ohitetun) linkin tai webmail-palvelimen, jonka pitäisi olla tuettu? Ilmoita siitä Codebergin ongelmaseurannassa.
Sisältö
- Mitä se tekee ja miksi
- Tuetut selaimet ja sähköpostiohjelma
- Asentaminen
- Käyttäminen
- Outlook- ja Gmail-lisäosat
- Kielet
- Tietosuoja
- Vianmääritys
- Lisenssi ja lähdekoodi
Mitä se tekee ja miksi
Tietojenkalasteluviesti piilottaa vihamielisen kohteen luotettavan näköisen
linkkitekstin taakse. Joskus kyse on samannäköisestä palvelimesta: tekstissä
lukee paypal.com, vaikka linkki osoittaa palvelimeen paypa1.com. Usein se on
hienovaraisempaa ja kulkee seuranta- tai uudelleenohjauspalvelun kautta, joten
päätepiste ei muistuta lainkaan tekstissä mainittua brändiä.

parcel-pay.custom.co.xa, ei Postiin.Huomautus: Tämä kuvakaappaus näyttää petollisen tietojenkalasteluviestin, joka tekeytyy Postiksi. Posti ei ole sidoksissa Reveal URLsiin eikä tue sitä.
Reveal URLs lukee jokaisen linkin lukemassasi viestissä ja näyttää sinulle URL-osoitteen, johon se todella osoittaa. Kun linkkitekstissä mainittu palvelin ei vastaa tätä palvelinta, Reveal URLs merkitsee sen, jotta ero on ilmeinen ennen kuin napsautat.
Selainlaajennuksessa ja Thunderbird-lisäosassa kaikki tapahtuu omalla laitteellasi, eikä mitään välitetä. Kaikissa muodoissaan Reveal URLs ei lähetä mitään sähköpostitietojasi meille eikä millekään kolmannelle osapuolelle — ei ole analytiikkaa eikä seurantaa. (Muodot eroavat siinä, missä ne suoritetaan ja kuinka Outlook-ruudun koodi tarjotaan; katso Tietosuoja-osio ja tietosuojakäytäntö saadaksesi kaikki tiedot.)
Tuetut selaimet ja sähköpostiohjelma
Reveal URLs toimii alustoilla:
- Google Chrome
- Microsoft Edge
- Opera
- Mozilla Firefox
- Mozilla Thunderbird (työpöydän sähköpostiohjelma)
Safari-versiota ei vielä toimiteta; se on suunniteltu myöhempään vaiheeseen.
Selainkohteissa Reveal URLs merkitsee linkit webmailissasi. Thunderbirdissä se merkitsee lukemasi sähköpostin linkit suoraan sähköpostiohjelmassa.
Asentaminen
Selaimesi tai sähköpostiohjelmasi kaupasta (suositeltu)
Asenna Reveal URLs selaimesi tai sähköpostiohjelmasi kaupasta. Chromen, Edgen, Firefoxin ja Thunderbirdin listaukset ovat aktiivisia; Opera käyttää Chrome-versiota, ja oma Opera-listaus on vielä tulossa:
- Chrome — Chrome Web Store
- Edge — Microsoft Edge Add-ons
- Opera — asenna Chrome-versio Chrome Web Storesta; oma Opera-listaus tulossa pian
- Firefox — Firefox Add-ons (AMO)
- Thunderbird — Thunderbird Add-ons (ATN)
Version lataaminen itse (kehittäjät ja varhainen testaus)
Jos olet rakentanut Reveal URLs:n lähdekoodista, voit ladata puretun version suoraan.
Kukin kohde rakennetaan make-komennolla ja tuotetaan kansioon 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
Lataa sitten tuloksena oleva kansio:
- Chrome — avaa
chrome://extensions, ota käyttöön Kehittäjätila, napsauta Lataa pakkaamaton ja valitsedist/chrome. - Edge — avaa
edge://extensions, ota käyttöön Kehittäjätila, napsauta Lataa pakkaamaton ja valitsedist/edge. - Opera — avaa
opera://extensions, ota käyttöön Kehittäjätila, napsauta Lataa pakkaamaton ja valitsedist/opera. - Firefox — avaa
about:debugging, valitse Tämä Firefox, napsauta Lataa väliaikainen lisäosa ja valitse mikä tahansa tiedosto kansiostadist/firefox(esimerkiksi senmanifest.json). Väliaikainen lisäosa poistetaan, kun Firefox käynnistyy uudelleen. - Thunderbird — asenna väliaikainen lisäosa kansiosta
dist/thunderbirdsamalla tavalla (kohdasta Työkalut → Kehittäjätyökalut → Vianetsi lisäosia → Lataa väliaikainen lisäosa).
Asetussivu avautuu automaattisesti, kun laajennus asennetaan ensimmäistä kertaa.
Käyttäminen
Heti laatikosta Reveal URLs merkitsee linkit sisäänrakennettujen palveluntarjoajien viesteissä — asetuksia ei tarvita:
- Gmail (
mail.google.com) - Outlook Live (
outlook.live.com) - Outlook verkossa / Microsoft 365 (
outlook.office.com) - Proton Mail (
mail.proton.me)
Merkintä on rajattu viestin sisältöön, joten sovelluksen oma kehys — sen sivupalkki, laatimisikkuna ja työkalupalkit — jää koskemattomaksi. Thunderbirdissä koko hahmonnettu sähköposti katetaan.
Kaksi paljastustilaa
Valitset, kuinka todellinen URL näytetään, asetussivun kohdassa Paljasta URL:
- Sisällytetty (inline) — todellinen URL näytetään omalla rivillään, juuri linkkitekstin yläpuolella. Tämä on oletus.
- Linkin työkaluvihjeessä (otsikko) — todellinen URL sijoitetaan linkin työkaluvihjeeseen, joten se ilmestyy, kun viet osoittimen linkin päälle.
Täsmäämättömien linkkien korostus
Kun linkin näkyvässä tekstissä mainittu palvelin ei vastaa sitä palvelinta, johon linkki
todella osoittaa, Reveal URLs merkitsee sen täsmäämättömyydeksi. Vertailu tehdään
rekisteröitävän verkkotunnuksen perusteella, joten rehellistä aliverkkotunnusta kuten
mail.example.com verkkotunnukselle example.com ei merkitä, kun taas samannäköinen
kuten paypa1.com verkkotunnukselle paypal.com merkitään.
- Sisällytetty-tilassa täsmäämättömyys näytetään valitsemallasi täsmäämättömyysvärillä ja lihavoituna.
- Työkaluvihje (otsikko) -tilassa linkin viereen lisätään erottuva ⚠ URL-täsmäämättömyys -merkki.
Kaksi siihen liittyvää asetusta ohjaavat tätä:
- Korosta täsmäämättömät linkit kytkee täsmäämättömyyden korostuksen päälle tai pois.
- Merkitse vain täsmäämättömät linkit jättää rehelliset linkit täysin koskemattomiksi, joten vain epäilyttävät paljastetaan.
Työkalupalkin painike
Chromessa, Edgessä, Operassa, Firefoxissa ja Thunderbirdissä Reveal URLsin työkalupalkkikuvake on nopea päälle/pois-kytkin — napsauta sitä vaihtaaksesi annotoinnin tilaa. Kun laajennus on pois päältä, kuvakkeessa näkyy OFF-merkki, ja sen työkaluvihje kertoo, kytkeekö napsautus sen päälle vai pois. Selaimissa muutos tulee voimaan kaikissa avoimissa välilehdissä kerralla; Thunderbirdissä se koskee seuraavaa avaamaasi viestiä.
(Thunderbirdissä painike näyttää vain kuvakkeensa, joten se pysyy kompaktina yhtenäisellä työkalupalkilla. Voit myös laittaa Reveal URLsin päälle ja pois päältä asetussivun Ota käyttöön-kytkimellä.)
Asetussivu
Asetussivu sisältää jokaisen vaihtoehdon. Avaa se selaimesi laajennussivulta (esimerkiksi Tiedot → Laajennuksen asetukset), tai se avautuu automaattisesti ensiasennuksella.
- Ota Reveal URLs käyttöön — pääpäälle/pois-kytkin, aivan sivun yläosassa. Se tulee voimaan välittömästi ilman, että lomakkeen muuta osaa täytyy tallentaa.
- Näyttökieli — valitse kieli, jolla asetussivu näytetään. Oletuksena se seuraa selaimesi kieltä ja palaa englantiin; valitse luettelosta toinen ohittaaksesi tämän. Valintasi tulee voimaan heti, se muistetaan seuraavaa kertaa varten ja se tallennetaan vain tälle laitteelle (se ei koskaan muuta asetustesi muuta osaa).
- Paljasta URL — valitse sisällytetty- tai työkaluvihje (otsikko) -tila (katso yllä).
- Korosta täsmäämättömät linkit — kytke täsmäämättömyyden korostus päälle tai pois.
- Täsmäämättömyysväri — CSS-väri, jota käytetään merkitylle linkille (esimerkiksi
red,#cc0000tairgb(200, 0, 0)). Oletus on punainen. - Täsmäysväri — paljastetun URL:n väri rehellisissä (ei-täsmäämättömissä)
linkeissä (esimerkiksi
blacktai#1a1a1a). Oletus on neutraali, hyvin tumma harmaa (#1a1a1a), valittuna niin, ettei väri anna ymmärtää, että linkki olisi tarkistettu. - Merkitse vain täsmäämättömät linkit — jätä rehelliset linkit koskemattomiksi.
- Ohita nämä palvelimet — luettelo palvelinnimistä, jotka ohitetaan kokonaan, yksi riviä kohden. Luetellun palvelimen aliverkkotunnukset ohitetaan myös.
- Näytettävän URL:n enimmäispituus — pitkät URL:t katkaistaan tämän merkkimäärän jälkeen, pitäen palvelimen näkyvissä. Sallittu alue: 20–2000.
- Paljastetun URL:n fonttikoko / -paino ja Varoitusmerkin fonttikoko / -paino — valinnaiset typografian ohitukset; jätä tyhjäksi säilyttääksesi oletusarvot.
Pääkytkimen Ota käyttöön ja Aktiiviset sivustot -säätimien (jotka tulevat voimaan välittömästi) lisäksi muutokset tallennetaan Tallenna asetukset -painikkeella.
Aktiiviset sivustot — oman webmailisi lisääminen
Aktiiviset sivustot -osio, asetussivun yläosassa, luettelee sivut, joilla Reveal URLs toimii, ja säiliön, joka pitää sisällään kunkin viestin sisällön.
Kukin rivi näyttää:
- sivuston täsmäyskaavan (esimerkiksi
https://mail.example.com/*); - Käytössä-kytkimen;
- viestin sisällön valitsimen (CSS-valitsin säiliölle, jonka Reveal URLs merkitsee), jota voit muokata;
- Aliruudut-kytkimen, sivustoille, joiden viestin sisältö hahmonnetaan iframen sisällä;
- Poista-painikkeen (vain omille sivustoillesi).
Sisäänrakennetut palveluntarjoajat (Gmail, Outlook ja Proton) voidaan kytkeä pois päältä ja kohdistaa uudelleen, mutta niitä ei voi poistaa.
Oman webmail-sivustosi lisääminen:
- Syötä kohdassa Lisää sivusto Täsmäys-URL — täsmäyskaava kuten
https://mail.example.com/*. - Syötä Viestin sisällön valitsin — CSS-valitsin säiliölle, joka pitää sisällään
viestin sisällön, esimerkiksi
.message-body. - Jos viestin sisältö hahmonnetaan aliruudun sisällä, rastita Suorita myös aliruutujen sisällä.
- Napsauta Lisää sivusto. Selaimesi pyytää lupaa päästä kyseiselle sivustolle; myönnä se. Sivusto lisätään vasta, kun myönnät luvan.
Muutokset tässä tulevat voimaan välittömästi. Lisäämäsi sivuston poistaminen myös peruuttaa sen luvan, joten Reveal URLs lakkaa käyttämästä sitä.
Thunderbird (ja muut sähköpostiohjelmat). Thunderbird näyttää jo jokaisen lukemasi viestin, riippumatta palveluntarjoajasta, joten se ei tarvitse palvelinkohtaista luetteloa. Aktiiviset sivustot -osiota ei siksi näytetä Thunderbirdin asetussivulla — vain pääkytkin, näyttökieli, paljastustila, värit, fontit ja ohituslista ovat näkyvissä. Mikä tahansa aktiivisten sivustojen määritys, jonka olet mahdollisesti asettanut selaimessa, säilytetään koskemattomana: Thunderbirdin asetusten tallentaminen ei koskaan tyhjennä sitä.
Outlook- ja Gmail-lisäosat
Selainlaajennuksen ja Thunderbird-lisäosan rinnalla Reveal URLs tarjotaan natiivina lisäosana kahdelle sähköpostisovellukselle, joihin selainlaajennus ei yllä: Outlook-lisäosana ja Gmail-lisäosana. Molemmat käyttävät samaa linkkien tunnistusta kuin laajennus, joten ne paljastavat samat URL-osoitteet ja merkitsevät samat samannäköiset palvelimet.
Ainoa ero on siinä, kuinka ne näyttävät havaintonsa. Selainlaajennus merkitsee linkit paikan päällä — värittäen URL:n kunkin linkin yläpuolelle tai viereen. Outlookin ja Gmailin kehykset eivät salli lisäosan muuttaa hahmonnettua viestiä, joten sen sijaan kukin lisäosa näyttää sivupaneelin (Outlook) tai kortin (Gmail), jossa luetellaan löytämänsä linkit. Kullekin linkille se näyttää näkyvän tekstin, URL-osoitteen ja rekisteröitävän palvelimen, ja se merkitsee täsmäämättömyyden, kun näkyvä teksti nimeää eri rekisteröitävän verkkotunnuksen kuin se, johon linkki todella osoittaa.
- Outlook-lisäosa — tehtäväruutu, joka lukee avoimena olevan viestin ja analysoi sen omalla laitteellasi; mitään sähköposti- tai viestitietoja ei lähetetä minnekään. Sen tehtäväruudun koodi (HTML, JavaScript, CSS ja kuvakkeet) ladataan https://www.reveal-urls.eu -palvelusta HTTPS:n yli, kuten tapahtuu minkä tahansa verkkosivun avaamisessa. Se yltää Outlookiin verkossa, Windowsissa, Macissa, iOS:ssä ja Androidissa sekä Outlook.comissa.
- Gmail-lisäosa — kortti Gmailin sivupalkissa. Avaa viesti ja napsauta sitten Reveal URLs -kuvaketta oikeanpuoleisessa sivupalkissa nähdäksesi sen linkit: Gmail ei avaa korttia auki itsestään, mutta jos jätät paneelin auki, se päivittyy, kun siirryt viestien välillä. Kunkin linkin URL-osoite näytetään neutraalina tummana harmaana rehelliselle linkille ja punaisena samannäköiselle. Se yltää Gmailiin verkossa, Androidissa ja iOS:ssä. Toisin kuin muut muodot, Gmail-lisäosa toimii Googlen palvelimilla (näin Gmail-lisäosat toimivat): avaamasi viesti luetaan ja tarkistetaan siellä, joka kerta kun avaat sen, eikä sitä säilytetä. Katso tietosuojakäytäntö saadaksesi tietää, mihin kukin muoto pääsee käsiksi ja mitä se tallentaa.
Molemmat lisäosat jaetaan sovelluskauppojensa kautta — Outlook-lisäosa Microsoft AppSourcen kautta, Gmail-lisäosa Google Workspace Marketplacen kautta. Julkaisu on vireillä; suorat asennuslinkit lisätään tähän, kun kukin listaus on aktiivinen.
Kielet
Reveal URLs on saatavilla englanniksi ja monella muulla kielellä.
- Asetussivu seuraa selaimesi kieltä automaattisesti ja palaa englantiin, kun kielesi ei ole jokin yllä olevista. Voit ohittaa sen milloin tahansa sivun yläosan lähellä olevalla Näyttökieli-valitsimella; valintasi muistetaan kyseisellä laitteella (katso Asetussivu).
- Tämä verkkosivusto (kotisivu ja nämä dokumentaatiosivut) tunnistaa myös selaimesi kielen ja tarjoaa kielenvalitsimen ylätunnisteessa. Käyttöopas ja tietosuojasivut ovat saatavilla käännettyinä; siellä missä sivulla ei vielä ole käännöstä, se näytetään englanniksi.
Muu kuin englanninkielinen teksti on konekäännettyä ja odottaa ihmisen tarkistusta, joten ilmaus voi toisinaan kuulostaa kömpelöltä; merkityksen on tarkoitus vastata englanninkielistä alkuperäistä. Jos havaitset käännösvirheen, avaa ongelma Codebergin ongelmaseurannassa.
Tietosuoja
Reveal URLs ei lähetä mitään sähköposti- tai viestitietojasi meille eikä millekään kolmannelle osapuolelle, missään muodossaan — ei ole analytiikkaa eikä seurantaa. Kuinka ja missä työ tapahtuu, riippuu muodosta:
- Selainlaajennus ja Thunderbird-lisäosa toimivat kokonaan omalla laitteellasi eivätkä välitä mitään: ne lukevat linkkitekstin, URL-osoitteet ja sivun värit sivun hahmontuessa, eivätkä koskaan tallenna tai lähetä niitä.
- Outlook-lisäosa analysoi avoimena olevan viestin omalla laitteellasi eikä lähetä mitään sähköposti- tai viestitietoja minnekään; sen tehtäväruudun koodi (HTML, JavaScript, CSS ja kuvakkeet) ladataan https://www.reveal-urls.eu -palvelusta HTTPS:n yli, kuten tapahtuu minkä tahansa verkkosivun avaamisessa.
- Gmail-lisäosa toimii Googlen omilla palvelimilla (näin Gmail-lisäosat toimivat): avoin viesti luetaan ja tarkistetaan siellä, joka kerta kun avaat sen, eikä sitä säilytetä.
Ainoa asia, joka tallennetaan, ovat omat asetuksesi (kuten käytössä/pois käytöstä, paljastustila, värit, fonttikoot, ohituslistasi ja kaikki lisäämäsi sivustot), jotka säilytetään selaimesi, Outlookin tai Googlen käyttäjäkohtaisessa varastossa, eikä niitä koskaan lähetetä meille.
Katso tietosuojakäytäntö saadaksesi kaikki tiedot.
Vianmääritys
Linkkiä ei paljasteta.
- Tarkista, että Reveal URLs on kytketty päälle — työkalupalkkikuvakkeessa ei saa näkyä OFF-merkkiä, ja asetussivun Ota Reveal URLs käyttöön -kytkimen on oltava päällä.
- Tarkista, että sivusto on katettu. Sisäänrakennetut palveluntarjoajat (Gmail, Outlook, Proton) toimivat heti laatikosta; mikä tahansa muu webmail on lisättävä kohtaan Aktiiviset sivustot sen täsmäys-URL:n ja viestin sisällön valitsimen kanssa.
- Tarkista viestin sisällön valitsin. Jos se ei vastaa säiliötä, joka pitää sisällään viestin sisällön, kyseisen säiliön sisällä olevia linkkejä ei paljasteta.
- Huomaa, että linkit sivunsisäisiin ankkureihin ja linkit, jotka käyttävät muita
malleja kuin
http/https(kutenmailto:), ohitetaan tarkoituksella — kuten myös Ohita nämä palvelimet -luettelossasi olevat palvelimet.
Sisäänrakennettu palveluntarjoaja lakkasi toimimasta uudelleensuunnittelun jälkeen.
Webmail-palveluntarjoajat muuttavat sivumerkintäänsä aika ajoin. Jos sisäänrakennetun palveluntarjoajan valitsin ei enää vastaa tällaisen muutoksen jälkeen, voit korjata sen itse: muokkaa kohdassa Aktiiviset sivustot kyseisen palveluntarjoajan viestin sisällön valitsin uuteen säiliöön.
Työkaluvihjeen URL ei näy.
Työkaluvihje (otsikko) -tilassa todellinen URL sijoitetaan linkin työkaluvihjeeseen, joten se ilmestyy vain, kun viet osoittimen linkin päälle. Jos näkisit URL:n mieluummin ilman osoittimen viemistä, vaihda Paljasta URL sisällytettyyn tilaan.
Lisenssi ja lähdekoodi
Reveal URLs on vapaa ohjelmisto, lisensoitu GNU Affero General Public License v3.0 (AGPL-3.0-only) -lisenssillä.
- Lähdekoodi: https://codeberg.org/Magentron/reveal-urls
- Tekninen yleiskatsaus: Arkkitehtuuri
- Lisää luettavaa linkkien tietojenkalastelusta: Email link phishing: your app should always show the URL




