Legion ZK Auth 🛡️

Echte Zero-Knowledge-Authentifizierung mit hardwaregebundenen Geräte-Ringsignaturen

🎯 Was ist Legion?

Legion ist ein Zero-Knowledge-Authentifizierungssystem, das beweist, dass du autorisiert bist, ohne preiszugeben, wer du bist. Du beweist etwas auf Basis öffentlicher Daten, ohne deine aktuelle Aktion mit deiner öffentlichen Adresse zu verknüpfen.

Hauptmerkmale

✅ Echtes Zero-Knowledge: Der Server erfährt niemals deine Identität (1 von 1 Mio. Nutzern)
✅ Geräteanonymität: Hardwaregebunden mit Ringsignaturen (1 von 1K Geräten)
✅ Kein Trusted Setup: Halo2 PLONK (transparentes Setup)
✅ Hardwaresicherheit: WebAuthn TPM/Secure Enclave-Bindung
✅ Replay-Schutz: Nullifier + Zeitstempel
✅ Sitzungssicherheit: Linkability-Tags verhindern Diebstahl
✅ Ratenbegrenzung: 5 Versuche/Stunde (generische Fehler verhindern Enumeration)
✅ Gerätewiderruf: Gestohlene Geräte sofort blockieren
✅ Funktioniert: Docker, systemd, Monitoring inklusive

🔒 Sicherheitsgarantien (v1.1.0)

Eigenschaft	Garantie
Nutzeranonymität	1 von 2^20 (1.048.576)
Geräteanonymität	1 von 2^10 (1.024)
Soundness-Fehler	2^-128
Beweissystem	Halo2 PLONK
Passwort-Hashing	Argon2id
Hardware-Bindung	WebAuthn Level 2
Ratenbegrenzung	5 Versuche/Stunde
Gerätewiderruf	Sofortige Blacklist

🚀 Schnellstart (Ein Befehl!)

Voraussetzungen

Docker (enthält Docker Compose)

Installieren & Ausführen

# Clone and run
git clone https://github.com/deadends/legion.git
cd legion

# Linux/macOS
chmod +x install.sh && ./install.sh

# Windows
install.bat

Das war's! Öffne http://localhost in deinem Browser.

Was installiert wird

✅ Redis (Session-Speicherung)
✅ Legion Server (ZK-Beweis-Verifizierer)
✅ Frontend (WASM-Client)
✅ Nginx (Reverse-Proxy)

Leistung: Registrierung ~10s, Authentifizierung ~4min (k=16 Beweisgenerierung)

Manuelle Einrichtung (Ohne Docker)

Klicke, um die manuelle Installation zu erweitern

# 1. Install Redis
# macOS: brew install redis && redis-server
# Ubuntu: sudo apt install redis && redis-server
# Windows: https://redis.io/docs/install/install-redis/install-redis-on-windows/

# 2. Run server (terminal 1)
cd legion-server
cargo run --release --features redis

# 3. Build frontend (terminal 2)
cd wasm-client
wasm-pack build --target web --release
python3 -m http.server 8000

# 4. Open http://localhost:8000

Für den Produktionseinsatz siehe DEPLOYMENT.md

📊 Leistung

Sicherheitsstufe	k	Beweiszeit	Beweisgröße	Anwendungsfall
Testen	12	~10s	2.5 KB	Entwicklung
Standard	14	~60s	3.0 KB	Staging
Produktion	16	~4min	3.5 KB	Empfohlen
Hohe Sicherheit	18	~15min	4.0 KB	Unternehmen

🏗️ Architektur

📖 Für einen detaillierten schrittweisen Authentifizierungsablauf mit kryptografischen Details siehe ARCHITECTURE_FLOW.md

legion

Beliebteste