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 — Kasutusjuhend

Reveal URLs on väike brauserilaiendus ja Thunderbirdi lisand, mis näitab, kuhu üks link teie e-kirjas tegelikult viib, et saaksite phishing-lingi ära tunda enne sellel klõpsamist.

See juhend selgitab, kuidas Reveal URLs paigaldada ja kuidas seda kasutada. Levinud küsimuste jaoks vaadake korduma kippuvaid küsimusi; teie andmete käsitlemise kohta vaadake privaatsuspoliitikat; tehnilise ülevaate saamiseks vaadake arhitektuuri ülevaadet.

Leidsid vea, valesti märgistatud lingi või webmaili host-i, mis peaks olema toetatud? Anna sellest teada Codeberg issue tracker.

Sisukord

Mida see teeb ja miks

Phishing-kiri peidab pahatahtliku sihtkoha usaldusväärsena näiva lingiteksti taha. Mõnikord on see host, mis meenutab tõelist: tekst näitab paypal.com, kuid link viib aadressile paypa1.com. Sageli on trikk peenem ja käib läbi tracker-i või redirector-i, nii et koht, kuhu lõpuks jõuate, ei sarnane peaaegu üldse tekstis nimetatud brändiga.

Andmepüügimeil, mis esineb postiteenuse nimel, väidab, et pakk on kinni peetud, kuni tasumata tollitasud on makstud, ja õhutab maksma nupu „Mine maksmisele“ kaudu. Reveal URLs näitab, et nupp ei vii selle postiteenuse lehele, vaid aadressile parcel-pay.custom.co.xa, mis on asjasse puutumatu sait, ning paljastab nii kirja pettusena.
Reveal URLs paljastab nupu „Mine maksmisele“: see viib aadressile parcel-pay.custom.co.xa, mitte jäljendatava postiteenuse lehele.

Märkus: See kuvatõmmis näitab petlikku andmepüügimeili, mis esineb postiteenuse nimel. Jäljendatav teenus ei ole Reveal URLs-iga seotud ega toeta seda.

Reveal URLs loeb läbi kõik vaadatavas kirjas olevad lingid ja näitab URL-i, kuhu iga link osutab. Brauserilaienduses ja Thunderbirdis märgib see eksitavad veebi-, e-posti-, telefoni- ja muud lingid ära, nii et erinevus on nähtav juba enne klõpsamist.

Reveal URLs paljastab ja märgistab; see ei kontrolli turvalisust. See ei järgi ümbersuunamisi: jälgija või ümbersuunaja kaudu minev link kuvatakse selle ümbersuunaja URL-ina, mida link tegelikult nimetab; Reveal URLs ei saa teada, kuhu see ümbersuunamine lõpuks viib. Hoiatuseta lingil ei ole tuvastatud ühtegi kohaldatavat mittevastavust, mitte kinnitatud turvaliseks, seega lugege paljastatud URL läbi, enne kui lingile usaldate, isegi kui midagi pole märgistatud. Selle meelespidamiseks kuvatakse märgistamata lingi paljastatud URL merevaigukollasena „kontrolli“, mitte rahustava rohelisena.

Gmaili kiri, kus Reveal URLs on aktiivne: petlik link on märgitud punasega ja selle jälgimis-URL kuvatakse lingiteksti kohal, samal ajal kui vastuoluta lingi URL kuvatakse ilma hoiatuseta.

Märkus: sellel ekraanipildil on e-posti aadressid, URL-id ja nimed privaatsuse huvides tärnidega varjatud.

Brauserilaienduses ja Thunderbirdi lisas toimub kõik teie enda seadmes ning midagi ei edastata. Üheski vormis ei saada Reveal URLs teie e-posti andmeid meile ega kolmandatele osapooltele: analytics puudub ja tracking puudub. Vormid erinevad ainult selle poolest, kus need töötavad ja kuidas Outlooki paneeli kood serveeritakse. Täpsemad üksikasjad leiate jaotisest Privaatsus ning privaatsuspoliitikast.

Toetatud brauserid ja meilirakendused

Reveal URLs töötab järgmistes keskkondades:

Veebibrauserid:

Meilirakendused:

Brauserites märgistab Reveal URLs teie webmaili sõnumites olevaid linke. Thunderbirdis märgistab see lingid otse loetavas e-kirjas.

Paigaldamine

Brauseri või meilikliendi poest (soovitatav)

Paigaldage Reveal URLs oma brauseri või meilikliendi poest. Chrome'i, Edge'i, Installige Reveal URLs oma brauseri või e-posti kliendi poest. Kõik kirjed on nüüd saadaval; Opera kasutab Chrome’i järku.

Veebibrauserid:

Meilirakendused:

Oma build-i laadimine (arendajad ja varajane testimine)

Kui olete Reveal URLs-i lähtekoodist ehitanud, saate pakkimata build-i otse laadida. Iga target ehitatakse käsuga make ja luuakse kausta dist/<target>/:

make build-chrome        # loob dist/chrome
make build-edge          # loob dist/edge
make build-firefox       # loob dist/firefox
make build-gmail         # loob dist/gmail
make build-opera         # loob dist/opera
make build-outlook       # loob dist/outlook
make build-safari        # loob dist/safari
make build-thunderbird   # loob dist/thunderbird

Seejärel laadige vastav kaust:

Safari laiendust, Outlooki lisandmoodulit ja Gmaili lisandmoodulit ei laadita lahtipakitud brauserilaiendustena. Ehitage need nagu ülal ja seejärel:

make deploy-gmail        # juurutab Gmaili lisandmooduli Apps Scripti
make safari-xcode        # ehitab Safari Xcode'i projekti, seejärel käivitage see
                         # Safari Develop-menüüst (macOS)
                         # Outlook: külglaadige dist/outlook

Seadete leht avaneb automaatselt laienduse esimesel paigaldamisel.

Kasutamine

Kohe pärast paigaldamist märgistab Reveal URLs sisseehitatud teenuste sõnumites olevaid linke ilma täiendava seadistamiseta:

Märgistamine on piiratud sõnumi sisuga, nii et rakenduse ülejäänud chrome, nagu külgriba, koostamisaken ja tööriistaribad, jäävad puutumata. Thunderbirdis on hõlmatud kogu rendered email.

Reveal URLs märgistab Gmaili sõnumit: iga lingi URL kuvatakse oma real lingiteksti kohal ning mittesobiv tracker-link on märgitud punasega, vastuoluta link aga kuvatakse ilma hoiatuseta.

Märkus: sellel ekraanipildil on e-posti aadressid, URL-id ja nimed privaatsuse huvides tärnidega varjatud.

Kuidas tegelik URL kuvatakse

Iga lingi tegelik URL kuvatakse oma real vahetult lingiteksti kohal. See paigutatakse ka lingi tooltip-i (title), nii et täielik URL on alati olemas, kui hoiate hiirekursorit lingi kohal.

Ebakõlade esiletõstmine

Veebilinkide puhul võrdleb Reveal URLs lingi nähtavas tekstis olevaid URL-e või hosti nimesid URL-iga, kuhu link osutab. Võrdlus toimub registrable domeeni põhjal, seega vastuoluta alamdomeen nagu mail.example.com aadressi example.com jaoks ei saa märget, kuid look-alike host nagu paypa1.com aadressi paypal.com jaoks saab. Brauserilaiendus ja Thunderbird kontrollivad ka e-posti-, telefoni- ja läbipaistmatuid linke; javascript:, data: ja vbscript: lingid märgitakse alati ära.

Kontroll võtab arvesse ainult URL-i, mille link ise nimetab; ümbersuunamisi ei järgita kunagi, seega võrreldakse jälgija või ümbersuunaja kaudu minevat linki selle URL-ina, mitte lehega, kuhu see lõpuks jõuab.

Ebakõla kuvatakse teie valitud ebakõlavärviga ja paksus kirjas.

Seda juhivad kaks seotud seadistust:

Seadete leht: 'Reveal the URL' režiimivalija, lüliti 'Tõsta mittevastavad lingid esile' ning väljad 'Vastuolu värv' ja 'Vastuoluta värv'.

Tööriistariba nupp

Chrome'is, Edge'is, Operas, Firefoxis ja Thunderbirdis on Reveal URLs tööriistaribaikoon kiire sisse/välja-lüliti — klõpsa sellel, et annotatsiooni ümber lülitada. Kui laiendus on välja lülitatud, ilmub ikoonile märk OFF ja selle kohtspikker ütleb, kas klõps lülitab selle sisse või välja. Brauserites jõustub muudatus kõigis avatud kaartides korraga; Thunderbirdis rakendub see järgmisele sõnumile, mille avad.

