Reveal URLs — Manual de utilizare
Reveal URLs este o mică extensie de browser (și supliment pentru Thunderbird) care vă arată unde duce cu adevărat un link din e-mailul dumneavoastră, ca să puteți detecta un link de phishing înainte de a da clic pe el.
Acest manual explică cum se instalează Reveal URLs și cum se folosește. Pentru modul în care sunt tratate datele dumneavoastră, consultați politica de confidențialitate; pentru o descriere tehnică a modului în care este construită extensia, consultați descrierea arhitecturii.
Ați găsit un bug, un link care a fost semnalat greșit (sau omis) ori o gazdă de webmail care ar trebui să fie acceptată? Vă rugăm să îl raportați în gestionarul de probleme Codeberg.
Cuprins
- Ce face și de ce
- Browsere compatibile și clientul de e-mail
- Instalare
- Cum se folosește
- Suplimentele Outlook și Gmail
- Limbi
- Confidențialitate
- Depanare
- Licență și cod sursă
Ce face și de ce
Un e-mail de phishing ascunde o destinație ostilă în spatele unui text de link care pare
de încredere. Uneori este o gazdă care imită: textul afișează paypal.com, în timp ce
linkul indică paypa1.com. Adesea este mai subtil, trecând printr-un tracker sau un
redirecționator, astfel încât locul unde ajungeți nu seamănă deloc cu marca menționată în text.

parcel-pay.custom.co.xa, nu la Poșta Română.Notă: Această captură de ecran arată un e-mail de phishing fraudulos care se dă drept Poșta Română. Poșta Română nu este afiliată cu Reveal URLs și nu îl susține.
Reveal URLs citește fiecare link din mesajul pe care îl citiți și vă arată URL-ul către care indică. Atunci când gazda menționată în textul linkului nu corespunde cu gazda către care indică de fapt linkul, Reveal URLs o semnalează, astfel încât nepotrivirea să fie evidentă înainte de a da clic.
În extensia de browser și în suplimentul Thunderbird, totul se întâmplă pe propriul dumneavoastră dispozitiv, fără a transmite nimic. În toate formele, Reveal URLs nu trimite niciuna dintre datele dumneavoastră de e-mail către noi sau către terți — nu există analize și nici urmărire. (Formele diferă prin locul unde rulează și prin modul în care este servit codul panoului Outlook; consultați secțiunea Confidențialitate și politica de confidențialitate pentru toate detaliile.)
Browsere compatibile și clientul de e-mail
Reveal URLs rulează pe:
- Google Chrome
- Microsoft Edge
- Opera
- Mozilla Firefox
- Mozilla Thunderbird (clientul de e-mail pentru desktop)
O versiune Safari nu a fost încă lansată; este planificată pentru o etapă ulterioară.
Pe browsere, Reveal URLs adnotează linkurile din webmailul dumneavoastră. În Thunderbird adnotează linkurile din e-mailul pe care îl citiți direct în clientul de e-mail.
Instalare
Din magazinul browserului sau clientului de e-mail (recomandat)
Instalați Reveal URLs din magazinul pentru browserul sau clientul dumneavoastră de e-mail. Listările Chrome, Edge, Firefox și Thunderbird sunt active; Opera rulează versiunea Chrome, iar o listare dedicată Opera este încă pe drum:
- Chrome — Chrome Web Store
- Edge — Microsoft Edge Add-ons
- Opera — instalați versiunea Chrome din Chrome Web Store; o listare dedicată Opera va apărea în curând
- Firefox — Firefox Add-ons (AMO)
- Thunderbird — Thunderbird Add-ons (ATN)
Încărcarea unei versiuni pe cont propriu (dezvoltatori și testare timpurie)
Dacă ați compilat Reveal URLs din sursă, puteți încărca versiunea despachetată
direct. Fiecare țintă se compilează cu o comandă make și este produsă sub
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
Apoi încărcați folderul rezultat:
- Chrome — deschideți
chrome://extensions, activați Modul dezvoltator, dați clic pe Încarcă despachetat și selectațidist/chrome. - Edge — deschideți
edge://extensions, activați Modul dezvoltator, dați clic pe Încarcă despachetat și selectațidist/edge. - Opera — deschideți
opera://extensions, activați Modul dezvoltator, dați clic pe Încarcă despachetat și selectațidist/opera. - Firefox — deschideți
about:debugging, alegeți Acest Firefox, dați clic pe Încarcă supliment temporar și selectați orice fișier dindist/firefox(de exemplumanifest.json). Un supliment temporar este eliminat când Firefox repornește. - Thunderbird — instalați suplimentul temporar din
dist/thunderbirdîn același mod (prin Instrumente → Instrumente pentru dezvoltatori → Depanare suplimente → Încarcă supliment temporar).
Pagina de setări se deschide automat la prima instalare a extensiei.
Cum se folosește
Din start, Reveal URLs adnotează linkurile din mesajele de la furnizorii încorporați — fără nicio configurare:
- Gmail (
mail.google.com) - Outlook Live (
outlook.live.com) - Outlook pe web / Microsoft 365 (
outlook.office.com) - Proton Mail (
mail.proton.me)
Adnotarea este limitată la corpul mesajului, astfel încât interfața proprie a aplicației — bara sa laterală, fereastra de compunere și barele de instrumente — rămâne neatinsă. În Thunderbird, întregul e-mail redat este acoperit.
Cele două moduri de afișare
Alegeți cum este afișat URL-ul real, sub Afișați URL-ul pe pagina de setări:
- În linie — URL-ul real este afișat pe propria linie, chiar deasupra textului linkului. Aceasta este valoarea implicită.
- În sfatul ecran al linkului (title) — URL-ul real este plasat în sfatul ecran al linkului, astfel încât apare când treceți cu mausul peste link.
Evidențierea nepotrivirilor
Atunci când gazda menționată în textul vizibil al unui link nu corespunde cu gazda către care
indică de fapt linkul, Reveal URLs o semnalează ca nepotrivire. Comparația se face pe
domeniul înregistrabil, astfel încât un subdomeniu cinstit precum mail.example.com pentru
example.com nu este semnalat, în timp ce unul care imită precum paypa1.com pentru
paypal.com este.
- În modul în linie, o nepotrivire este afișată în culoarea de nepotrivire aleasă de dumneavoastră și cu caractere aldine.
- În modul sfat ecran (title), o insignă distinctivă ⚠ URL mismatch este adăugată lângă link.
Două setări conexe controlează acest lucru:
- Evidențiați linkurile nepotrivite activează sau dezactivează accentuarea nepotrivirilor.
- Adnotați doar linkurile nepotrivite lasă linkurile cinstite complet neatinse, astfel încât doar cele suspecte sunt afișate.
Butonul din bara de instrumente
În Chrome, Edge, Opera, Firefox și Thunderbird, pictograma Reveal URLs din bara de instrumente este un comutator rapid pornit/oprit — faceți clic pe ea pentru a comuta adnotarea. Când extensia este oprită, pe pictogramă apare un indicator OFF, iar balonul său explicativ vă spune dacă un clic o va porni sau o va opri. În browsere, schimbarea intră în vigoare în toate filele deschise deodată; în Thunderbird se aplică următorului mesaj pe care îl deschideți.
(În Thunderbird, butonul afișează doar pictograma sa, astfel încât rămâne compact în bara de instrumente unificată. De asemenea, puteți porni și opri Reveal URLs cu comutatorul Activați de pe pagina de setări.)
Pagina de setări
Pagina de setări conține fiecare opțiune. Deschideți-o din pagina de extensii a browserului dumneavoastră (de exemplu Detalii → Opțiuni extensie) sau se deschide automat la prima instalare.
- Activați Reveal URLs — comutatorul principal pornit/oprit, chiar în partea de sus a paginii. Are efect imediat, fără a fi necesar să salvați restul formularului.
- Limba de afișare — alegeți limba în care este afișată pagina de setări. În mod implicit urmează limba browserului dumneavoastră, revenind la engleză; alegeți alta din listă pentru a o suprascrie. Alegerea dumneavoastră are efect imediat, este reținută pentru data viitoare și este stocată doar pe acest dispozitiv (nu modifică niciodată restul setărilor dumneavoastră).
- Afișați URL-ul — alegeți modul în linie sau sfat ecran (title) (vezi mai sus).
- Evidențiați linkurile nepotrivite — activați sau dezactivați accentuarea nepotrivirilor.
- Culoare la nepotrivire — culoarea CSS folosită pentru un link semnalat (de exemplu
red,#cc0000saurgb(200, 0, 0)). Valoarea implicită este roșu. - Culoare la potrivire — culoarea URL-ului afișat pe linkurile cinstite (fără nepotrivire)
(de exemplu
blacksau#1a1a1a). Valoarea implicită este un gri foarte închis neutru (#1a1a1a), ales astfel încât culoarea să nu sugereze că linkul a fost verificat. - Adnotați doar linkurile nepotrivite — lăsați linkurile cinstite neatinse.
- Ignorați aceste gazde — o listă de nume de gazdă de ignorat complet, câte unul pe linie. Subdomeniile unei gazde listate sunt de asemenea ignorate.
- Lungimea maximă a URL-ului afișat — URL-urile lungi sunt trunchiate după acest număr de caractere, păstrând gazda vizibilă. Interval permis: 20 până la 2000.
- Dimensiunea/grosimea fontului URL-ului afișat și Dimensiunea/grosimea fontului insignei de avertizare — suprascrieri opționale de tipografie; lăsați necompletat pentru a păstra valorile implicite.
Cu excepția comutatorului principal Activați și a controalelor Site-uri active (care se aplică imediat), modificările se salvează cu butonul Salvați setările.
Site-uri active — adăugarea propriei căsuțe de webmail
Secțiunea Site-uri active, din partea de sus a paginii de setări, listează paginile pe care rulează Reveal URLs și containerul care conține corpul fiecărui mesaj.
Fiecare rând afișează:
- tiparul de potrivire al site-ului (de exemplu
https://mail.example.com/*); - un comutator Activat;
- selectorul pentru corpul mesajului (selectorul CSS pentru containerul pe care Reveal URLs îl adnotează), pe care îl puteți edita;
- un comutator Subcadre, pentru site-urile al căror corp de mesaj este redat într-un iframe;
- un buton Eliminați (doar pentru propriile site-uri).
Furnizorii încorporați (Gmail, Outlook și Proton) pot fi dezactivați și reorientați, dar nu pot fi eliminați.
Pentru a adăuga propriul site de webmail:
- Sub Adăugați site, introduceți un URL de potrivire — un tipar de potrivire precum
https://mail.example.com/*. - Introduceți un Selector pentru corpul mesajului — un selector CSS pentru containerul care
conține corpul mesajului, de exemplu
.message-body. - Dacă corpul mesajului este redat într-un subcadru, bifați Rulați și în subcadre.
- Dați clic pe Adăugați site. Browserul dumneavoastră va cere permisiunea de a accesa acel site; acordați-o. Site-ul este adăugat doar după ce acordați permisiunea.
Modificările de aici se aplică imediat. Eliminarea unui site pe care l-ați adăugat revocă și permisiunea sa, astfel încât Reveal URLs încetează să îl mai acceseze.
Thunderbird (și alte clienți de e-mail). Thunderbird afișează deja fiecare mesaj pe care îl citiți, indiferent de furnizor, așa că nu are nevoie de o listă per gazdă. Secțiunea Site-uri active nu este, prin urmare, afișată pe pagina de setări Thunderbird — apar doar comutatorul principal, limba de afișare, modul de afișare, culorile, fonturile și lista de ignorare. Orice configurație de site-uri active pe care ați fi putut-o seta într-un browser este păstrată neatinsă: salvarea setărilor Thunderbird nu o șterge niciodată.
Suplimentele Outlook și Gmail
Pe lângă extensia de browser și suplimentul Thunderbird, Reveal URLs este disponibil ca supliment nativ pentru două aplicații de e-mail pe care o extensie de browser nu le poate atinge: un supliment Outlook și un supliment Gmail. Amândouă folosesc aceeași detecție de linkuri ca extensia, așa că afișează aceleași URL-uri și semnalează aceleași gazde care imită.
Singura diferență este modul în care își afișează constatările. Extensia de browser adnotează linkurile pe loc — colorând URL-ul deasupra sau lângă fiecare link. Cadrele Outlook și Gmail nu permit unui supliment să modifice mesajul redat, așa că, în schimb, fiecare supliment afișează un panou lateral (Outlook) sau card (Gmail) care listează linkurile găsite. Pentru fiecare link afișează textul vizibil, URL-ul de destinație și gazda înregistrabilă și semnalează o nepotrivire atunci când textul vizibil indică un alt domeniu înregistrabil decât cel către care indică de fapt linkul.
- Suplimentul Outlook — un panou de activități care citește mesajul pe care îl aveți deschis și îl analizează pe propriul dumneavoastră dispozitiv; nu se trimit nicăieri date de e-mail sau de mesaj. Codul panoului său de activități (HTML, JavaScript, CSS și pictograme) este încărcat de pe https://www.reveal-urls.eu prin HTTPS, așa cum se întâmplă când deschideți orice pagină web. Ajunge la Outlook pe web, Windows, Mac, iOS și Android, precum și la Outlook.com.
- Suplimentul Gmail — un card în bara laterală a Gmail. Deschideți un mesaj, apoi dați clic pe pictograma Reveal URLs din bara laterală din dreapta pentru a-i vedea linkurile: Gmail nu deschide cardul singur, dar dacă lăsați panoul deschis, acesta se reîmprospătează pe măsură ce treceți de la un mesaj la altul. URL-ul fiecărui link este afișat într-un gri închis neutru pentru un link cinstit și cu roșu pentru unul care imită. Ajunge la Gmail pe web, Android și iOS. Spre deosebire de celelalte forme, suplimentul Gmail rulează pe serverele Google (așa funcționează suplimentele Gmail): mesajul pe care îl deschideți este citit și verificat acolo, de fiecare dată când îl deschideți, și nu este reținut. Consultați politica de confidențialitate pentru ce accesează și stochează fiecare formă.
Ambele suplimente vor fi distribuite prin magazinele lor de aplicații — suplimentul Outlook prin Microsoft AppSource, suplimentul Gmail prin Google Workspace Marketplace. Publicarea este în așteptare; linkurile de instalare directă vor fi adăugate aici odată ce fiecare listare este activă.
Limbi
Reveal URLs este disponibil în engleză și în multe alte limbi.
- Pagina de setări urmează automat limba browserului dumneavoastră, revenind la engleză când limba dumneavoastră nu este una dintre cele de mai sus. O puteți suprascrie oricând cu comutatorul Limba de afișare de lângă partea de sus a paginii; alegerea dumneavoastră este reținută pe acel dispozitiv (vezi Pagina de setări).
- Acest website (pagina de pornire și aceste pagini de documentație) detectează și limba browserului dumneavoastră și oferă un comutator de limbă în antet. Manualul și paginile de confidențialitate sunt disponibile traduse; acolo unde o pagină nu are încă o traducere, este afișată în engleză.
Textul care nu este în engleză este tradus automat și este în așteptarea revizuirii umane, așa că o frază poate suna ocazional stângaci; sensul este menit să corespundă cu originalul englez. Dacă observați o traducere greșită, vă rugăm să deschideți o problemă în gestionarul de probleme Codeberg.
Confidențialitate
Reveal URLs nu trimite niciuna dintre datele dumneavoastră de e-mail sau de mesaj către noi sau către terți, în niciuna dintre formele sale — nu există analize și nici urmărire. Cum și unde se întâmplă activitatea depinde de formă:
- Extensia de browser și suplimentul Thunderbird funcționează în întregime pe propriul dumneavoastră dispozitiv și nu transmit nimic: citesc textul linkului, URL-urile și culorile paginii pe măsură ce pagina este redată, fără a le stoca sau trimite vreodată.
- Suplimentul Outlook analizează mesajul deschis pe propriul dumneavoastră dispozitiv și nu trimite nicăieri date de e-mail sau de mesaj; codul panoului său de activități (HTML, JavaScript, CSS și pictograme) este încărcat de pe https://www.reveal-urls.eu prin HTTPS, așa cum se întâmplă când deschideți orice pagină web.
- Suplimentul Gmail rulează pe serverele proprii ale Google (așa funcționează suplimentele Gmail): mesajul deschis este citit și verificat acolo, de fiecare dată când îl deschideți, și nu este reținut.
Singurul lucru stocat sunt propriile dumneavoastră setări (precum activat/dezactivat, modul de afișare, culorile, dimensiunile fonturilor, lista dumneavoastră de ignorare și orice site-uri pe care le-ați adăugat), păstrate în stocarea per utilizator a browserului, a Outlook sau a Google și niciodată trimise către noi.
Consultați politica de confidențialitate pentru toate detaliile.
Depanare
Un link nu este afișat.
- Verificați că Reveal URLs este pornit — pictograma din bara de instrumente nu trebuie să afișeze insigna OFF, iar comutatorul Activați Reveal URLs de pe pagina de setări trebuie să fie pornit.
- Verificați că site-ul este acoperit. Furnizorii încorporați (Gmail, Outlook, Proton) funcționează din start; orice alt webmail trebuie adăugat sub Site-uri active cu URL-ul său de potrivire și selectorul pentru corpul mesajului.
- Verificați selectorul pentru corpul mesajului. Dacă nu corespunde containerului care conține corpul mesajului, linkurile din interiorul acelui container nu vor fi afișate.
- Rețineți că linkurile către ancore din aceeași pagină și linkurile care folosesc scheme, altele decât
http/https(precummailto:), sunt omise în mod deliberat — la fel ca gazdele de pe lista dumneavoastră Ignorați aceste gazde.
Un furnizor încorporat a încetat să funcționeze după o reproiectare.
Furnizorii de webmail își schimbă marcajul paginilor din când în când. Dacă selectorul unui furnizor încorporat nu mai corespunde după o astfel de schimbare, îl puteți corecta singur: în Site-uri active, editați selectorul pentru corpul mesajului al acelui furnizor la noul container.
URL-ul din sfatul ecran nu se afișează.
În modul sfat ecran (title), URL-ul real este plasat în sfatul ecran al linkului, așa că apare doar când treceți cu mausul peste link. Dacă preferați să vedeți URL-ul fără a trece cu mausul, comutați Afișați URL-ul la modul în linie.
Licență și cod sursă
Reveal URLs este software liber, licențiat sub GNU Affero General Public License v3.0 (AGPL-3.0-only).
- Cod sursă: https://codeberg.org/Magentron/reveal-urls
- Descriere tehnică: Arhitectură
- Lectură suplimentară despre phishingul prin linkuri: Email link phishing: your app should always show the URL




