Reveal URLs — Erabiltzailearen eskuliburua

Reveal URLs nabigatzaileko hedapen txiki bat eta Thunderbird-erako gehigarri bat da. Zure mezu elektronikoetako esteka batek benetan nora daraman erakusten dizu, phishing esteka bat klik egin aurretik antzeman dezazun.

Eskuliburu honek Reveal URLs nola instalatu eta nola erabili azaltzen du. Zure datuak nola tratatzen diren jakiteko, kontsultatu pribatutasun politika. Hedapena teknikoki nola dagoen eraikita ikusteko, begiratu arkitekturaren deskribapena.

Akats bat, gaizki markatutako esteka bat edo bateragarria izan beharko lukeen webmail host bat aurkitu baduzu, jakinarazi Codeberg issue tracker zerbitzuan.

Edukia

• Zer egiten duen eta zergatik
• Onartutako nabigatzaileak eta posta-bezeroa
• Instalazioa
• Erabilera
• Outlook eta Gmail gehigarriak
• Hizkuntzak
• Pribatutasuna
• Arazoak konpontzea
• Lizentzia eta iturburu-kodea

Zer egiten duen eta zergatik

Phishing mezu batek jomuga gaizto bat ezkutatzen du itxura fidagarria duen esteka-testu baten atzean. Batzuetan benetakoaren antza duen host bat da: testuak paypal.com erakusten du, baina esteka paypa1.com helbidera doa. Askotan trikimailua sotilagoa da eta tracker edo redirector baten bidez pasatzen da; horregatik, heltzen zaren lekua ez da ia batere testuan aipatzen den markaren antzekoa.

Oharra: Pantaila-argazki honek Correos ordezten duen iruzurrezko phishing mezu elektroniko bat erakusten du. Correos ez dago Reveal URLs-ekin lotuta, eta ez du babesten.

Reveal URLsek irakurtzen ari zaren mezuko esteka bakoitza aztertzen du eta haren URLa erakusten dizu. Estekaren testuan agertzen den hosta estekak benetan erakusten duen hostarekin bat ez datorrenean, Reveal URLsek markatu egiten du, desadostasuna klik egin aurretik argi ikus dezazun.

Nabigatzaileko hedapenean eta Thunderbird gehigarrian dena zure gailuan bertan gertatzen da eta ez da ezer kanpora bidaltzen. Reveal URLs-en ezein formatuk ez dizkio zure posta elektronikoko datuak ez guri ez hirugarrenei bidaltzen: ez dago analytics eta ez dago tracking. Formatuen arteko aldea exekutatzen diren lekua eta Outlook panelearen kodea nola zerbitzatzen den baino ez da. Xehetasun gehiago Pribatutasuna atalean eta pribatutasun politikan aurkituko dituzu.

Onartutako nabigatzaileak eta posta-bezeroa

Reveal URLsek hemen funtzionatzen du:

• Google Chrome
• Microsoft Edge
• Opera
• Mozilla Firefox
• Mozilla Thunderbird (mahaigaineko posta-bezeroa)

Safari bertsioa ez da oraindik argitaratu. Geroagoko fase baterako aurreikusia dago.

Nabigatzaileetan Reveal URLsek zure webmaileko estekak markatzen ditu. Thunderbirden, bezeroaren barruan irakurtzen ari zaren mezu elektronikoko estekak markatzen ditu zuzenean.

Instalazioa

Zure nabigatzaileko edo posta-bezeroaren dendatik (gomendatua)

Instalatu Reveal URLs zure nabigatzaileko edo posta-bezeroaren dendatik. Chrome, Edge, Firefox eta Thunderbird-erako argitalpenak martxan daude. Operak Chrome build-a erabiltzen du, eta Operarentzako zerrenda bereizia bidean dago:

• Chrome — the Chrome Web Store
• Edge — Microsoft Edge Add-ons
• Opera — instalatu Chrome bertsioa the Chrome Web Store dendatik. Operarentzako zerrenda bereizia laster etorriko da
• Firefox — Firefox Add-ons (AMO)
• Thunderbird — Thunderbird Add-ons (ATN)

Build bat zuk zeuk kargatzea (garapena eta hasierako probak)

