Reveal URLs — Udhëzues përdoruesi
Reveal URLs është një zgjerim i vogël për shfletuesin dhe një shtesë për Thunderbird që ju tregon se ku shkon në të vërtetë një lidhje në emailin tuaj, që të mund të dalloni një lidhje phishing përpara se të klikoni mbi të.
Ky udhëzues shpjegon si të instaloni Reveal URLs dhe si ta përdorni. Për mënyrën se si trajtohen të dhënat tuaja, shihni politikën e privatësisë. Për një përmbledhje teknike të mënyrës si është ndërtuar zgjerimi, shihni përmbledhjen e arkitekturës.
Keni gjetur një bug, një lidhje që u shënua gabimisht ose një host webmail që duhet të mbështetet? Raportojeni te Codeberg issue tracker.
Përmbajtja
- Çfarë bën dhe pse
- Shfletuesit e mbështetur dhe klienti i postës
- Instalimi
- Përdorimi
- Shtesat për Outlook dhe Gmail
- Gjuhët
- Privatësia
- Zgjidhja e problemeve
- Licenca dhe kodi burimor
Çfarë bën dhe pse
Një email phishing fsheh një destinacion armiqësor pas një teksti lidhjeje që
duket i besueshëm. Ndonjëherë bëhet fjalë për një host që i ngjan atij të
vërtetë: teksti shfaq paypal.com, ndërsa lidhja të çon te paypa1.com.
Shpesh mashtrimi është më i hollë dhe kalon nëpërmjet një tracker-i ose
redirector-i, kështu që vendi ku përfundoni nuk ngjan aspak me markën që
përmendet në tekst.

parcel-pay.custom.co.xa, jo te Posta Shqiptare.Shënim: Kjo pamje e ekranit tregon një email phishing mashtrues që hiqet si Posta Shqiptare. Posta Shqiptare nuk është e lidhur me Reveal URLs dhe nuk e mbështet atë.
Reveal URLs lexon çdo lidhje në mesazhin që po shikoni dhe ju tregon URL-in ku ajo të çon. Kur hosti i përmendur në tekstin e dukshëm të lidhjes nuk përputhet me hostin ku lidhja shkon me të vërtetë, Reveal URLs e shënon këtë, që mospërputhja të jetë e qartë përpara se të klikoni.
Në zgjerimin e shfletuesit dhe në shtesën e Thunderbird-it gjithçka ndodh në pajisjen tuaj dhe nuk transmetohet asgjë. Në të gjitha format e tij Reveal URLs nuk dërgon asnjë të dhënë nga emaili juaj te ne ose te palë të treta: nuk ka analytics dhe nuk ka tracking. Format ndryshojnë vetëm te vendi ku ekzekutohen dhe te mënyra se si shërbehet kodi i panelit të Outlook-it. Për hollësitë e plota shihni seksionin Privatësia dhe politikën e privatësisë.
Shfletuesit e mbështetur dhe klienti i postës
Reveal URLs funksionon në:
- Google Chrome
- Microsoft Edge
- Opera
- Mozilla Firefox
- Mozilla Thunderbird (klienti desktop i postës)
Një version për Safari nuk është publikuar ende. Ai është planifikuar për një fazë të mëvonshme.
Në shfletues, Reveal URLs shënon lidhjet në webmail-in tuaj. Në Thunderbird ai shënon lidhjet drejtpërdrejt në emailin që po lexoni brenda vetë klientit.
Instalimi
Nga dyqani i shfletuesit ose i klientit të postës (rekomandohet)
Instalojeni Reveal URLs nga dyqani i shfletuesit ose i klientit tuaj të postës. Listimet për Chrome, Edge, Firefox dhe Thunderbird janë tashmë aktive. Opera përdor build-in e Chrome-it dhe një listim i veçantë për Opera është ende në përgatitje:
- Chrome — the Chrome Web Store
- Edge — Microsoft Edge Add-ons
- Opera — instaloni versionin për Chrome nga the Chrome Web Store. Një listim i dedikuar për Opera do të vijë së shpejti
- Firefox — Firefox Add-ons (AMO)
- Thunderbird — Thunderbird Add-ons (ATN)
Ngarkimi i build-it tuaj (zhvillues dhe testim i hershëm)
Nëse e keni ndërtuar Reveal URLs nga kodi burimor, mund ta ngarkoni
drejtpërdrejt build-in e papaketuar. Çdo target ndërtohet me një komandë
make dhe prodhohet nën 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
Pastaj ngarkoni dosjen përkatëse:
- Chrome — hapni
chrome://extensions, aktivizoni Developer mode, klikoni Load unpacked dhe zgjidhnidist/chrome. - Edge — hapni
edge://extensions, aktivizoni Developer mode, klikoni Load unpacked dhe zgjidhnidist/edge. - Opera — hapni
opera://extensions, aktivizoni Developer mode, klikoni Load unpacked dhe zgjidhnidist/opera. - Firefox — hapni
about:debugging, zgjidhni This Firefox, klikoni Load Temporary Add-on dhe zgjidhni një skedar brendadist/firefox, për shembullmanifest.json. Një shtesë e përkohshme hiqet kur Firefox ristartohet. - Thunderbird — instaloni shtesën e përkohshme nga
dist/thunderbirdnë të njëjtën mënyrë përmes Tools → Developer Tools → Debug Add-ons → Load Temporary Add-on.
Faqja e cilësimeve hapet automatikisht herën e parë kur instalohet zgjerimi.
Përdorimi
Menjëherë pas instalimit, Reveal URLs shënon lidhjet në mesazhet te ofruesit e integruar pa kërkuar ndonjë konfigurim shtesë:
- Gmail (
mail.google.com) - Outlook Live (
outlook.live.com) - Outlook on the web / Microsoft 365 (
outlook.office.com) - Proton Mail (
mail.proton.me)
Shënimi kufizohet te trupi i mesazhit, kështu që pjesa tjetër e ndërfaqes së aplikacionit, si shiriti anësor, dritarja e kompozimit dhe shiritat e veglave, mbetet e paprekur. Në Thunderbird mbulohet i gjithë emaili i renderuar.
Dy mënyrat e zbulimit
Në faqen e cilësimeve, te Reveal the URL, zgjidhni si do të shfaqet URL-ja e vërtetë:
- Inline — URL-ja e vërtetë shfaqet në rreshtin e vet, menjëherë mbi tekstin e lidhjes. Kjo është vlera e parazgjedhur.
- In the link's tooltip (title) — URL-ja e vërtetë vendoset në tooltip-in e lidhjes, kështu që shfaqet kur mbani treguesin mbi të.
Theksimi i mospërputhjeve
Kur hosti i përmendur në tekstin e dukshëm të një lidhjeje nuk përputhet me
hostin ku lidhja çon në të vërtetë, Reveal URLs e shënon këtë si
mospërputhje. Krahasimi bëhet mbi domenin registrable, kështu që një
nëndomen i ndershëm si mail.example.com për example.com nuk shënohet,
ndërsa një host look-alike si paypa1.com për paypal.com shënohet.
- Në mënyrën inline mospërputhja shfaqet me ngjyrën e mospërputhjes që keni zgjedhur dhe me tekst të trashë.
- Në mënyrën tooltip (title) pranë lidhjes shtohet një shenjë e dukshme ⚠ URL mismatch.
Dy cilësime të lidhura kontrollojnë këtë sjellje:
- Highlight mismatching links aktivizon ose çaktivizon theksimin e mospërputhjeve.
- Only annotate mismatching links i lë lidhjet e ndershme plotësisht të paprekura, kështu që zbulohen vetëm ato të dyshimtat.
Butoni i shiritit të veglave
Në Chrome, Edge, Opera, Firefox dhe Thunderbird, ikona e Reveal URLs në shiritin e veglave është një çelës i shpejtë ndezje/fikje — klikojeni për të ndërruar anotimin. Kur zgjerimi është i fikur, mbi ikonë shfaqet një shenjë OFF, dhe ndihmëza e saj ju tregon nëse klikimi do ta ndezë apo do ta fikë. Në shfletues, ndryshimi hyn në fuqi në të gjitha skedat e hapura menjëherë; në Thunderbird zbatohet për mesazhin tjetër që hapni.
(Në Thunderbird, butoni tregon vetëm ikonën e vet, kështu që mbetet kompakt në shiritin e unifikuar të veglave. Reveal URLs mund ta ndizni dhe fikni edhe me çelësin Enable në faqen e cilësimeve.)
Faqja e cilësimeve
Faqja e cilësimeve përmban të gjitha opsionet. Hapeni nga faqja e zgjerimeve të shfletuesit tuaj, për shembull përmes Details → Extension options, ose ajo do të hapet vetë në instalimin e parë.
- Enable Reveal URLs — ndërprerësi kryesor i ndezjes dhe fikjes në krye të faqes. Ai hyn në fuqi menjëherë, pa qenë nevoja të ruani pjesën tjetër të formularit.
- Display language — zgjidhni gjuhën në të cilën do të shfaqet faqja e cilësimeve. Si parazgjedhje ajo ndjek gjuhën e shfletuesit tuaj dhe kthehet në anglisht kur gjuha juaj nuk mbështetet. Mund ta anashkaloni duke zgjedhur një gjuhë tjetër nga lista. Zgjedhja juaj hyn në fuqi menjëherë, mbahet mend për herën tjetër dhe ruhet vetëm në këtë pajisje. Ajo nuk i ndryshon cilësimet e tjera.
- Reveal the URL — zgjidhni mënyrën inline ose tooltip (title), si më sipër.
- Highlight mismatching links — aktivizoni ose çaktivizoni theksimin e mospërputhjeve.
- Mismatch colour — ngjyra CSS që përdoret për një lidhje të shënuar,
për shembull
red,#cc0000osergb(200, 0, 0). Ngjyra e parazgjedhur është e kuqja. - Match colour — ngjyra e URL-së së zbuluar te lidhjet e ndershme pa
mospërputhje, për shembull
blackose#1a1a1a. Vlera e parazgjedhur është një gri shumë e errët dhe neutrale (#1a1a1a), e zgjedhur që ngjyra të mos sugjerojë se lidhja është verifikuar. - Only annotate mismatching links — lërini lidhjet e ndershme të paprekura.
- Ignore these hosts — një listë hostnames që duhen anashkaluar plotësisht, një për rresht. Anashkalohen edhe nëndomenet e hostit të renditur.
- Maximum displayed URL length — URL-të e gjata shkurtohen pas këtij numri karakteresh, duke e mbajtur hostin të dukshëm. Diapazoni i lejuar: 20 deri në 2000.
- Revealed URL font size / weight dhe Warning badge font size / weight — zëvendësime opsionale të tipografisë. Lërini bosh nëse doni të ruani vlerat e parazgjedhura.
Përveç ndërprerësit kryesor Enable dhe kontrolleve Active sites, të cilat zbatohen menjëherë, ndryshimet ruhen me butonin Save settings.
Sitet aktive — shtimi i webmail-it tuaj
Seksioni Active sites në krye të faqes së cilësimeve rendit faqet në të cilat funksionon Reveal URLs dhe container-in që përmban trupin e çdo mesazhi.
Çdo rresht tregon:
- match pattern-in e faqes, për shembull
https://mail.example.com/* - një ndërprerës Enabled
- message-body selector, pra selector-in CSS për container-in që Reveal URLs shënon dhe që mund ta redaktoni
- një ndërprerës Sub-frames, për faqet trupi i mesazhit i të cilave shfaqet brenda një iframe
- një buton Remove, vetëm për faqet që keni shtuar vetë
Ofruesit e integruar, si Gmail, Outlook dhe Proton, mund të çaktivizohen ose të ridrejtohen, por nuk mund të hiqen.
Për të shtuar faqen tuaj të webmail-it:
- Te Add site, shkruani një Match URL — një match pattern si
https://mail.example.com/*. - Shkruani një Message-body selector — një selector CSS për container-in
që mban trupin e mesazhit, për shembull
.message-body. - Nëse trupi i mesazhit shfaqet brenda një nënkornize, shënoni Also run inside sub-frames.
- Klikoni Add site. Shfletuesi juaj do t'ju kërkojë leje për të hyrë në atë faqe. Jepeni. Faqja shtohet vetëm pasi ta miratoni lejen.
Ndryshimet këtu zbatohen menjëherë. Heqja e një faqeje që keni shtuar revokon gjithashtu lejen e saj, ndaj Reveal URLs nuk do ta përdorë më.
Thunderbird (dhe klientë të tjerë poste). Thunderbird tashmë shfaq çdo mesazh që lexoni, pavarësisht nga ofruesi, kështu që nuk ka nevojë për një listë sipas hostit. Për këtë arsye seksioni Active sites nuk shfaqet në faqen e cilësimeve të Thunderbird-it. Atje shfaqen vetëm ndërprerësi kryesor, gjuha e shfaqjes, mënyra e zbulimit, ngjyrat, fontet dhe lista e anashkalimeve. Çdo konfigurim i siteve aktive që mund të keni vendosur në shfletues mbetet i paprekur. Ruajtja e cilësimeve në Thunderbird nuk e pastron kurrë atë.
Shtesat për Outlook dhe Gmail
Përveç zgjerimit të shfletuesit dhe shtesës për Thunderbird, Reveal URLs vjen edhe si shtesë vendase për dy aplikacione emaili ku një zgjerim shfletuesi nuk mund të arrijë: Outlook add-in dhe Gmail add-on. Të dy përdorin të njëjtin zbulim lidhjesh si zgjerimi, ndaj zbulojnë të njëjtat URL dhe shënojnë të njëjtët hoste look-alike.
Dallimi i vetëm është mënyra si i paraqesin gjetjet. Zgjerimi i shfletuesit i shënon lidhjet në vend, duke ngjyrosur URL-në mbi ose pranë secilës lidhje. Kornizat e Outlook-it dhe Gmail-it nuk i lejojnë shtesës të ndryshojë mesazhin e paraqitur, prandaj secila shtesë shfaq në vend të kësaj një panel anësor (Outlook) ose kartë (Gmail) me lidhjet e gjetura. Për secilën lidhje shfaqen teksti i dukshëm, URL-ja e destinacionit dhe hosti registrable, ndërsa mospërputhja shënohet kur teksti i dukshëm përmend një domen registrable të ndryshëm nga ai ku lidhja shkon realisht.
- Outlook add-in — një task pane që lexon mesazhin e hapur dhe e analizon në pajisjen tuaj. Asnjë e dhënë emaili ose mesazhi nuk dërgohet askund. Kodi i task pane-it, pra HTML, JavaScript, CSS dhe ikonat, ngarkohet nga https://www.reveal-urls.eu përmes HTTPS-it, ashtu si kur hapni çdo faqe web. Ai mbulon Outlook on the web, Windows, Mac, iOS, Android dhe Outlook.com.
- Gmail add-on — një kartë në shiritin anësor të Gmail-it. Hapni një mesazh dhe pastaj klikoni ikonën Reveal URLs në shiritin anësor të djathtë për të parë lidhjet e tij. Gmail nuk e hap kartën vetë, por nëse panelin e lini të hapur ai rifreskohet ndërsa kaloni nga një mesazh te tjetri. URL-ja e çdo lidhjeje shfaqet me gri të errët neutrale për një lidhje të ndershme dhe me të kuqe për një look-alike. Ai mbulon Gmail-in në web, në Android dhe në iOS. Ndryshe nga format e tjera, Gmail add-on funksionon në serverët e Google-it, kështu funksionojnë shtesat e Gmail-it. Mesazhi që hapni lexohet dhe kontrollohet atje sa herë që e hapni dhe nuk ruhet. Te politika e privatësisë shihni çfarë akseson dhe ruan secila formë.
Të dyja shtesat do të shpërndahen përmes dyqaneve të tyre të aplikacioneve: Outlook add-in nëpërmjet Microsoft AppSource, ndërsa Gmail add-on nëpërmjet Google Workspace Marketplace. Publikimi është ende në proces. Lidhje të drejtpërdrejta instalimi do të shtohen këtu sapo secili listim të bëhet aktiv.
Gjuhët
Reveal URLs është i disponueshëm në anglisht dhe në shumë gjuhë të tjera.
- Faqja e cilësimeve ndjek automatikisht gjuhën e shfletuesit tuaj dhe kthehet në anglisht kur gjuha juaj nuk mbështetet. Këtë mund ta anashkaloni në çdo kohë me përzgjedhësin Display language pranë kryes së faqes. Zgjedhja juaj mbahet mend në atë pajisje. Shihni Faqja e cilësimeve.
- Kjo faqe web, pra faqja hyrëse dhe këto faqe dokumentacioni, njeh gjithashtu gjuhën e shfletuesit tuaj dhe ofron një përzgjedhës gjuhe në krye. Udhëzuesi dhe faqet e privatësisë janë të përkthyera. Aty ku mungon ende përkthimi për një faqe, shfaqet versioni anglisht.
Teksti jo anglisht është i përkthyer automatikisht dhe pret rishikim nga njeriu, ndaj ndonjë formulim mund të tingëllojë herë pas here pak i ngurtë. Synimi është që kuptimi të jetë i njëjtë me origjinalin anglisht. Në se vini re një përkthim të gabuar, hapni një issue te Codeberg issue tracker.
Privatësia
Reveal URLs nuk dërgon asnjë të dhënë nga emaili ose mesazhi juaj te ne apo te palë të treta, në asnjë nga format e tij. Nuk ka analytics dhe nuk ka tracking. Vendi dhe mënyra se si kryhet puna varen nga forma:
- Zgjerimi i shfletuesit dhe shtesa për Thunderbird funksionojnë tërësisht në pajisjen tuaj dhe nuk transmetojnë asgjë. Ata lexojnë tekstin e lidhjeve, URL-të dhe ngjyrat e faqes ndërsa ajo renderohet, pa i ruajtur ose dërguar ato.
- Outlook add-in analizon mesazhin e hapur në pajisjen tuaj dhe nuk dërgon askund asnjë të dhënë emaili ose mesazhi. Kodi i task pane-it, pra HTML, JavaScript, CSS dhe ikonat, ngarkohet nga https://www.reveal-urls.eu përmes HTTPS-it, si çdo faqe tjetër web.
- Gmail add-on funksionon në serverët e Google-it, kështu punojnë shtesat e Gmail-it. Mesazhi i hapur lexohet dhe kontrollohet atje sa herë që e hapni dhe nuk ruhet.
E vetmja gjë që ruhet janë cilësimet tuaja, si fakti nëse Reveal URLs është i aktivizuar ose jo, mënyra e zbulimit, ngjyrat, madhësitë e shkronjave, lista juaj e anashkalimeve dhe çdo faqe që keni shtuar. Ato ruhen në per-user storage të shfletuesit tuaj, të Outlook-it ose të Google-it dhe nuk na dërgohen kurrë neve.
Për hollësitë e plota shihni politikën e privatësisë.
Zgjidhja e problemeve
Një lidhje nuk po shfaqet.
- Kontrolloni që Reveal URLs të jetë i aktivizuar. Ikona në shiritin e veglave nuk duhet të tregojë shenjën OFF, dhe ndërprerësi Enable Reveal URLs në faqen e cilësimeve duhet të jetë aktiv.
- Kontrolloni që faqja të jetë e mbuluar. Ofruesit e integruar, Gmail, Outlook dhe Proton, punojnë menjëherë. Çdo webmail tjetër duhet të shtohet te Active sites me match URL-në dhe message-body selector-in e tij.
- Kontrolloni message-body selector-in. Nëse ai nuk përputhet me container-in që përmban trupin e mesazhit, lidhjet brenda atij container-i nuk do të zbulohen.
- Mbani parasysh se lidhjet drejt ankorave brenda së njëjtës faqe dhe
lidhjet që përdorin scheme të ndryshme nga
http/https, simailto:, anashkalohen me qëllim. E njëjta gjë vlen për hostet në listën tuaj Ignore these hosts.
Një ofrues i integruar ndaloi së funksionuari pas një ridizajnimi.
Ofruesit e webmail-it e ndryshojnë herë pas here markup-un e faqeve të tyre. Nëse selector-i i një ofruesi të integruar nuk përputhet më pas një ndryshimi të tillë, mund ta korrigjoni vetë: te Active sites redaktoni message-body selector-in e atij ofruesi që të tregojë te container-i i ri.
URL-ja në tooltip nuk shfaqet.
Në mënyrën tooltip (title), URL-ja e vërtetë vendoset në tooltip-in e lidhjes, ndaj ajo shfaqet vetëm kur mbani treguesin mbi të. Nëse doni ta shihni URL-në pa hover, kaloni Reveal the URL në mënyrën inline.
Licenca dhe kodi burimor
Reveal URLs është software i lirë me licencë GNU Affero General Public License v3.0 (AGPL-3.0-only).
- Kodi burimor: https://codeberg.org/Magentron/reveal-urls
- Përmbledhje teknike: Architecture
- Më shumë rreth phishing-ut me lidhje: Email link phishing: your app should always show the URL




