Skip to content

spajk-cz/BOIT-Rizikov-E-shopy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BOIT Rizikové E-shopy screenshot

BOIT Rizikové E-shopy

Prohlížečové rozšíření, které vás varuje před podvodnými e-shopy ze seznamů České obchodní inspekce (ČOI) a Slovenskej obchodnej inšpekcie (SOI) — a detekuje další podezřelé signály přímo na stránce.

Chrome Web Store Firefox Add-on License: MIT Manifest V3 Made by BOIT

🇨🇿 + 🇸🇰 · #DělámeČeskoBezpečnější


Psali o nás

Tento český doplněk do prohlížeče upozorní na pochybné e-shopy dříve, než přijdete o peníze — Živě.cz


O co jde

Před každýma Vánocema varujeme na školeních lidi před rizikovými e-shopy. Roky jsme k tomu používali databázi ČOI + jeden starší prohlížečový doplněk — ten ale dávno není udržovaný. Tak jsme postavili nový. A od verze 1.7 podporujeme i slovenský trh přes seznam SOI.

BOIT Rizikové E-shopy v reálném čase porovnává navštívené weby s oficiálními seznamy rizikových e-shopů:

Když na takový web přijdete, obrazovka se zabluruje a uvidíte výrazné varování. Navíc rozšíření detekuje další podvodné signály — chybějící IČO, podezřelé TLD, jen bankovní převod, extrémní slevy a další.


Žádné trackery. Žádná analytika. Žádná data ven. Všechno běží lokálně ve vašem prohlížeči.


Co umí

Detekce a varování

  • Kontrola proti seznamům ČOI a SOI — porovnání domény při každé návštěvě
  • Výrazné varování — blur stránky + neon overlay v BOIT designu
  • 7 typů detekce podvodných signálů přímo na stránce:
    • Nešifrované spojení (HTTP)
    • Chybějící IČO provozovatele
    • Chybějící kontaktní e-mail / telefon
    • Chybějící obchodní podmínky / reklamační řád
    • Podezřelá TLD (.top, .xyz, .click, .shop, …)
    • Pouze bankovní převod jako forma platby
    • Extrémní slevy (70% a víc)

UI/UX

  • Dynamická ikonka v toolbaru — zelená = ok, růžová s vykřičníkem = pozor
  • Počítadlo ochrany — kolikrát vás rozšíření varovalo (anonymně, lokálně)
  • Rozbalovací detaily — přehledné varování, podrobnosti pod „Více detailů"
  • Cyberpunk vizuál — BOIT brand identity, JetBrains Mono, neon palette

Akce

  • Whitelist na 24 h — pokud víte, že je web v pořádku
  • Smart nahlášení podvodu.sk doména → SOI, ostatní → ČOI (jedním klikem, předvyplněný e-mail)
  • Automatická aktualizace seznamů — paralelně oba zdroje každých 6 hodin

Bezpečnost a soukromí

  • Žádné trackery, žádná analytika, žádné reklamy
  • Vše běží lokálně — jediné síťové operace jsou stažení seznamů z coi.gov.cz a soi.sk
  • Firefox AMO „no data collected" badge — manifest deklaruje data_collection_permissions: ["none"], takže Firefox uživateli při instalaci i v about:addons explicitně potvrzuje, že žádná data nesbíráme
  • Hardened proti bypass pokusům:
    • Closed Shadow DOM (mode: 'closed') — stránka se nedostane k vnitřkům overlaye
    • MutationObserver — pokud stránka odstraní overlay, znovu se vloží
    • Blur přes injected <style> s !important — nelze přepsat z element.style
    • isTrusted validace na všech tlačítkách — synthetic clicks z page scriptu jsou ignorovány

Instalace

Z Chrome Web Store

Get on Chrome Web Store

Pro Chrome, Edge, Brave, Vivaldi, Opera, Arc a další Chromium prohlížeče.

Z addons.mozilla.org 🦊

Firefox Add-on

Pro Firefox 140+ (desktop) a Firefox for Android 142+.

Lokální instalace (developer mode)

git clone https://github.com/spajk-cz/BOIT-Rizikov-E-shopy.git

Chrome / Chromium prohlížeče:

  1. Otevři chrome://extensions/
  2. Zapni Developer mode (vpravo nahoře)
  3. Klikni Load unpacked
  4. Vyber složku s rozbaleným repozitářem
  5. Hotovo

Firefox:

  1. Otevři about:debugging#/runtime/this-firefox
  2. Klikni Load Temporary Add-on…
  3. Vyber soubor manifest.json v rozbaleném repozitáři
  4. Doplněk poběží do restartu prohlížeče (pro permanentní instalaci je třeba signed build z AMO)

Pod kapotou

Stack

  • Manifest V3 (Chrome 110+, Firefox 140+ desktop, Firefox for Android 142+)
  • Vanilla JavaScript (žádné build nástroje, žádné dependencies)
  • Non-persistent background script (service worker v Chromium, event page ve Firefoxu)
  • Content Script s isolated world + closed Shadow DOM

Architektura