Reveal URLs iturburu-kodetik eraiki baduzu, build deskonprimitua zuzenean karga dezakezu. Target bakoitza make komandoarekin eraikitzen da eta dist/<target>/ direktorioan sortzen da:

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

Gero kargatu dagokion direktorioa:

• Chrome — ireki chrome://extensions, aktibatu Developer mode, egin klik Load unpacked aukeran eta hautatu dist/chrome.
• Edge — ireki edge://extensions, aktibatu Developer mode, egin klik Load unpacked aukeran eta hautatu dist/edge.
• Opera — ireki opera://extensions, aktibatu Developer mode, egin klik Load unpacked aukeran eta hautatu dist/opera.
• Firefox — ireki about:debugging, hautatu This Firefox, egin klik Load Temporary Add-on aukeran eta hautatu dist/firefox barruko edozein fitxategi, adibidez manifest.json. Aldi baterako gehigarria Firefox berrabiaraztean kentzen da.
• Thunderbird — instalatu aldi baterako gehigarria dist/thunderbird karpetatik modu berean, Tools → Developer Tools → Debug Add-ons → Load Temporary Add-on erabiliz.

Konfigurazio-orria automatikoki irekitzen da hedapena lehen aldiz instalatzen denean.

Erabilera

Instalatu bezain laster, Reveal URLsek integratutako zerbitzuetako mezuetako estekak markatzen ditu beste konfiguraziorik gabe:

• Gmail (mail.google.com)
• Outlook Live (outlook.live.com)
• Outlook on the web / Microsoft 365 (outlook.office.com)
• Proton Mail (mail.proton.me)

Markaketa mezuaren gorputzera mugatzen da; beraz, aplikazioaren chrome propioa, adibidez alboko barra, idazketa-leihoa eta tresna-barrak, ukitu gabe geratzen dira. Thunderbirden rendered email osoa estaltzen da.

Erakusteko bi moduak

Konfigurazio-orrian, Reveal the URL atalean, benetako URLa nola erakutsi aukeratzen duzu:

• Inline — benetako URLa bere lerroan agertzen da, estekaren testuaren gain-gainean. Hau da aukera lehenetsia.
• In the link's tooltip (title) — benetako URLa estekaren tooltip-ean jartzen da, gainean sagua uztean ikus dezazun.

Desadostasunak nabarmentzea

Estekaren testu ikusgarrian agertzen den hosta estekak benetan duen hostarekin bat ez datorrenean, Reveal URLsek desadostasun gisa markatzen du. Konparazioa registrable domeinuaren gainean egiten da; beraz, example.com-erako mail.example.com bezalako sub-domain legitimo bat ez da markatzen, baina paypal.com-erako paypa1.com bezalako look-alike host bat bai.

• inline moduan, desadostasuna zuk aukeratutako mismatch kolorearekin eta testu lodiz erakusten da.
• tooltip (title) moduan, ⚠ URL mismatch marka argia gehitzen zaio estekari.

Hori bi ezarpen erlazionatuk kontrolatzen dute:

• Highlight mismatching links aukerak desadostasunen nabarmentzea piztu edo itzaltzen du.
• Only annotate mismatching links aukerak esteka legitimoak erabat ukitu gabe uzten ditu, susmagarriak bakarrik ager daitezen.

Tresna-barrako botoia

Chrome, Edge, Opera, Firefox eta Thunderbird-en, Reveal URLs tresna-barrako ikonoa piztu/itzaltzeko etengailu azkar bat da — egin klik gainean anotazioa txandakatzeko. Hedapena itzalita dagoenean, OFF bereizgarri bat agertzen da ikonoan, eta haren argibideak esaten dizu klik egiteak piztuko duen ala itzaliko duen. Nabigatzaileetan aldaketa irekita dauden fitxa guztietan aplikatzen da batera; Thunderbird-en, berriz, irekitzen duzun hurrengo mezuari aplikatzen zaio.

(Thunderbird-en botoiak bere ikonoa bakarrik erakusten du, eta horrela trinkoa izaten jarraitzen du tresna-barra bateratuan. Reveal URLs ere piztu eta itzali dezakezu ezarpenen orriko Enable etengailuarekin.)

