Reveal URLs

Reveal URLs — Lietotāja rokasgrāmata

Reveal URLs ir neliels pārlūka paplašinājums un Thunderbird papildinājums, kas parāda, kur patiesībā ved saite jūsu e-pastā, lai jūs varētu pamanīt phishing saiti pirms noklikšķināšanas uz tās.

Šī rokasgrāmata izskaidro, kā instalēt Reveal URLs un kā to lietot. Par to, kā tiek apstrādāti jūsu dati, skatiet privātuma politiku. Par tehnisku pārskatu par to, kā paplašinājums ir uzbūvēts, skatiet arhitektūras pārskatu.

Vai atradāt kļūdu, nepareizi iezīmētu saiti vai webmail host, kuram vajadzētu būt atbalstītam? Ziņojiet par to Codeberg issue tracker.

Saturs

Ko tas dara un kāpēc

Phishing e-pasts slēpj ļaunprātīgu galamērķi aiz saites teksta, kas izskatās uzticams. Dažreiz tas ir host, kas tikai izskatās pēc īstā: teksts rāda paypal.com, bet saite patiesībā ved uz paypa1.com. Bieži triks ir smalkāks un iziet caur tracker vai redirector, tāpēc vieta, kur jūs nonākat, gandrīz nemaz nelīdzinās zīmolam, kas minēts tekstā.

Pikšķerēšanas e-pastā, kas uzdodas par Latvijas Pastu, teikts, ka sūtījums ir aizturēts, kamēr nav samaksātas nesamaksātās muitas nodevas, un tiek mudināts maksāt, izmantojot pogu „Doties uz apmaksu“. Reveal URLs parāda, ka poga neved uz Latvijas Pastu, bet gan uz parcel-pay.custom.co.xa, nesaistītu vietni, tādējādi atklājot, ka ziņojums ir krāpšana.
Reveal URLs atmasko pogu „Doties uz apmaksu“: tā ved uz parcel-pay.custom.co.xa, nevis uz Latvijas Pastu.

Piezīme: Šajā ekrānuzņēmumā redzams krāpniecisks pikšķerēšanas e-pasts, kas uzdodas par Latvijas Pastu. Latvijas Pasts nav saistīts ar Reveal URLs un to neatbalsta.

Reveal URLs nolasa katru saiti ziņojumā, ko jūs skatāt, un parāda URL, uz kuru tā ved. Kad host, kas minēts saites redzamajā tekstā, nesakrīt ar host, uz kuru saite patiesībā ved, Reveal URLs to iezīmē, lai neatbilstība būtu skaidri redzama pirms klikšķa.

Gmail ziņojums ar ieslēgtu Reveal URLs: maldinoša saite ir iezīmēta sarkanā krāsā, un izsekošanas URL, uz kuru tā ved, ir atklāts virs saites teksta, kamēr godīgas saites URL tiek parādīts bez brīdinājuma.

Pārlūka paplašinājumā un Thunderbird papildinājumā viss notiek jūsu ierīcē, un nekas netiek pārsūtīts. Nevienā no savām formām Reveal URLs nesūta jūsu e-pasta datus mums vai trešajām pusēm: nav analytics un nav tracking. Formas atšķiras tikai ar to, kur tās darbojas un kā tiek pasniegts Outlook paneļa kods. Pilnu informāciju skatiet sadaļā Privātums un privātuma politikā.

Atbalstītie pārlūki un pasta klients

Reveal URLs darbojas:

Safari versija vēl nav izlaista. Tā ir plānota vēlākā posmā.

Pārlūkos Reveal URLs iezīmē saites jūsu webmail ziņojumos. Thunderbird tas iezīmē saites tieši e-pastā, ko lasāt pašā klientā.

Instalēšana

No jūsu pārlūka vai pasta klienta veikala (ieteicams)

Instalējiet Reveal URLs no veikala savam pārlūkam vai pasta klientam. Chrome, Edge, Firefox un Thunderbird ieraksti jau ir pieejami. Opera izmanto Chrome build-u, un atsevišķs Opera ieraksts vēl ir ceļā:

Sava build-a ielāde (izstrādātājiem un agrīnai testēšanai)

Ja esat uzbūvējis Reveal URLs no pirmkoda, varat ielādēt neiepakoto build-u tieši. Katrs target tiek būvēts ar komandu make un izveidots zem 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

Pēc tam ielādējiet atbilstošo mapi:

Iestatījumu lapa automātiski atveras pirmajā paplašinājuma instalēšanas reizē.