boit-rizikove-eshopy/
├── manifest.json         # MV3 manifest, CSP, permissions
├── background.js         # Background — fetch, cache, message routing
├── content.js            # Detekce + injection overlay (hardened)
├── popup.html/css/js     # Toolbar popup UI
├── icons/                # Ikonky safe/risky × 4 velikosti
├── PRIVACY.md            # Privacy policy
└── LICENSE               # MIT

Datový tok

┌─────────────┐                     ┌──────────────────┐
│ coi.gov.cz  │ ──┐                 │                  │
└─────────────┘   │  fetch každých  │ background.js    │
                  ├─ 6h,paralelně ─▶│ (event page /    │
┌─────────────┐   │   Promise.all   │  service worker) │
│  soi.sk     │ ──┘                 └────────┬─────────┘
└─────────────┘                              │ merge → storage.local
                                             ▼
┌─────────────┐  CHECK_DOMAIN       ┌──────────────────┐
│ content.js  │ ──────────────────▶ │ message handler  │
│ (každý web) │ ◀────────────────── │ → cached domains │
└──────┬──────┘   isRisky?          └──────────────────┘
       │
       ▼ injectWarning() — closed shadow DOM + MutationObserver
   ┌─────────────────┐
   │ varovný overlay │
   └─────────────────┘

Permissions

Permission Důvod
storage Cache seznamů ČOI/SOI, nastavení, statistiky — vše lokálně
alarms Periodická aktualizace seznamů (6h interval)
tabs Aktualizace ikonky a stavu pro aktivní tab
host_permissions: coi.gov.cz Stahování oficiálního seznamu ČOI
host_permissions: www.soi.sk Stahování oficiálního seznamu SOI
content_scripts na všech webech Kontrola domény proti seznamům

Privacy

Tato extension nesbírá, neukládá ani nepřenáší žádné osobní údaje. Všechna data zůstávají v prohlížeči.

Jediné síťové operace jsou stažení seznamů domén z coi.gov.cz a www.soi.sk (každých 6 hodin) — bez cookies, bez identifikátorů (credentials: 'omit').

Plné znění viz PRIVACY.md.


Contributing

PRs welcome! Pár pravidel:

  • Bezpečnost před features — žádný kód co by snížil hardening overlaye
  • Žádné runtime dependencies — vanilla JS, žádné npm balíčky v extension build
  • Test bypass scénářů — pokud měníš overlay, zkus si pustit bypass-test.js

Issues a feature requesty vítány. Zvlášť pokud najdete:

  • Bypass overlaye, kterou jsme nezachytili
  • False-positive na legitimním e-shopu
  • Chybu v parseru ČOI / SOI seznamu

Roadmap

  • v1.0 — MVP: detekce + overlay
  • v1.5 — Heatmap signálů, počítadlo, report tlačítko
  • v1.6 — Closed Shadow DOM hardening
  • v1.7 — 🇸🇰 SOI integrace + 🦊 Firefox / Firefox for Android port (Manifest V3)
  • v1.8 — Detekce typosquatu (Levenshtein vůči TOP 100 CZ/SK e-shopů)
  • v1.9 — Whois lookup pro nedávno zaregistrované domény
  • v2.0 — Crowdsourced report API (volitelný opt-in)

Changelog

v1.7.0 (současná)

  • 🇸🇰 Přidána podpora SOI (Slovenská obchodná inšpekcia) jako druhý zdroj dat
  • 🦊 Firefox port — doplněk dostupný i pro Firefox 140+ (desktop) a Firefox for Android 142+
  • 🔒 Firefox manifest deklaruje data_collection_permissions: ["none"] — explicitní "no data collected" badge v installeru
  • 🔧 Refactored parser: nová strategie pro <a> link strukturu (SOI), multi-domain split po čárkách
  • 🎯 Smart routing nahlášení podvodu: .sk → SOI, ostatní → ČOI
  • 🎨 Popup UI: dva oddělené odkazy pro ČOI (CZ) a SOI (SK)

v1.6.x

  • Closed Shadow DOM hardening + MutationObserver
  • Blur přes injected <style> s !important
  • isTrusted validace na tlačítkách

v1.5.x

  • Heatmap rizikových signálů (7 typů detekce)
  • Počítadlo "BOIT tě ochránil ×"
  • Report tlačítko s předvyplněným e-mailem

Tým

Vytvořeno v BOIT Cyber Security s.r.o. — etický hacking, penetrační testy, sociální inženýrství, školení.

Hlavní autor: Pavel „Spajk" Matějíček (LinkedIn · spajk.cz)

Posloucháte podcast „Místo kyberčinu" od O2? My ho děláme.


License

MIT — viz LICENSE.

To znamená: použij, fork, modifikuj, prodávej. Jen na nás laskavě nezapomeň.


Links


Sdílej dál — čím víc lidí ho má, tím méně peněz teče podvodníkům.

#DělámeČeskoBezpečnější

About

Varuje vás při návštěvě rizikových e-shopů ze seznamu České obchodní inspekce. Navíc detekuje další podvodné signály.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors