Legion ZK Auth 🛡️

Настоящая аутентификация с нулевым разглашением на основе аппаратно-привязанных кольцевых подписей устройств

🎯 Что такое Legion?

Legion — это система аутентификации с нулевым разглашением, которая доказывает, что вы авторизованы, не раскрывая, кто вы. Вы доказываете что-то на основе публичных данных, не связывая своё текущее действие со своим публичным адресом.

Ключевые возможности

✅ Настоящее нулевое разглашение: сервер никогда не узнаёт вашу личность (1 из 1 млн пользователей)
✅ Анонимность устройств: аппаратная привязка с кольцевыми подписями (1 из 1 тыс. устройств)
✅ Без доверенной настройки: Halo2 PLONK (прозрачная настройка)
✅ Аппаратная безопасность: привязка WebAuthn TPM/Secure Enclave
✅ Защита от повторного воспроизведения: нуллификаторы + временные метки
✅ Безопасность сессий: теги связываемости предотвращают кражу
✅ Ограничение частоты: 5 попыток в час (обобщённые ошибки предотвращают перебор)
✅ Отзыв устройств: мгновенная блокировка украденных устройств
✅ Работает: Docker, systemd, мониторинг включены

🔒 Гарантии безопасности (v1.1.0)

Свойство	Гарантия
Анонимность пользователя	1 из 2^20 (1 048 576)
Анонимность устройства	1 из 2^10 (1 024)
Вероятность ошибки полноты	2^-128
Система доказательств	Halo2 PLONK
Хеширование паролей	Argon2id
Аппаратная привязка	WebAuthn Level 2
Ограничение частоты	5 попыток в час
Отзыв устройств	Мгновенный чёрный список

🚀 Быстрый старт (одна команда!)

Предварительные требования

Docker (включает Docker Compose)

Установка и запуск

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

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

# Windows
install.bat

Вот и всё! Откройте http://localhost в вашем браузере.

Что устанавливается

✅ Redis (хранилище сессий)
✅ Legion Server (верификатор ZK-доказательств)
✅ Frontend (WASM-клиент)
✅ Nginx (обратный прокси)

Производительность: Регистрация ~10с, Аутентификация ~4мин (генерация доказательства k=16)

Ручная установка (без Docker)

Нажмите, чтобы развернуть инструкцию по ручной установке

# 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

Для развёртывания в production см. DEPLOYMENT.md

📊 Производительность

Уровень безопасности	k	Время доказательства	Размер доказательства	Вариант использования
Тестирование	12	~10с	2.5 KB	Разработка
Стандартный	14	~60с	3.0 KB	Staging
Production	16	~4мин	3.5 KB	Рекомендуется
Высокая безопасность	18	~15мин	4.0 KB	Enterprise

🏗️ Архитектура

📖 Подробное пошаговое описание процесса аутентификации с криптографическими деталями см. в ARCHITECTURE_FLOW.md

legion

Популярное