Safari is supported through its macOS Xcode container and App Store route. Built-in providers use static scripts and Safari requests no all-sites access. A user-added site needs a runtime optional permission, then Safari injects content.js after navigation only for a granted, enabled, non-builtin rule; sub-frames run only when All frames is enabled. Safari settings are device-local and do not roam.

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 întrebări obișnuite, consultați întrebările frecvente; pentru modul în care sunt tratate datele dumneavoastră, consultați politica de confidențialitate; pentru o descriere tehnică, 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 aplicații 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.

Notă: Această captură de ecran arată un e-mail de phishing fraudulos care se dă drept un serviciu poștal. Serviciul imitat 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ă. În extensia de browser și în suplimentul Thunderbird, semnalează linkuri web, de e-mail, telefonice și de alte tipuri înșelătoare, astfel încât diferența să fie evidentă înainte de a da clic.

Reveal URLs dezvăluie și semnalează; nu verifică. Nu urmărește redirecționările: un link care trece printr-un tracker sau redirecționator este afișat ca URL-ul trackerului ori redirecționatorului pe care îl indică de fapt; Reveal URLs nu poate ști unde ajunge în cele din urmă acea redirecționare. Pentru un link fără avertisment, nu a fost detectată nicio nepotrivire aplicabilă, dar aceasta nu confirmă că este sigur; așadar, citiți URL-ul dezvăluit înainte de a avea încredere într-un link, chiar și când nu este semnalat nimic. Ca să țineți minte asta, URL-ul dezvăluit al unui link nesemnalat este afișat într-o culoare chihlimbarie „de verificat“ în loc de un verde liniștitor.

Notă: adresele de e-mail, URL-urile și numele din această captură de ecran au fost mascate cu asteriscuri pentru confidențialitate.

Î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 aplicații de e-mail

Reveal URLs rulează pe:

Browsere web:

• Brave
• Google Chrome
• Microsoft Edge
• Mozilla Firefox
• Opera
• Safari

Aplicații de e-mail:

• Gmail
• Outlook
• Mozilla Thunderbird (clientul de e-mail pentru desktop)

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. Toate listările sunt acum disponibile; Opera rulează versiunea Chrome.

Browsere web:

• Brave — instalați versiunea Chrome din Chrome Web Store
• Chrome — Chrome Web Store
• Edge — Microsoft Edge Add-ons
• Firefox — Firefox Add-ons (AMO)
• Opera — instalați versiunea Chrome din Chrome Web Store
• Safari — App Store

Aplicații de e-mail:

• Gmail — Google Workspace Marketplace
• Outlook — Microsoft Marketplace
• 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        # generează dist/chrome
make build-edge          # generează dist/edge
make build-firefox       # generează dist/firefox
make build-gmail         # generează dist/gmail
make build-opera         # generează dist/opera
make build-outlook       # generează dist/outlook
make build-safari        # generează dist/safari
make build-thunderbird   # generează 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ți dist/chrome.
• Edge — deschideți edge://extensions, activați Modul dezvoltator, dați clic pe Încarcă despachetat și selectați dist/edge.
• Firefox — deschideți about:debugging, alegeți Acest Firefox, dați clic pe Încarcă supliment temporar și selectați orice fișier din dist/firefox (de exemplu manifest.json). Un supliment temporar este eliminat când Firefox repornește.
• Opera — deschideți opera://extensions, activați Modul dezvoltator, dați clic pe Încarcă despachetat și selectați dist/opera.
• Thunderbird — instalați suplimentul temporar din dist/thunderbird în același mod (prin Instrumente → Instrumente pentru dezvoltatori → Depanare suplimente → Încarcă supliment temporar).

Extensia Safari, suplimentul Outlook și suplimentul Gmail nu sunt încărcate ca extensii de browser despachetate. Compilați-le ca mai sus, apoi:

make deploy-gmail        # implementează suplimentul Gmail în Apps Script
make safari-xcode        # compilează proiectul Safari Xcode, apoi rulați-l
                         # din meniul Develop al Safari (macOS)
                         # Outlook: încărcați lateral dist/outlook

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:

• FastMail (app.fastmail.com)
• Gmail (mail.google.com)
• Outlook Live (outlook.live.com)
• Outlook pe web / Microsoft 365 (outlook.office.com)
• Proton Mail (mail.proton.me)
• Tuta (app.tuta.com, mail.tutanota.com)
• Yahoo Mail (mail.yahoo.com)
• Zoho Mail (mail.zoho.com.au, mail.zoho.com.cn, mail.zoho.com, mail.zoho.eu, mail.zoho.in, mail.zoho.jp, mail.zoho.sa, mail.zohocloud.ca)

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.

Notă: adresele de e-mail, URL-urile și numele din această captură de ecran au fost mascate cu asteriscuri pentru confidențialitate.

Cum este afișat URL-ul real

URL-ul real al fiecărui link este afișat pe propria linie, chiar deasupra textului linkului. Acesta este plasat și în sfatul ecran al linkului (titlu), astfel încât URL-ul complet este mereu acolo când treceți cu mausul peste link.

Evidențierea nepotrivirilor

Pentru linkurile web, Reveal URLs compară numele URL-urilor sau ale hosturilor din textul vizibil al unui link cu URL-ul către care acesta indică. Comparația se face pe domeniul înregistrabil, astfel încât un subdomeniu fără neconcordanțe precum mail.example.com pentru example.com nu este semnalat, în timp ce unul care imită precum paypa1.com pentru paypal.com este. Extensia de browser și Thunderbird verifică și linkurile de e-mail, telefonice și opace; linkurile javascript:, data: și vbscript: sunt mereu semnalate.

Verificarea examinează numai URL-ul indicat de linkul însuși; redirecționările nu sunt urmărite niciodată, deci un link printr-un tracker sau redirecționator este comparat cu URL-ul acestuia, nu cu pagina la care ajunge în cele din urmă.

O nepotrivire este afișată în culoarea de nepotrivire aleasă de dumneavoastră și cu caractere aldine.

Două setări conexe controlează acest lucru:

• Evidențiați linkurile nepotrivite activează sau dezactivează accentuarea nepotrivirilor.
• Afișează în linie numai linkurile nepotrivite ascunde dezvăluirea vizibilă în linie pentru linkurile fără nepotriviri, dar continuă să scrie URL-ul lor de destinație în atributul title al linkului, astfel încât apare la trecerea cursorului.

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.

Cât timp Reveal URLs este activat, pictograma din bara de instrumente a browserului vă indică, de asemenea, pentru fiecare filă, ce a găsit pe pagina curentă. Dacă pagina are linkuri nepotrivite (asemănătoare), pictograma afișează acel număr pe o insignă roșie; dacă pagina are linkuri, dar niciunul nu este discordant, afișează numărul total de linkuri analizate pe o insignă gri; o pagină fără linkuri analizabile (și orice pagină asupra căreia extensia nu acționează) nu afișează niciun număr. Fiecare filă își păstrează propria insignă, așa că trecerea de la o filă la alta actualizează numărul, iar părăsirea paginii sau închiderea filei îl șterge. (Numerele mai mari de 99 sunt afișate ca 99+.)

Insigna în stările sale (browserul o desenează, deci poziționarea exactă variază puțin în funcție de browser): un număr roșu de nepotriviri, un număr gri de linkuri analizate și insigna OFF cât timp extensia este dezactivată; logoul său este de asemenea gri-deschis estompat. Pe o pagină unde extensia activată nu este activă nu există insignă; insigna OFF care lipsește deosebește același logo estompat de starea dezactivată.

Aceste ilustrații nu arată fiecare caz fără insignă; o pagină activă fără linkuri care pot fi analizate păstrează pictograma în culoarea normală.

