| 🛡️ Device Sentinel |  |
|---|
 |
|---|
Device Sentinel ist ein browserbasiertes Sicherheits-Dashboard zur Anzeige und Überwachung von Netzwerk- und USB-Geräten in Echtzeit – vollständig offline, lokal ausführbar und ohne Server.
🚀 Funktionen
| Kategorie | Details |
|---|---|
| 🔌 USB-Erkennung | Scan über WebUSB, Anzeige von Hersteller + Risikobewertung |
| 🌐 Netzwerkscan | ARP-basiert über separate Node.js-Anwendung (netScan.js) |
| 📂 Import | Geräteprotokoll (device_log.json) importierbar |
| 📤 Export | CSV- und PDF-Export des Logs |
| 🛡️ Whitelist | Import & Export von bekannten Geräten mit Statusanzeige |
| 🧠 Filter & Analyse | Nur neue Geräte anzeigen, Timeline-Darstellung |
| 📡 Live-Modus | Echtzeitanzeige aller Geräte aus dem Log (alle 5 Sekunden aktualisiert) |
📦 Projektstruktur
DeviceSentinel/
├── app.js
├── import.html
├── index.html
├── netScan.js
├── style.css
├── utils/
│ ├── bluetoothHandler.js
│ ├── deviceHandler.js
│ ├── exporter.js
│ ├── live.js
│ ├── networkScanner.js
│ ├── themeHandler.js
│ ├── timeline.js
│ ├── vendors.js
│ └── vendors.js
├── README.md
🖥️ Voraussetzungen
- ✅ Aktueller Chromium-basierter Browser (z. B. Chrome, Edge)
- ✅ Für WebUSB: Nutzung über localhost oder HTTPS empfohlen
- ✅ Für Netzwerkscan (optional):
- Node.js
- Datei: netScan.js ausführen via node netScan.js
⚙️ Verwendung
- 📥 Entpacken
📂 Öffne index.html im Browser
- 📡 Nutze die Buttons im linken Panel:
- „USB-Geräte scannen“
- „Netzwerkgeräte importieren“
- „Nur neue Geräte anzeigen“
📤 Exportiere Ergebnisse als .csv oder .pdf
🧩 Whitelist-Funktion
- Datei whitelist.json kann importiert/exportiert werden
- Geräte in der Whitelist erscheinen in grün
- Neue/unbekannte Geräte erscheinen in rot
Format-Beispiel:
[
{
"ip": "192.168.2.1",
"mac": "04-70-56-b9-ff-fc",
"label": "Router"
}
]
📡 Live-Überwachung
- Wird beim Laden automatisch gestartet
- Aktualisiert die Anzeige alle 5 Sekunden mit:
- IP, MAC, Typ, Zeitstempel, Risiko
Status: „Bekannt“ / „Neu“
📥 Optionaler Netzwerkscanner (Node.js)
- Öffne Terminal im Verzeichnis mit netScan.js
Ausführen:
node netScan.js
- Ergebnis: device_log.json erzeugt
- Importiere Datei über die Import-Schaltfläche in der UI
📃 Lizenz
- MIT License – LICENSE