Kui Reveal URLs on sisse lülitatud, näitab brauseri tööriistariba ikoon teile ka kaardi kaupa, mida see praeguselt lehelt leidis. Kui lehel on mittevastavaid (sarnase välimusega) linke, näitab ikoon seda arvu punasel märgil; kui lehel on linke, kuid ükski neist ei ole mittevastav, näitab see analüüsitud linkide koguarvu hallil märgil; leht, kus pole analüüsitavaid linke (ja iga leht, millele laiendus ei mõju), ei näita ühtegi arvu. Iga kaart hoiab oma märki, seega kaartide vahetamine uuendab arvu ning lehelt lahkumine või kaardi sulgemine kustutab selle. (Üle 99 olevad arvud kuvatakse kujul 99+.)

Märk oma kolmes olekus (brauser joonistab selle, seega täpne paigutus varieerub veidi brauseriti): punane mittevastavuste arv, hall analüüsitud linkide arv ja märk OFF, kui laiendus on välja lülitatud; ka selle logo on siis summutatud helehall. Lehel, kus lubatud laiendus ei ole aktiivne, märki ei ole; puuduv OFF märk eristab sama summutatud logo väljalülitatud olekust.

Need illustratsioonid ei näita kõiki märgita juhtumeid; aktiivne leht ilma analüüsitavate linkideta säilitab tavavärvilise ikooni.

Tööriistariba ikoon, mis näitab punast märki praeguse lehe mittevastavate linkide arvuga Tööriistariba ikoon, mis näitab halli märki praeguse lehe analüüsitud linkide arvuga Tööriistariba ikoon tuhmi helehalli logoga ilma märgita, kui lubatud laiendus ei ole sellel lehel aktiivne Tööriistariba ikoon, mis näitab punast märki OFF, kui laiendus on välja lülitatud

(Thunderbirdis näitab nupp ainult oma ikooni, nii et see jääb ühendatud tööriistaribal kompaktseks. Samuti saab Reveal URLs sisse ja välja lülitada seadete lehel oleva lülitiga Luba Reveal URLs.)

Seadete leht

Seadete leht sisaldab kõiki valikuid. Avage see brauseri laienduste lehelt, näiteks käsu Details → Extension options kaudu, või see avaneb ise esimesel paigaldamisel.

Lisaks peamisele Luba Reveal URLs lülitile ja kontrollidele Aktiivsed saidid, mis rakenduvad kohe, salvestatakse muudatused nupuga Salvesta sätted.

Alumised seaded: loend 'Eira neid hoste', maksimaalne kuvatava URL-i pikkus ning valikulised fondi suuruse ja jämeduse väljad kuvatava URL-i, nupu 'Salvesta sätted' kohal.

Aktiivsed saidid — oma webmaili lisamine

Seadete lehe ülaosas asuv jaotis Aktiivsed saidid loetleb lehed, millel Reveal URLs töötab. Nüüd püsib see kindla kõrgusega: valige rippmenüüst üks sait ja muutke all olevas paneelis ainult selle saidi seadeid.

Seadete lehe ülaosa: peamine lüliti 'Luba Reveal URLs' ja jaotis 'Aktiivsed saidid', kus rippmenüü 'Aktiivne sait' asub ühe valitud saidi editory kohal ning näitab match pattern-it, lülitit 'Lubatud', lülitit 'Alamraamid' ja selle message-body selector-it.

Rippmenüü näitab üht kirjet iga saidireegli kohta:

Valitud saidi editor näitab:

Sisseehitatud teenuseid (FastMail, Gmail, Outlook Live, Outlook 365, Proton, Tuta, Yahoo, Zoho) saab välja lülitada või ümber suunata, kuid mitte eemaldada. Nende nimesid saab siin samuti ümber nimetada; sisseehitatud teenuse nime tühjendamine taastab selle vaikimisi sõbraliku nime.

Oma webmaili lisamiseks:

  1. Sisestage jaotises Lisa sait Sobivus-URL — match pattern nagu https://mail.example.com/*.
  2. Soovi korral sisestage rippmenüü jaoks Nimi. Jätke see tühjaks, et kasutada match URL-i.
  3. Sisestage Kirja sisu selektor — CSS selector container-i jaoks, mis hoiab sõnumi sisu, näiteks .message-body.
  4. Kui sõnumi sisu kuvatakse alamraamis, märkige Käivita ka alamraamides.
  5. Klõpsake Lisa sait. Teie brauser küsib selle saidi jaoks luba. Andke see. Sait lisatakse alles pärast loa kinnitamist.