(Î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ă).
• 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, #cc0000 sau rgb(200, 0, 0)). Valoarea implicită este roșu.
• Culoare fără neconcordanțe — culoarea URL-ului dezvăluit pe linkurile fără neconcordanțe (de exemplu black sau #b45309). Valoarea implicită este un ton chihlimbariu de precauție (#b45309), ales astfel încât un link fără avertisment să nu pară verificat ca sigur.
• Afișează în linie numai linkurile nepotrivite — ascundeți dezvăluirea vizibilă în linie pentru linkurile fără nepotriviri; URL-ul lor de destinație rămâne în atributul title al linkului și apare la trecerea cursorului.
• 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 — 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. Acum păstrează o înălțime fixă: alegeți un site din lista derulantă și editați doar setările acelui site în panoul de dedesubt.

Lista derulantă afișează o intrare pentru fiecare regulă de site:

• regulile încorporate folosesc nume prietenoase precum Gmail, Proton Mail și Outlook (Live);
• când mai multe reguli împart același nume, lista derulantă adaugă host-ul între paranteze, de exemplu Tuta (app.tuta.com) și Zoho Mail (mail.zoho.eu);
• o regulă adăugată de utilizator își folosește Name-ul opțional sau match URL-ul atunci când numele este lăsat gol.

Editorul site-ului selectat afișează:

• Match URL-ul site-ului ca identificator doar pentru citire;
• Name-ul editabil al site-ului;
• un comutator Enabled;
• Message-body selector-ul (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 Remove (doar pentru propriile site-uri).

Furnizorii încorporați (FastMail, Gmail, Outlook Live, Outlook 365, Proton, Tuta, Yahoo și Zoho) pot fi dezactivați și reorientați, dar nu pot fi eliminați. Numele lor pot fi redenumite și aici; golirea numelui unui furnizor încorporat îi restaurează numele prietenos implicit.

Pentru a adăuga propriul site de webmail:

1. Sub Adăugați site, introduceți un URL de potrivire — un tipar de potrivire precum https://mail.example.com/*.
2. Introduceți opțional un Name pentru lista derulantă. Lăsați-l gol pentru a reveni la match URL.
3. Introduceți un Message-body selector — un selector CSS pentru containerul care conține corpul mesajului, de exemplu .message-body.
4. Dacă corpul mesajului este redat într-un subcadru, bifați Also run inside sub-frames.
5. Dați clic pe Add 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. Pentru a schimba match URL-ul unui site, eliminați-l și adăugați-l din nou: match-ul rămâne doar pentru citire deoarece este identitatea regulii.

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, 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. Acestea împărtășesc detectarea URL-urilor/hosturilor http/https a extensiei de browser, dar nu analizează schemele sale suplimentare de linkuri.

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 http/https, afișează textul vizibil și URL-ul de destinație și semnalează o nepotrivire numai când textul vizibil numește un URL sau un host al cărui domeniu înregistrabil nu corespunde celui al destinației linkului.

• 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. Un link care imită este semnalat cu roșu cu o pictogramă de avertizare; URL-ul unui link fără neconcordanțe este afișat în culoarea de text implicită a cardului, care urmează tema deschisă sau întunecată a Gmail. 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ă.

Suplimentul Gmail este acum disponibil prin Google Workspace Marketplace.

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 (FastMail, Gmail, Outlook Live, Outlook 365, Proton, Tuta, Yahoo și Zoho) 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.
• Furnizorii cu open shadow root sunt descoperiți prin scanarea body-ului pe batch-uri imediat ce rulează un batch al body observer-ului după ce host-ul intră în DOM. Un shadow root apărut târziu este actualizat la următorul batch de mutații ale body-ului. Singurul caz nesuportat este atunci când un host sau un shadow root apare și apoi nu se mai declanșează nicio mutație a body-ului în pagină.
• Extensia de browser și Thunderbird dezvăluie și linkurile care folosesc alte scheme — mailto: (e-mail), tel:/sms: (telefon) și scheme opace precum javascript:, data:, vbscript: sau blob: — și le semnalează atunci când textul vizibil indică o altă destinație decât cea către care linkul chiar duce; linkurile javascript:, data: și vbscript: sunt mereu semnalate (de exemplu, o adresă afișată ca billing@paypal.com al cărei mailto: țintește spre alt domeniu, sau un link care pare o adresă web, dar este de fapt un link javascript:). Sunt omise doar linkurile către ancore din aceeași pagină (#…) și linkurile goale sau nevalide, la fel ca gazdele de pe lista dumneavoastră Ignorați aceste gazde. Rețineți că această acoperire mai amplă a schemelor se aplică adnotării inline a extensiei de browser; panourile cu rezultate ale suplimentelor native Outlook și Gmail acoperă în prezent doar linkuri http/https.

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.

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

Note Safari

Safari afişează o insignă numai când linkurile nu corespund; nu are un contor gri pentru pagină sigură. Redeschide setările din meniul de clic dreapta Reveal URLs — settings, în loc să reîncarci o filă veche de setări.