Lietošana

Tūlīt pēc instalēšanas Reveal URLs iezīmē saites iebūvēto pakalpojumu ziņojumos bez papildu iestatīšanas:

Iezīmēšana ir ierobežota ar ziņojuma pamattekstu, tāpēc pārējais lietotnes chrome, piemēram, sānu josla, rakstīšanas logs un rīkjoslas, paliek neskarti. Thunderbird tiek aptverts viss rendered email.

Reveal URLs iezīmē Gmail ziņojumu: katras saites URL tiek parādīts savā rindā virs saites teksta, neatbilstoša tracker saite ir iezīmēta sarkanā krāsā, bet godīga saite tiek atklāta bez brīdinājuma.

Divi atklāšanas režīmi

Iestatījumu lapā zem Reveal the URL izvēlieties, kā tiks rādīts īstais URL:

Neatbilstību izcelšana

Kad host, kas nosaukts saites redzamajā tekstā, nesakrīt ar host, uz kuru saite patiesībā ved, Reveal URLs to atzīmē kā neatbilstību. Salīdzinājums tiek veikts pēc registrable domēna, tāpēc godīgs apakšdomēns, piemēram, mail.example.com adreses example.com gadījumā, netiek iezīmēts, bet look-alike host, piemēram, paypa1.com adreses paypal.com gadījumā, tiek.

To kontrolē divi saistīti iestatījumi:

Iestatījumu lapa: režīma 'Reveal the URL' izvēlne, slēdzis 'Highlight mismatching links' un mismatch un match krāsu lauki.

Rīkjoslas poga

Pārlūkā Chrome, Edge, Opera, Firefox un Thunderbird Reveal URLs rīkjoslas ikona ir ātrs ieslēgšanas/izslēgšanas slēdzis — noklikšķiniet uz tās, lai pārslēgtu anotēšanu. Kad paplašinājums ir izslēgts, uz ikonas parādās OFF nozīmīte, un tās rīka padoms pasaka, vai klikšķis to ieslēgs vai izslēgs. Pārlūkos izmaiņas stājas spēkā visās atvērtajās cilnēs vienlaikus; Thunderbird tās attiecas uz nākamo ziņojumu, ko atverat.

(Thunderbird poga rāda tikai savu ikonu, tāpēc vienotajā rīkjoslā tā paliek kompakta. Reveal URLs varat arī ieslēgt un izslēgt ar slēdzi Enable iestatījumu lapā.)

Iestatījumu lapa

Iestatījumu lapa satur visas opcijas. Atveriet to no sava pārlūka paplašinājumu lapas, piemēram, izmantojot Details → Extension options, vai arī tā atvērsies pati pirmajā instalācijā.

Papildus galvenajam Enable slēdzim un Active sites kontrolēm, kas stājas spēkā uzreiz, izmaiņas tiek saglabātas ar pogu Save settings.

Apakšējie iestatījumi: saraksts 'Ignore these hosts', maksimālais rādāmā URL garums un izvēles fonta izmēra un biezuma lauki atklātajam URL un brīdinājuma nozīmītei virs pogas 'Save settings'.

Aktīvās vietnes — sava webmail pievienošana

Iestatījumu lapas augšpusē esošā sadaļa Active sites uzskaita lapas, kur Reveal URLs darbojas, un container, kas satur katra ziņojuma pamattekstu.

Iestatījumu lapas augšdaļa: galvenais slēdzis 'Enable Reveal URLs' un saraksts 'Active sites', kur katrs iebūvētais pakalpojums rāda savu match pattern, slēdzi 'Enabled', slēdzi 'Sub-frames' un ziņojuma satura selector-u.

Katra rinda rāda:

Iebūvētos pakalpojumus, piemēram, Gmail, Outlook un Proton, var izslēgt vai pārvirzīt, bet nevar noņemt.

Lai pievienotu savu webmail vietni:

  1. Zem Add site ievadiet Match URL — match pattern, piemēram, https://mail.example.com/*.
  2. Ievadiet Message-body selector — CSS selector container-am, kas satur ziņojuma pamattekstu, piemēram, .message-body.
  3. Ja ziņojuma pamatteksts tiek rādīts apakšrāmī, atzīmējiet Also run inside sub-frames.
  4. Noklikšķiniet Add site. Jūsu pārlūks lūgs atļauju piekļūt šai vietnei. Piešķiriet to. Vietne tiek pievienota tikai pēc atļaujas apstiprināšanas.