Siinsed muudatused rakenduvad kohe. Teie lisatud saidi eemaldamine tühistab ka selle loa, nii et Reveal URLs ei pääse sellele enam ligi. Kui soovite saidi match URL-i muuta, eemaldage see ja lisage uuesti: match jääb ainult loetavaks, sest see on reegli identiteet.

Thunderbird (ja teised meilikliendid). Thunderbird näitab juba kõiki loetavaid sõnumeid olenemata teenusepakkujast, seega ei vaja ta host-i põhist loendit. Seepärast ei kuvata Aktiivsed saidid jaotist Thunderbirdi seadete lehel. Seal kuvatakse ainult peamine lüliti, avastamisrežiim, värvid, fondid ja ignoreerimisloend. Iga aktiivsete saitide seadistus, mille võisite brauseris teha, jääb puutumata. Thunderbirdis seadete salvestamine ei tühjenda seda kunagi.

Outlooki ja Gmaili lisad

Lisaks brauserilaiendusele ja Thunderbirdi lisale on Reveal URLs olemas ka native lisadena kahele meilirakendusele, kuhu brauserilaiendus ei ulatu: Outlook add-in ja Gmail add-on. Need jagavad brauserilaienduse http/https URL-i ja hosti tuvastust, kuid ei analüüsi selle täiendavaid lingiskeeme.

Ainus erinevus on selles, kuidas nad tulemusi näitavad. Brauserilaiendus märgistab lingid kohapeal, värvides URL-i iga lingi kohal või kõrval. Outlooki ja Gmaili raamistikud ei luba lisal renderdatud sõnumit muuta, nii et kumbki lisand näitab selle asemel külgpaneeli (Outlook) või kaarti (Gmail) leitud linkidega. Iga http/https lingi puhul kuvatakse nähtav tekst ja siht-URL ning mismatch märgitakse ainult siis, kui nähtav tekst nimetab URL-i või hosti, mille registrable domeen ei ühti lingi sihtkohaga.

Gmaili lisandmoodul on nüüd Google Workspace Marketplace’i kaudu saadaval.

Keeled

Reveal URLs on saadaval inglise keeles ja paljudes teistes keeltes.

Mitteingliskeelne tekst on masintõlgitud ja ootab inimülevaatust, seega mõni sõnastus võib aeg-ajalt kohmakas tunduda. Eesmärk on, et tähendus langeks kokku ingliskeelse originaaliga. Kui märkate valet tõlget, avage issue aadressil Codeberg issue tracker.

Privaatsus

Reveal URLs ei saada üheski oma vormis teie e-kirja ega sõnumi andmeid meile ega kolmandatele osapooltele. Analytics puudub ja tracking puudub. See, kus ja kuidas töö tehakse, sõltub vormist:

Ainus asi, mida salvestatakse, on teie enda seaded, nagu kas Reveal URLs on lubatud või keelatud, avastamisrežiim, värvid, fondisuurused, teie ignoreerimisloend ja kõik lisatud saidid. Need hoitakse teie brauseri, Outlooki või Google'i per-user storage'is ning neid ei saadeta kunagi meile.

Täielikud üksikasjad leiate privaatsuspoliitikast.

Tõrkeotsing

Mõni link ei ilmu nähtavale.

Sisseehitatud teenus lakkas pärast ümberkujundust töötamast.

Webmaili teenused muudavad aeg-ajalt oma lehtede markup-it. Kui sisseehitatud teenuse selector pärast sellist muudatust enam ei sobi, saate selle ise parandada: redigeerige Aktiivsed saidid jaotises selle teenuse message-body selector-it nii, et see osutaks uuele container-ile.

Litsents ja lähtekood

Reveal URLs on vaba tarkvara, mis on litsentseeritud GNU Affero General Public License v3.0 alusel (AGPL-3.0-only).

Safari märkused

Safari näitab märki ainult siis, kui lingid ei ühti; halli turvalise lehe loendurit ei ole. Ava seaded uuesti paremklõpsumenüüst Reveal URLs — settings, mitte ära laadi uuesti vana seadete vahekaarti.