Legion ZK Auth 🛡️

Autenticação True Zero-Knowledge com Assinaturas de Anel de Dispositivo Vinculadas ao Hardware

🎯 O que é o Legion?

Legion é um sistema de autenticação zero-knowledge que prova que você está autorizado sem revelar quem você é. Você prova algo com base em dados públicos sem vincular sua ação atual de volta ao seu endereço público.

Principais Recursos

✅ True Zero-Knowledge: O servidor nunca descobre sua identidade (1 em 1M de usuários)
✅ Anonimato do Dispositivo: Vinculado ao hardware com assinaturas de anel (1 em 1K de dispositivos)
✅ Sem Trusted Setup: Halo2 PLONK (configuração transparente)
✅ Segurança de Hardware: Vinculação WebAuthn TPM/Secure Enclave
✅ Proteção contra Replay: Nullifiers + timestamps
✅ Segurança de Sessão: Tags de linkability previnem roubo
✅ Rate Limiting: 5 tentativas/hora (erros genéricos previnem enumeração)
✅ Revogação de Dispositivo: Bloqueie dispositivos roubados instantaneamente
✅ Funciona: Docker, systemd, monitoramento incluídos

🔒 Garantias de Segurança (v1.1.0)

Propriedade	Garantia
Anonimato do Usuário	1 em 2^20 (1.048.576)
Anonimato do Dispositivo	1 em 2^10 (1.024)
Erro de Soundness	2^-128
Sistema de Prova	Halo2 PLONK
Hash de Senha	Argon2id
Vinculação de Hardware	WebAuthn Level 2
Rate Limiting	5 tentativas/hora
Revogação de Dispositivo	Blacklist instantânea

🚀 Início Rápido (Um Comando!)

Pré-requisitos

Docker (inclui Docker Compose)

Instalar e Executar

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

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

# Windows
install.bat

Pronto! Abra http://localhost no seu navegador.

O que é instalado

✅ Redis (armazenamento de sessão)
✅ Legion Server (verificador de provas ZK)
✅ Frontend (cliente WASM)
✅ Nginx (proxy reverso)

Desempenho: Registro ~10s, Autenticação ~4min (geração de prova k=16)

Configuração Manual (Sem Docker)

Clique para expandir a instalação manual

# 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

Para implantação em produção, consulte DEPLOYMENT.md

📊 Desempenho

Nível de Segurança	k	Tempo de Prova	Tamanho da Prova	Caso de Uso
Teste	12	~10s	2.5 KB	Desenvolvimento
Padrão	14	~60s	3.0 KB	Staging
Produção	16	~4min	3.5 KB	Recomendado
Alta Segurança	18	~15min	4.0 KB	Empresarial

🏗️ Arquitetura

📖 Para obter o fluxo de autenticação detalhado passo a passo com detalhes criptográficos, consulte ARCHITECTURE_FLOW.md

legion

Mais Populares