Izmaiņas šeit stājas spēkā nekavējoties. Jūsu pievienotas vietnes noņemšana atsauc arī tās atļauju, tāpēc Reveal URLs vairs tai nepiekļūst.

Thunderbird (un citi pasta klienti). Thunderbird jau rāda katru lasīto ziņojumu neatkarīgi no pakalpojumu sniedzēja, tāpēc tam nav vajadzīgs host-u saraksts. Tādēļ Active sites sadaļa Thunderbird iestatījumu lapā netiek rādīta. Tur tiek rādīts tikai galvenais slēdzis, attēlošanas valoda, atklāšanas režīms, krāsas, fonti un ignorēšanas saraksts. Jebkura aktīvo vietņu konfigurācija, ko esat iestatījis pārlūkā, paliek neskarta. Iestatījumu saglabāšana Thunderbird to nekad neiztīra.

Outlook un Gmail papildinājumi

Papildus pārlūka paplašinājumam un Thunderbird papildinājumam Reveal URLs ir pieejams arī kā native papildinājums divām pasta lietotnēm, kurās pārlūka paplašinājums nevar darboties: Outlook add-in un Gmail add-on. Abi izmanto to pašu saišu noteikšanu kā paplašinājums, tāpēc atklāj tos pašus URL un atzīmē tos pašus look-alike host-us.

Vienīgā atšķirība ir tajā, kā tie rāda savus atradumus. Pārlūka paplašinājums iezīmē saites uz vietas, iekrāsojot URL virs vai blakus katrai saitei. Outlook un Gmail ietvari neļauj papildinājumam mainīt attēloto ziņojumu, tāpēc katrs papildinājums rāda sānu paneli (Outlook) vai karti (Gmail) ar atrastajām saitēm. Katras saites gadījumā tiek rādīts redzamais teksts, mērķa URL un registrable host, bet mismatch tiek atzīmēts, ja redzamais teksts nosauc citu registrable domēnu nekā tas, uz kuru saite patiesībā ved.

Abi papildinājumi tiks izplatīti caur saviem lietotņu veikaliem: Outlook add-in caur Microsoft AppSource, bet Gmail add-on caur Google Workspace Marketplace. Publicēšana vēl notiek. Tiešās instalēšanas saites tiks pievienotas šeit, tiklīdz katrs ieraksts būs aktīvs.

Valodas

Reveal URLs ir pieejams angļu valodā un daudzās citās valodās.

Neangļu teksts ir mašīntulkots un gaida cilvēka pārskatīšanu, tāpēc kāds formulējums dažreiz var skanēt neveikli. Mērķis ir saglabāt tādu pašu nozīmi kā angļu oriģinālā. Ja pamanāt kļūdainu tulkojumu, atveriet issue vietnē Codeberg issue tracker.

Privātums

Reveal URLs nesūta jūsu e-pasta vai ziņojuma datus mums vai trešajām pusēm nevienā no savām formām. Nav analytics un nav tracking. Tas, kur un kā darbs tiek veikts, ir atkarīgs no formas:

Vienīgais, kas tiek glabāts, ir jūsu pašu iestatījumi, piemēram, vai Reveal URLs ir ieslēgts vai izslēgts, atklāšanas režīms, krāsas, fontu izmēri, ignorēšanas saraksts un visas vietnes, ko esat pievienojis. Tie tiek glabāti jūsu pārlūka, Outlook vai Google per-user storage un nekad netiek nosūtīti mums.

Pilnu informāciju skatiet privātuma politikā.

Problēmu novēršana

Kāda saite netiek parādīta.

Iebūvētais pakalpojums pārstāja darboties pēc pārveides.

Webmail pakalpojumi laiku pa laikam maina savu lapu markup-u. Ja iebūvētā pakalpojuma selector pēc šādas izmaiņas vairs nesakrīt, varat to labot paši: sadaļā Active sites rediģējiet šī pakalpojuma message-body selector-u tā, lai tas rādītu uz jauno container.

Tooltip URL netiek rādīts.

Tooltip (title) režīmā īstais URL tiek ievietots saites tooltipā, tāpēc tas parādās tikai tad, kad turat kursoru virs tās. Ja vēlaties redzēt URL bez hover-a, pārslēdziet Reveal the URL uz inline režīmu.

Licence un pirmkods

Reveal URLs ir brīvā programmatūra ar GNU Affero General Public License v3.0 licenci (AGPL-3.0-only).