Reveal URLs — Felhasználói kézikönyv
A Reveal URLs egy kis böngészőbővítmény (és Thunderbird-kiegészítő), amely megmutatja, hová valójában vezet egy link az e-mailjében, így még kattintás előtt felismerheti az adathalász linket.
Ez a kézikönyv elmagyarázza, hogyan telepítse és használja a Reveal URLs-t. Az adatok kezeléséről lásd az adatvédelmi szabályzatot; a bővítmény felépítésének technikai áttekintéséhez lásd az architektúra-áttekintést.
Talált egy hibát, egy tévesen megjelölt (vagy kihagyott) linket, vagy egy webmail-gazdagépet, amelyet támogatni kellene? Kérjük, jelentse a Codeberg hibakövetőben.
Tartalom
- Mit csinál és miért
- Támogatott böngészők és a levelezőprogram
- Telepítés
- Használata
- Az Outlook és Gmail bővítmények
- Nyelvek
- Adatvédelem
- Hibaelhárítás
- Licenc és forráskód
Mit csinál és miért
Egy adathalász e-mail ellenséges célhelyet rejt egy megbízhatónak tűnő
linkszöveg mögé. Néha ez egy megtévesztő gazdagép: a szöveg paypal.com néven
jelenik meg, miközben a link a paypa1.com címre mutat. Gyakran ravaszabb, egy
nyomkövetőn vagy átirányítón keresztül vezet, így ahová megérkezik, semmi köze a
szövegben megnevezett márkához.

