Legion ZK Auth 🛡️

Autenticazione True Zero-Knowledge con Firme ad Anello Legate all'Hardware del Dispositivo

🎯 Cos'è Legion?

Legion è un sistema di autenticazione zero-knowledge che dimostra che sei autorizzato senza rivelare chi sei. Dimostri qualcosa basandoti su dati pubblici senza collegare la tua azione corrente al tuo indirizzo pubblico.

Caratteristiche Principali

✅ Vero Zero-Knowledge: Il server non apprende mai la tua identità (1 su 1M di utenti)
✅ Anonimato del Dispositivo: Legato all'hardware con firme ad anello (1 su 1K di dispositivi)
✅ Nessun Trusted Setup: Halo2 PLONK (setup trasparente)
✅ Sicurezza Hardware: Binding WebAuthn TPM/Secure Enclave
✅ Protezione Replay: Nullifier + timestamp
✅ Sicurezza di Sessione: I tag di linkability prevengono il furto
✅ Rate Limiting: 5 tentativi/ora (errori generici prevengono l'enumerazione)
✅ Revoca del Dispositivo: Blocca istantaneamente i dispositivi rubati
✅ Funziona: Docker, systemd, monitoraggio inclusi

🔒 Garanzie di Sicurezza (v1.1.0)

Proprietà	Garanzia
Anonimato Utente	1 su 2^20 (1.048.576)
Anonimato Dispositivo	1 su 2^10 (1.024)
Errore di Soundness	2^-128
Sistema di Proof	Halo2 PLONK
Hashing Password	Argon2id
Binding Hardware	WebAuthn Level 2
Rate Limiting	5 tentativi/ora
Revoca Dispositivo	Blacklist istantanea

🚀 Avvio Rapido (Un Solo Comando!)

Prerequisiti

Docker (include Docker Compose)

Installa & Esegui

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

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

# Windows
install.bat

Fatto! Apri http://localhost nel tuo browser.

Cosa viene installato

✅ Redis (archiviazione delle sessioni)
✅ Legion Server (verificatore di prove ZK)
✅ Frontend (client WASM)
✅ Nginx (reverse proxy)

Prestazioni: Registrazione ~10s, Autenticazione ~4min (generazione della prova k=16)

Configurazione manuale (senza Docker)

Clicca per espandere l'installazione manuale

# 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

Per il deployment in produzione, consulta DEPLOYMENT.md

📊 Prestazioni

Livello di sicurezza	k	Tempo di prova	Dimensione della prova	Caso d'uso
Testing	12	~10s	2.5 KB	Sviluppo
Standard	14	~60s	3.0 KB	Staging
Produzione	16	~4min	3.5 KB	Consigliato
Alta sicurezza	18	~15min	4.0 KB	Enterprise

🏗️ Architettura

📖 Per il flusso di autenticazione dettagliato passo-passo con dettagli crittografici, consulta ARCHITECTURE_FLOW.md

legion

Più Popolari