Konfigurazio-orria

Konfigurazio-orrian aukera guztiak daude. Ireki ezazu zure nabigatzaileko hedapenen orritik, adibidez Details → Extension options bidez, edo lehen instalazioan automatikoki irekiko da.

• Enable Reveal URLs — pizteko eta itzaltzeko etengailu nagusia, orriaren goialdean. Berehala eragiten du, formularioaren gainerakoa gorde gabe.
• Display language — aukeratu konfigurazio-orria zein hizkuntzatan erakutsiko den. Lehenespenez zure nabigatzailearen hizkuntza jarraitzen du eta, zurea onartuta ez badago, ingelesera itzultzen da. Zerrendatik beste hizkuntza bat hautatuta gainidatz dezakezu. Aukerak berehala eragiten du, gogoratzen da eta gailu honetan bakarrik gordetzen da.
• Reveal the URL — aukeratu inline edo tooltip (title) modua, goian azaldu bezala.
• Highlight mismatching links — piztu edo itzali desadostasunen nabarmentzea.
• Mismatch colour — markatutako estekarako CSS kolorea, adibidez red, #cc0000 edo rgb(200, 0, 0). Balio lehenetsia gorria da.
• Match colour — desadostasunik gabeko esteka legitimoetan agertzen den URLaren kolorea, adibidez black edo #1a1a1a. Lehenespenez gris ilun oso neutroa da (#1a1a1a).
• Only annotate mismatching links — utzi esteka legitimoak ukitu gabe.
• Ignore these hosts — guztiz saltatu beharreko hostname-en zerrenda, bat lerro bakoitzean. Zerrendatutako host baten sub-domain-ak ere saltatzen dira.
• Maximum displayed URL length — URL luzeak karaktere kopuru honetatik aurrera laburtzen dira, hosta ikusgai utzita. Onartutako tartea 20 eta 2000 artekoa da.
• Revealed URL font size / weight eta Warning badge font size / weight — aukerako tipografia-doikuntzak. Utzi hutsik balio lehenetsiak mantendu nahi badituzu.

Enable etengailu nagusia eta Active sites kontrolak izan ezik, horiek berehala aplikatzen baitira, aldaketak Save settings botoiarekin gordetzen dira.

Gune aktiboak — zure webmail propioa gehitzea

Konfigurazio-orriaren goialdeko Active sites atalak Reveal URLs non ibiltzen den eta mezu bakoitzaren gorputza daukan container-a zerrendatzen du.

Errenkada bakoitzak hau erakusten du:

• gunearen match pattern-a, adibidez https://mail.example.com/*
• Enabled etengailua
• message-body selector, hau da, Reveal URLsek markatzen duen container-aren CSS selector-a, eta zuk editatu dezakezuna
• Sub-frames etengailua, mezuaren gorputza iframe baten barruan agertzen den guneetarako
• Remove botoia, zuk gehitutako guneentzat bakarrik

Integratutako hornitzaileak, hala nola Gmail, Outlook eta Proton, desaktibatu edo berriz bideratu egin daitezke, baina ezin dira kendu.

Zure webmail gunea gehitzeko:

1. Add site atalean sartu Match URL — https://mail.example.com/*. bezalako match pattern bat.
2. Sartu Message-body selector — mezuaren gorputza daukan container-erako CSS selector bat, adibidez .message-body.
3. Mezuaren gorputza subframe baten barruan agertzen bada, markatu Also run inside sub-frames.
4. Egin klik Add site botoian. Zure nabigatzaileak gune horretara sartzeko baimena eskatuko dizu; eman baimena. Gunea baimena onartu ondoren bakarrik gehitzen da.

Hemengo aldaketak berehala aplikatzen dira. Zuk gehitutako gune bat kentzeak bere baimena ere kentzen du, eta Reveal URLsek gune hori atzitzeari uzten dio.