parcel-pay.custom.co.xa címre mutat, nem a Magyar Postára.Megjegyzés: Ez a képernyőkép egy csaló adathalász e-mailt mutat, amely Magyar Postának adja ki magát. A Magyar Posta nem áll kapcsolatban a Reveal URLs-szel, és nem támogatja azt.
A Reveal URLs beolvassa az olvasott üzenet minden linkjét, és megmutatja, melyik URL-re mutat. Amikor a linkszövegben megnevezett gazdagép nem egyezik azzal a gazdagéppel, ahová a link valójában mutat, a Reveal URLs megjelöli, így az eltérés kattintás előtt egyértelmű.
A böngészőbővítményben és a Thunderbird-kiegészítőben minden a saját eszközén történik, és semmit sem továbbít. Minden formájában a Reveal URLs egyetlen e-mail-adatát sem küldi el nekünk vagy bármely harmadik félnek — nincs analitika és nincs nyomkövetés. (A formák abban különböznek, hogy hol futnak, és hogyan szolgálják ki az Outlook-ablak kódját; lásd az Adatvédelem szakaszt és az adatvédelmi szabályzatot a teljes részletekért.)
Támogatott böngészők és a levelezőprogram
A Reveal URLs a következőkön fut:
- Google Chrome
- Microsoft Edge
- Opera
- Mozilla Firefox
- Mozilla Thunderbird (az asztali levelezőprogram)
A Safari-változat még nem érhető el; egy későbbi szakaszra tervezzük.
A böngészős célpontokon a Reveal URLs a webmailben lévő linkeket jelöli. A Thunderbirdben az olvasott e-mail linkjeit jelöli közvetlenül a levelezőprogramban.
Telepítés
A böngészője vagy levelezőprogramja áruházából (ajánlott)
Telepítse a Reveal URLs-t a böngészője vagy levelezőprogramja áruházából. A Chrome-, Edge-, Firefox- és Thunderbird-listák élők; az Opera a Chrome-változatot futtatja, egy dedikált Opera-lista pedig még úton van:
- Chrome — a Chrome Web Store
- Edge — Microsoft Edge Add-ons
- Opera — telepítse a Chrome-változatot a Chrome Web Store-ból; egy dedikált Opera-lista hamarosan érkezik
- Firefox — Firefox Add-ons (AMO)
- Thunderbird — Thunderbird Add-ons (ATN)
Saját összeállítás betöltése (fejlesztőknek és korai teszteléshez)
Ha forrásból állította össze a Reveal URLs-t, közvetlenül betöltheti a
kicsomagolt összeállítást. Minden célpont egy make paranccsal készül, és a
dist/<target>/ alatt jön létre:
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
Majd töltse be a keletkező mappát:
- Chrome — nyissa meg a
chrome://extensionsoldalt, kapcsolja be a Fejlesztői módot, kattintson a Kicsomagolt betöltése gombra, és válassza adist/chromemappát. - Edge — nyissa meg az
edge://extensionsoldalt, kapcsolja be a Fejlesztői módot, kattintson a Kicsomagolt betöltése gombra, és válassza adist/edgemappát. - Opera — nyissa meg az
opera://extensionsoldalt, kapcsolja be a Fejlesztői módot, kattintson a Kicsomagolt betöltése gombra, és válassza adist/operamappát. - Firefox — nyissa meg az
about:debuggingoldalt, válassza a This Firefox lehetőséget, kattintson az Ideiglenes kiegészítő betöltése gombra, és válasszon egy tetszőleges fájlt adist/firefoxmappán belül (például amanifest.jsonfájlt). Az ideiglenes kiegészítő eltűnik, amikor a Firefox újraindul. - Thunderbird — telepítse az ideiglenes kiegészítőt a
dist/thunderbirdmappából ugyanígy (a Tools → Developer Tools → Debug Add-ons → Load Temporary Add-on menüponton keresztül).
A beállításoldal automatikusan megnyílik a bővítmény első telepítésekor.
Használata
Alapállapotban a Reveal URLs a beépített szolgáltatók üzeneteiben lévő linkeket jelöli — beállítás nélkül:
- Gmail (
mail.google.com) - Outlook Live (
outlook.live.com) - Outlook a weben / Microsoft 365 (
outlook.office.com) - Proton Mail (
mail.proton.me)
A jelölés az üzenettörzsre korlátozódik, így az alkalmazás saját felülete — az oldalsávja, a szerkesztőablaka és az eszköztárai — érintetlen marad. A Thunderbirdben a teljes megjelenített e-mail le van fedve.
A két felfedési mód
Ön választhatja meg, hogyan jelenjen meg a valódi URL, a beállításoldal Az URL felfedése része alatt:
- Beágyazva — a valódi URL saját sorában jelenik meg, közvetlenül a linkszöveg fölött. Ez az alapértelmezés.
- A link elemleírásában (title) — a valódi URL a link elemleírásába kerül, így akkor jelenik meg, amikor a link fölé viszi az egeret.
Eltérés kiemelése
Amikor egy link látható szövegében megnevezett gazdagép nem egyezik azzal a
gazdagéppel, ahová a link valójában mutat, a Reveal URLs eltérésként jelöli meg.
Az összehasonlítás a regisztrálható domainen történik, így egy tisztességes
aldomain, például a mail.example.com az example.com esetében nincs
megjelölve, míg egy megtévesztő, például a paypa1.com a paypal.com esetében
igen.
- Beágyazott módban az eltérés az Ön által választott eltérésszínben és félkövéren jelenik meg.
- Elemleírás (title) módban egy jellegzetes ⚠ URL-eltérés jelvény kerül a link mellé.
Két kapcsolódó beállítás vezérli ezt:
- Nem egyező linkek kiemelése be- vagy kikapcsolja az eltérés kiemelését.
- Csak a nem egyező linkek jelölése teljesen érintetlenül hagyja a tisztességes linkeket, így csak a gyanúsak jelennek meg felfedve.
Az eszköztárgomb
Chrome-ban, Edge-ben, Operában, Firefoxban és Thunderbirdben a Reveal URLs eszköztárikonja egy gyors be/ki kapcsoló — kattintson rá a megjegyzések ki- és bekapcsolásához. Amikor a bővítmény ki van kapcsolva, egy OFF jelvény jelenik meg az ikonon, és a buboréksúgója megmondja, hogy a kattintás be- vagy kikapcsolja-e. A böngészőkben a változás egyszerre lép életbe minden megnyitott lapon; Thunderbirdben a következő megnyitott üzenetre vonatkozik.
(Thunderbirdben a gomb csak az ikonját mutatja, így kompakt marad az egyesített eszköztáron. A Reveal URLs be- és kikapcsolására a beállítások oldalon található Engedélyezés kapcsolót is használhatja.)
A beállításoldal
A beállításoldal minden lehetőséget tartalmaz. Nyissa meg a böngészője bővítménylapjáról (például Részletek → Bővítmény beállításai), vagy első telepítéskor automatikusan megnyílik.
- A Reveal URLs engedélyezése — a fő be-/kikapcsoló, az oldal legtetején. Azonnal érvénybe lép, anélkül, hogy az űrlap többi részét menteni kellene.
- Megjelenítési nyelv — válassza ki, milyen nyelven jelenjen meg a beállításoldal. Alapértelmezés szerint követi a böngészője nyelvét, angolra visszaesve; válasszon másikat a listából a felülbírálásához. A választása azonnal érvénybe lép, a következő alkalomra megjegyzésre kerül, és csak ezen az eszközön tárolódik (soha nem változtatja meg a többi beállítását).
- Az URL felfedése — válasszon beágyazott vagy elemleírás (title) módot (lásd fent).
- Nem egyező linkek kiemelése — be- vagy kikapcsolja az eltérés kiemelését.
- Eltérés színe — egy megjelölt linkhez használt CSS-szín (például
red,#cc0000vagyrgb(200, 0, 0)). Az alapértelmezés a piros. - Egyezés színe — a felfedett URL színe a tisztességes (nem eltérő) linkeken
(például
blackvagy#1a1a1a). Az alapértelmezés egy semleges, nagyon sötétszürke (#1a1a1a), amelyet úgy választottunk, hogy a szín ne sugallja, hogy a linket ellenőrizték. - Csak a nem egyező linkek jelölése — érintetlenül hagyja a tisztességes linkeket.
- Ezeknek a gazdagépeknek a mellőzése — a teljesen kihagyandó gazdagépnevek listája, soronként egy. A felsorolt gazdagép aldomainjeit is kihagyja.
- Megjelenített URL maximális hossza — a hosszú URL-eket ennél a karakterszámnál levágja, a gazdagépet láthatóan tartva. Megengedett tartomány: 20 és 2000 között.
- A felfedett URL betűmérete / -vastagsága és A figyelmeztető jelvény betűmérete / -vastagsága — nem kötelező tipográfiai felülbírálások; hagyja üresen az alapértelmezések megtartásához.
A fő Engedélyezés kapcsolótól és az Aktív webhelyek vezérlőktől eltekintve (amelyek azonnal érvénybe lépnek), a módosítások a Beállítások mentése gombbal menthetők.
Aktív webhelyek — a saját webmail hozzáadása
Az Aktív webhelyek szakasz, a beállításoldal tetején, felsorolja azokat az oldalakat, amelyeken a Reveal URLs fut, és azt a tárolót, amely az egyes üzenettörzseket tartalmazza.
Minden sor a következőket mutatja:
- a webhely egyeztetési mintáját (például
https://mail.example.com/*); - egy Engedélyezve kapcsolót;
- az üzenettörzs-választót (a CSS-választót ahhoz a tárolóhoz, amelyet a Reveal URLs jelöl), amelyet szerkeszthet;
- egy Alkeretek kapcsolót az olyan webhelyekhez, amelyek üzenettörzse egy iframe-en belül jelenik meg;
- egy Eltávolítás gombot (csak a saját webhelyeihez).
A beépített szolgáltatók (Gmail, Outlook és Proton) ki- és bekapcsolhatók és átirányíthatók, de nem távolíthatók el.
A saját webmail-webhelyének hozzáadásához:
- A Webhely hozzáadása alatt adjon meg egy Egyeztetési URL-t — egy
egyeztetési mintát, például
https://mail.example.com/*. - Adjon meg egy Üzenettörzs-választót — egy CSS-választót ahhoz a tárolóhoz,
amely az üzenettörzset tartalmazza, például
.message-body. - Ha az üzenettörzs egy alkereten belül jelenik meg, jelölje be az Alkeretekben is fusson lehetőséget.
- Kattintson a Webhely hozzáadása gombra. A böngészője engedélyt fog kérni az adott webhely eléréséhez; adja meg. A webhely csak akkor kerül hozzáadásra, miután megadta az engedélyt.
Az itteni módosítások azonnal érvénybe lépnek. Egy Ön által hozzáadott webhely eltávolítása visszavonja annak engedélyét is, így a Reveal URLs többé nem éri el.
Thunderbird (és más levelezőprogramok). A Thunderbird már minden olvasott üzenetet megjelenít, bármely szolgáltatótól, így nincs szüksége gazdagépenkénti listára. Az Aktív webhelyek szakasz ezért nem jelenik meg a Thunderbird beállításoldalán — csak a fő kapcsoló, a megjelenítési nyelv, a felfedési mód, a színek, a betűtípusok és a mellőzési lista jelenik meg. Bármely aktív-webhely konfiguráció, amelyet esetleg beállított egy böngészőben, érintetlenül megmarad: a Thunderbird beállításainak mentése soha nem törli.
Az Outlook és Gmail bővítmények
A böngészőbővítmény és a Thunderbird-kiegészítő mellett a Reveal URLs natív bővítményként is elérhető két olyan levelezőalkalmazáshoz, amelyet egy böngészőbővítmény nem érhet el: egy Outlook-bővítmény és egy Gmail-bővítmény formájában. Mindkettő ugyanazt a linkfelismerést használja, mint a bővítmény, így ugyanazokat az URL-eket fedi fel, és ugyanazokat a megtévesztő gazdagépeket jelöli meg.
Az egyetlen különbség az, hogyan mutatják meg a megállapításaikat. A böngészőbővítmény a helyükön jelöli a linkeket — az URL-t az egyes linkek fölé vagy mellé színezve. Az Outlook és Gmail keretrendszerei nem engedik, hogy egy bővítmény módosítsa a megjelenített üzenetet, ezért ehelyett minden bővítmény egy oldalpanelt (Outlook) vagy kártyát (Gmail) mutat, amely felsorolja a talált linkeket. Minden linkhez megmutatja a látható szöveget, a cél-URL-t és a regisztrálható gazdagépet, és eltérést jelöl meg, amikor a látható szöveg más regisztrálható domaint nevez meg, mint amelyre a link valójában mutat.
- Outlook-bővítmény — egy munkaablak, amely beolvassa a megnyitott üzenetet, és a saját eszközén elemzi; semmilyen e-mail- vagy üzenetadat nem kerül sehová. A munkaablak kódját (HTML, JavaScript, CSS és ikonok) a https://www.reveal-urls.eu tölti be HTTPS-en keresztül, ahogyan bármely weboldal megnyitásakor történik. Eléri az Outlookot a weben, Windowson, Macen, iOS-en és Androidon, valamint az Outlook.com-ot.
- Gmail-bővítmény — egy kártya a Gmail oldalsávjában. Nyisson meg egy üzenetet, majd kattintson a Reveal URLs ikonra a jobb oldali oldalsávban a linkjeinek megtekintéséhez: a Gmail nem nyitja meg a kártyát magától, de ha nyitva hagyja a panelt, frissül, ahogy az üzenetek között lépeget. Minden link URL-je semleges sötétszürkével jelenik meg egy tisztességes link esetében, és pirossal egy megtévesztő esetében. Eléri a Gmailt a weben, Androidon és iOS-en. A többi formától eltérően a Gmail-bővítmény a Google szerverein fut (így működnek a Gmail-bővítmények): a megnyitott üzenetet ott olvassák és ellenőrzik minden megnyitáskor, és nem őrzik meg. Lásd az adatvédelmi szabályzatot arról, hogy melyik forma mit ér el és tárol.
Mindkét bővítmény a saját alkalmazásáruházán keresztül lesz terjesztve — az Outlook-bővítmény a Microsoft AppSource-on, a Gmail-bővítmény a Google Workspace Marketplace-en keresztül. A közzététel folyamatban van; a közvetlen telepítési hivatkozások itt kerülnek majd hozzáadásra, amint az egyes listák élővé válnak.
Nyelvek
A Reveal URLs angolul és sok más nyelven is elérhető.
- A beállításoldal automatikusan követi a böngészője nyelvét, angolra visszaesve, ha az Ön nyelve nincs a fentiek között. Bármikor felülbírálhatja az oldal teteje közelében lévő Megjelenítési nyelv kapcsolóval; a választása megjegyzésre kerül azon az eszközön (lásd A beállításoldal).
- Ez a webhely (a kezdőlap és ezek a dokumentációoldalak) szintén észleli a böngészője nyelvét, és nyelvváltót kínál a fejlécben. A kézikönyv és az adatvédelmi oldalak lefordítva érhetők el; ahol egy oldalnak még nincs fordítása, ott angolul jelenik meg.
A nem angol szöveg gépi fordítású, és emberi ellenőrzésre vár, így egy kifejezés olykor esetlenül hangozhat; a jelentés szándéka szerint megegyezik az angol eredetivel. Ha félrefordítást talál, kérjük, nyisson egy bejegyzést a Codeberg hibakövetőben.
Adatvédelem
A Reveal URLs egyetlen e-mail- vagy üzenetadatát sem küldi el nekünk vagy bármely harmadik félnek, egyik formájában sem — nincs analitika és nincs nyomkövetés. Hogy hol és hogyan történik a munka, az a formától függ:
- A böngészőbővítmény és a Thunderbird-kiegészítő teljes egészében a saját eszközén dolgozik, és semmit sem továbbít: az oldal megjelenítésekor beolvassa a linkszöveget, az URL-eket és az oldal színeit, soha nem tárolja vagy küldi el őket.
- Az Outlook-bővítmény a saját eszközén elemzi a megnyitott üzenetet, és semmilyen e-mail- vagy üzenetadatot nem küld sehová; a munkaablak kódját (HTML, JavaScript, CSS és ikonok) a https://www.reveal-urls.eu tölti be HTTPS-en keresztül, ahogyan bármely weboldal megnyitásakor történik.
- A Gmail-bővítmény a Google saját szerverein fut (így működnek a Gmail-bővítmények): a megnyitott üzenetet ott olvassák és ellenőrzik minden megnyitáskor, és nem őrzik meg.
Az egyetlen tárolt dolog a saját beállításai (például engedélyezve/letiltva, felfedési mód, színek, betűméretek, a mellőzési listája és bármely hozzáadott webhely), amelyeket a böngészője, az Outlook vagy a Google felhasználónkénti tárolójában őriznek, és soha nem küldenek el nekünk.
Lásd az adatvédelmi szabályzatot a teljes részletekért.
Hibaelhárítás
Egy link nem kerül felfedésre.
- Ellenőrizze, hogy a Reveal URLs be van-e kapcsolva — az eszköztárikonon nem szabad megjelennie az OFF jelvénynek, és a beállításoldal A Reveal URLs engedélyezése kapcsolójának bekapcsolva kell lennie.
- Ellenőrizze, hogy a webhely le van-e fedve. A beépített szolgáltatók (Gmail, Outlook, Proton) alapból működnek; bármely más webmailt hozzá kell adni az Aktív webhelyek alatt az egyeztetési URL-jével és üzenettörzs-választójával.
- Ellenőrizze az üzenettörzs-választót. Ha nem egyezik azzal a tárolóval, amely az üzenettörzset tartalmazza, az abban a tárolóban lévő linkek nem kerülnek felfedésre.
- Vegye figyelembe, hogy az oldalon belüli horgonyokra mutató linkek, valamint a
http/httpshelyett más sémát használó linkek (példáulmailto:) szándékosan ki vannak hagyva — csakúgy, mint az Ezeknek a gazdagépeknek a mellőzése listáján szereplő gazdagépek.
Egy beépített szolgáltató egy áttervezés után leállt.
A webmail-szolgáltatók időről időre megváltoztatják az oldaluk felépítését. Ha egy beépített szolgáltató választója egy ilyen változás után már nem egyezik, Ön magának is kijavíthatja: az Aktív webhelyek alatt szerkessze az adott szolgáltató üzenettörzs-választóját az új tárolóra.
Az elemleírás URL-je nem jelenik meg.
Elemleírás (title) módban a valódi URL a link elemleírásába kerül, így csak akkor jelenik meg, amikor a link fölé viszi az egeret. Ha inkább egérmutatás nélkül szeretné látni az URL-t, váltsa Az URL felfedése beállítást beágyazott módra.
Licenc és forráskód
A Reveal URLs szabad szoftver, amelyet a GNU Affero General Public License v3.0 (AGPL-3.0-only) alatt licenceltek.
- Forráskód: https://codeberg.org/Magentron/reveal-urls
- Technikai áttekintés: Architektúra
- További olvasnivaló a linkes adathalászatról: Email link phishing: your app should always show the URL




