Аутентификация и мастер-ключ
Аутентификация в Пассворке состоит из двух этапов: базовой аутентификации и проверки мастер-пароля (при включённом CSE).
Двухэтапная аутентификация
| Этап | Назначение | Где выполняется |
|---|---|---|
| Базовая аутентификация | Проверка учётных данных | Сервер |
| Проверка мастер-пароля | Доступ к зашифрованным данным | Клиент + Сервер |
Этап 1: Базовая аутентификация
Локальная аутентификация
- Пользователь вводит логин и пароль
- Сервер проверяет пароль (PBKDF2, 600 000 итераций, SHA-512)
- При успехе выдаются Access Token и Refresh Token
- Клиент сохраняет токены для последующих запросов
Параметры хеширования пароля на сервере:
| Параметр | Значение |
|---|---|
| Алгоритм | PBKDF2 |
| Хеш-функция | SHA-512 |
| Итерации | 600 000 |
| Длина ключа | 512 бит |
SSO / LDAP аутентификация
При использовании SSO или LDAP:
- Пользователь перенаправляется на внешний провайдер
- После успешной аутентификации возвращается в Пассворк
- Система создаёт сессию и выдаёт токены
- Если включено CSE — запрашивается ввод мастер-пароля
Этап 2: Проверка мастер-пароля
При включённом клиентском шифровании после базовой аутентификации требуется ввод мастер-пароля.
Получение параметров
Клиент запрашивает у сервера параметры для вычисления мастер-ключа:
- Соль — уникальная для каждого пользователя
- Количество итераций — 300 000
- Тип алгоритма — PBKDF2
Вычисление мастер-ключа
На клиенте выполняется вывод ключа:
| Параметр | Значение |
|---|---|
| Алгоритм | PBKDF2 |
| Хеш-функция | SHA-256 |
| Итерации | 300 000 |
| Длина ключа | 512 бит |
| Вход | Мастер-пароль + Соль |
| Выход | Мастер-ключ (Base64) |
Вычисление хеша для проверки
Для подтверждения корректности ввода вычисляется хеш мастер-ключа:
| Параметр | Значение |
|---|---|
| Алгоритм | SHA-256 |
| Вход | Мастер-ключ (512 бит) |
| Выход | Хеш (256 бит, hex-строка) |
Проверка на сервере
Сервер сравнивает полученный хеш с сохранённым значением.
Почему простое сравнение хешей?
- Хеш вычислен на клиенте от криптографически стойкого 512-битного ключа
- Сервер не знает исходный мастер-ключ
- Дополнительное хеширование на сервере не добавляет безопасности в данной модели Zero Knowledge.
Полная последовательность аутентификации
Фаза 1 — Базовая аутентификация:
- Пользователь вводит логин и пароль
- Сервер проверяет учётные данные (PBKDF2, SHA-512, 600K итераций)
- Сервер возвращает токены доступа и флаг CSE
Фаза 2 — Мастер-пароль (если CSE включено):
- Клиент запрашивает параметры PBKDF2 (соль, итерации)
- Пользователь вводит мастер-пароль
- Клиент вычисляет мастер-ключ: PBKDF2(пароль, соль, 300K, SHA-256) → 512 бит
- Клиент вычисляет хеш: SHA-256(мастер-ключ) → 256 бит
- Клиент отправляет хеш на сервер
- Сервер сравнивает хеши
- При успехе сервер возвращает зашифрованный приватный RSA-ключ
Фаза 3 — Расшифровка ключей:
- Клиент расшифровывает приватный RSA-ключ мастер-ключом (AES-256-CBC)
- Клиент готов к работе с зашифрованными данными
Принцип Zero Knowledge
Мастер-пароль никогда не покидает клиент. Сервер видит только хеш мастер-ключа. Приватный RSA-ключ передаётся только в зашифрованном виде.
Параметры соли
| Параметр | Значение |
|---|---|
| Длина | 20 символов |
| Алфавит | A-Z, a-z, 0-9, @, ! (64 символа) |
| Энтропия | ~120 бит |
| Генерация | На сервере при создании/изменении мастер-пароля |
| Хранение | В профиле пользователя на сервере |
Свойства соли:
- Каждый пользователь имеет уникальную соль
- При смене мастер-пароля генерируется новая соль
- Соль не является секретом, но обеспечивает уникальность хеша
Сценарии аутентификации
Первый вход (установка мастер-пароля)
- Пользователь проходит базовую аутентификацию
- Система определяет, что мастер-пароль не установлен
- Сервер генерирует новую соль
- Пользователь вводит новый мастер-пароль
- Клиент выполняет криптографические операции:
- Вычисляет мастер-ключ (PBKDF2)
- Генерирует пару RSA-ключей (2048 бит)
- Шифрует приватный RSA-ключ мастер-ключом (AES-256-CBC)
- Вычисляет хеш мастер-ключа (SHA-256)
- Клиент отправляет на сервер:
- Публичный RSA-ключ (открыто)
- Зашифрованный приватный RSA-ключ
- Хеш мастер-ключа
Повторный вход
- Базовая аутентификация
- Получение параметров PBKDF2 (соль, итерации)
- Ввод мастер-пароля
- Вычисление мастер-ключа и хеша
- Проверка хеша на сервере
- Расшифровка приватного RSA-ключа (AES-256-CBC)
Смена мастер-пароля
- Пользователь вводит текущий мастер-пароль
- Проверка корректности (сравнение хешей)
- Ввод нового мастер-пароля
- Генерация новой соли на сервере
- Пересчёт мастер-ключа и хеша
- Расшифровка приватного RSA-ключа старым мастер-ключом
- Перешифровка приватного RSA-ключа новым мастер-ключом (AES-256-CBC)
- Сохранение новых данных на сервере
Сброс мастер-пароля (администратором)
Потеря данных
При сбросе мастер-пароля администратором:
- Генерируется новая пара RSA-ключей
- Пользователь теряет доступ к ранее зашифрованным данным
- Требуется повторное предоставление доступа к сейфам
- Администратор инициирует сброс
- Удаляются криптографические данные пользователя
- Пользователь устанавливает новый мастер-пароль
- Генерируются новые RSA-ключи
- Администраторы сейфов должны повторно предоставить доступ
Модель угроз и защита
Защита мастер-пароля
| Угроза | Защита |
|---|---|
| Перехват при вводе | Мастер-пароль обрабатывается только в браузере |
| Перехват при передаче | На сервер отправляется только хеш мастер-ключа |
| Атака перебором | PBKDF2 с 300 000 итераций |
| Радужные таблицы | Уникальная соль для каждого пользователя |
| Компрометация сервера | Сервер не хранит мастер-пароль и мастер-ключ |
Защита хеша мастер-ключа
| Угроза | Защита |
|---|---|
| Утечка хеша | Хеш вычислен от 512-битного ключа (не от пароля) |
| Подбор по хешу | PBKDF2 делает каждую попытку вычислительно дорогой |
| Восстановление пароля | Требуется сначала подобрать ключ, затем пароль |
Защита сессий
| Параметр | Access Token | Refresh Token |
|---|---|---|
| Время жизни | ~2.8 часа | 36 часов |
| Назначение | Аутентификация запросов | Обновление Access Token |
| Хранение | Безопасное хранилище браузера | Безопасное хранилище браузера |
Обработка ошибок
Неверный мастер-пароль
- Вычисленный хеш не совпадает с сохранённым
- Сервер возвращает ошибку
- Клиент предлагает повторить ввод
- Возможны ограничения на количество попыток (настраивается администратором)
Отсутствие параметров PBKDF2
Если параметры не найдены — мастер-пароль не установлен, требуется первоначальная настройка.
Невозможность расшифровать RSA-ключ
Если расшифровка приватного RSA-ключа не удалась — введён неверный мастер-пароль или данные повреждены.
Криптографическое резюме
| Операция | Алгоритм | Параметры |
|---|---|---|
| Хеширование пароля (сервер) | PBKDF2-SHA512 | 600 000 итераций |
| Вывод мастер-ключа (клиент) | PBKDF2-SHA256 | 300 000 итераций, 512 бит |
| Хеш для проверки | SHA-256 | 256 бит |
| Шифрование RSA-ключа | AES-256-CBC | Мастер-ключ |
| Генерация RSA-ключей | RSA-OAEP | 2048 бит, SHA-256 |