Thunderbird (eta beste posta-bezero batzuk). Thunderbirdek irakurtzen duzun mezu bakoitza erakusten du jada, hornitzailea edozein dela ere; beraz, ez du host zerrendarik behar. Horregatik, Active sites atala ez da erakusten Thunderbird-en konfigurazio-orrian. Han etengailu nagusia, bistaratze-hizkuntza, erakusteko modua, koloreak, letra-tipoak eta ignoratze-zerrenda bakarrik agertzen dira. Nabigatzaile batean ezarri dezakezun gune aktiboen edozein konfigurazio ukitu gabe gordetzen da. Thunderbird-eko konfigurazioa gordetzeak ez du inoiz ezabatzen.

Outlook eta Gmail gehigarriak

Nabigatzaileko hedapenaz eta Thunderbird gehigarriaz gain, Reveal URLs native gehigarri gisa ere badago nabigatzaileko hedapen batek atzitu ezin dituen bi posta-aplikaziotarako: Outlook add-in eta Gmail add-on. Biek hedapenaren esteka-detektatze bera erabiltzen dute; beraz, URL berak erakusten dituzte eta look-alike host berak markatzen dituzte.

Desberdintasun bakarra aurkikuntzak nola erakusten dituzten da. Nabigatzaileko hedapenak estekak bertan markatzen ditu, URLa esteka bakoitzaren gainean edo ondoan margotuz. Outlook eta Gmail framework-ek ez diote gehigarri bati renderizatutako mezua aldatzen uzten; horren ordez, gehigarri bakoitzak alboko panel bat (Outlook) edo txartel bat (Gmail) erakusten du aurkitutako esteken zerrendarekin. Esteka bakoitzerako testu ikusgarria, helmugako URLa eta registrable hosta erakusten dira, eta desadostasuna markatzen da testu ikusgarriak estekak benetan daraman registrable domeinua ez den beste bat izendatzen duenean.

• Outlook add-in — irekita daukazun mezua irakurri eta zure gailuan aztertzen duen task pane bat. Ez da inora posta elektronikoko edo mezuko daturik bidaltzen. Task pane-aren kodea, hau da HTML, JavaScript, CSS eta ikonoak, https://www.reveal-urls.eu gunetik HTTPS bidez kargatzen dira, edozein web orri irekitzean bezala. Outlook on the web, Windows, Mac, iOS, Android eta Outlook.com estaltzen ditu.
• Gmail add-on — Gmail-eko alboko barrako txartel bat. Ireki mezu bat eta, ondoren, egin klik eskuineko alboko barrako Reveal URLs ikonoan haren estekak ikusteko. Gmailek ez du txartela berez irekitzen, baina panela irekita uzten baduzu eguneratu egiten da mezuen artean mugitzean. Esteka bakoitzaren URLa gris ilun neutroz erakusten da esteka legitimoetarako, eta gorriz look-alike baterako. Gmail web-ean, Android-en eta iOS-en dabil. Beste formek ez bezala, Gmail add-on Google-ren zerbitzarietan exekutatzen da, horrela funtzionatzen baitute Gmail gehigarriek. Irekitzen duzun mezua han irakurri eta egiaztatzen da irekitzen duzun aldi bakoitzean, eta ez da gordetzen. Begiratu pribatutasun politika dokumentua forma bakoitzak zertara sartzen den eta zer gordetzen duen ikusteko.

Bi gehigarriak beren aplikazio-denden bidez banatuko dira: Outlook add-in-a Microsoft AppSource bidez, eta Gmail add-on-a Google Workspace Marketplace bidez. Argitalpena oraindik zain dago. Instalazio-lotura zuzenak hemen gehituko dira zerrenda bakoitza aktibo dagoenean.

Hizkuntzak

Reveal URLs ingelesez eta beste hizkuntza askotan dago eskuragarri.

• Konfigurazio-orriak zure nabigatzailearen hizkuntza automatikoki jarraitzen du eta, zurea onartuta ez badago, ingelesera jotzen du. Nahi duzunean gainidatzi dezakezu orriaren goialdeko Display language hautagailuarekin. Zure aukera gailu horretan gordetzen da. Ikusi Konfigurazio-orria.
• Webgune honek, hau da, hasierako orriak eta dokumentazio-orri hauek, zure nabigatzailearen hizkuntza ere detektatzen du eta hizkuntza-hautagailu bat eskaintzen du goiburuan. Eskuliburua eta pribatutasun-orriak itzulita daude. Orrialde baterako itzulpenik oraindik ez badago, ingelesezko bertsioa erakusten da.

Ingelesez ez dagoen testua machine-translated da eta giza berrikuspenaren zain dago; horregatik, esaldiren batek noizean behin arraro jo dezake. Asmoa ingelesezko jatorrizkoaren esanahi bera mantentzea da. Itzulpen okerren bat ikusten baduzu, ireki issue bat Codeberg issue tracker zerbitzuan.

Pribatutasuna

Reveal URLsek ez dizkio zure mezu edo posta elektronikoko datuak guri ez hirugarrenei bidaltzen, bere ezein formatutan. Ez dago analytics eta ez dago tracking. Lana non eta nola egiten den formatuaren araberakoa da:

• Nabigatzaileko hedapena eta Thunderbird gehigarria guztiz zure gailuan lan egiten dute eta ez dute ezer transmititzen. Esteken testua, URLak eta orriaren koloreak irakurtzen dituzte orria renderizatzen denean, datu horiek gorde edo bidali gabe.
• Outlook add-in-ak irekitako mezua zure gailuan aztertzen du eta ez du posta elektronikoko edo mezuko daturik inora bidaltzen. Bere task pane kodea, hau da HTML, JavaScript, CSS eta ikonoak, https://www.reveal-urls.eu gunetik HTTPS bidez kargatzen dira, edozein web orrirekin bezala.
• Gmail add-on Google-ren zerbitzarietan exekutatzen da, horrela funtzionatzen baitute Gmail gehigarriek. Irekitako mezua han irakurtzen eta egiaztatzen da irekitzen duzun aldi bakoitzean, eta ez da gordetzen.

Gordetzen den gauza bakarra zure konfigurazioa da, hala nola Reveal URLs piztuta edo itzalita dagoen, erakusteko modua, koloreak, letra-tamainak, ignoratutakoen zerrenda eta gehitu dituzun gune guztiak. Horiek zure nabigatzailearen, Outlook-en edo Google-ren per-user storage-an gordetzen dira, eta ez zaizkigu inoiz bidaltzen.

Xehetasun guztiak pribatutasun politikan daude.

Arazoak konpontzea

Estekaren bat ez da erakusten.

• Egiaztatu Reveal URLs piztuta dagoela. Tresna-barrako ikonoak ez du OFF marka erakutsi behar, eta konfigurazio-orriko Enable Reveal URLs etengailuak aktibatuta egon behar du.
• Egiaztatu gunea estalita dagoela. Integratutako Gmail, Outlook eta Proton zerbitzuek berehala funtzionatzen dute. Beste edozein webmail Active sites atalean gehitu behar da bere match URL eta message-body selector-arekin.
• Egiaztatu message-body selector-a. Mezuaren gorputza duen container-arekin bat ez badator, container horretako estekak ez dira erakutsiko.
• Kontuan izan orri barruko ainguretako estekak eta http/https ez diren scheme-ak erabiltzen dituzten estekak, hala nola mailto:, nahita saltatzen direla. Gauza bera gertatzen da Ignore these hosts zerrendako hostekin.

Integratutako hornitzaile batek funtzionatzeari utzi dio birmoldaketa baten ondoren.

Webmail hornitzaileek noizean behin beren orrien markup-a aldatzen dute. Integratutako hornitzaile baten selector-a aldaketa horren ondoren jada bat ez badator, zuk zeuk zuzendu dezakezu: Active sites atalean editatu hornitzaile horren message-body selector-a, container berrira seinala dezan.

Tooltip URL-a ez da agertzen.

Tooltip (title) moduan benetako URLa estekaren tooltip-ean jartzen da; beraz, gainean sagua jartzen duzunean bakarrik agertzen da. URLa hover gabe ikusi nahi baduzu, aldatu Reveal the URL inline modura.

Lizentzia eta iturburu-kodea

Reveal URLs software librea da, GNU Affero General Public License v3.0 (AGPL-3.0-only) lizentziarekin.

• Iturburu-kodea: https://codeberg.org/Magentron/reveal-urls
• Deskribapen teknikoa: Architecture
• Esteka bidezko phishing-ari buruz gehiago: Email link phishing: your app should always show the URL