Аутентификация и мастер-ключ

Аутентификация в Пассворке состоит из двух этапов: базовой аутентификации и проверки мастер-пароля (при включённом CSE).

Двухэтапная аутентификация

Этап	Назначение	Где выполняется
Базовая аутентификация	Проверка учётных данных	Сервер
Проверка мастер-пароля	Доступ к зашифрованным данным	Клиент + Сервер

---

Этап 1: Базовая аутентификация

Локальная аутентификация

1. Пользователь вводит логин и пароль
2. Сервер проверяет пароль (PBKDF2, 600 000 итераций, SHA-512)
3. При успехе выдаются Access Token и Refresh Token
4. Клиент сохраняет токены для последующих запросов

Параметры хеширования пароля на сервере:

Параметр	Значение
Алгоритм	PBKDF2
Хеш-функция	SHA-512
Итерации	600 000
Длина ключа	512 бит

SSO / LDAP аутентификация

При использовании SSO или LDAP:

1. Пользователь перенаправляется на внешний провайдер
2. После успешной аутентификации возвращается в Пассворк
3. Система создаёт сессию и выдаёт токены
4. Если включено CSE — запрашивается ввод мастер-пароля

---

Этап 2: Проверка мастер-пароля

При включённом клиентском шифровании после базовой аутентификации требуется ввод мастер-пароля.

Получение параметров

Клиент запрашивает у сервера параметры для вычисления мастер-ключа:

• Соль — уникальная для каждого пользователя
• Количество итераций — 300 000
• Тип алгоритма — PBKDF2

Вычисление мастер-ключа

На клиенте выполняется вывод ключа:

Параметр	Значение
Алгоритм	PBKDF2
Хеш-функция	SHA-256
Итерации	300 000
Длина ключа	512 бит
Вход	Мастер-пароль + Соль
Выход	Мастер-ключ (Base64)

Вычисление хеша для проверки

Для подтверждения корректности ввода вычисляется хеш мастер-ключа:

Параметр	Значение
Алгоритм	SHA-256
Вход	Мастер-ключ (512 бит)
Выход	Хеш (256 бит, hex-строка)

Проверка на сервере

Сервер сравнивает полученный хеш с сохранённым значением.

Почему простое сравнение хешей?

• Хеш вычислен на клиенте от криптографически стойкого 512-битного ключа
• Сервер не знает исходный мастер-ключ
• Дополнительное хеширование на сервере не добавляет безопасности в данной модели Zero Knowledge.

---

Полная последовательность аутентификации

Фаза 1 — Базовая аутентификация:

1. Пользователь вводит логин и пароль
2. Сервер проверяет учётные данные (PBKDF2, SHA-512, 600K итераций)
3. Сервер возвращает токены доступа и флаг CSE

Фаза 2 — Мастер-пароль (если CSE включено):

4. Клиент запрашивает параметры PBKDF2 (соль, итерации)
5. Пользователь вводит мастер-пароль
6. Клиент вычисляет мастер-ключ: PBKDF2(пароль, соль, 300K, SHA-256) → 512 бит
7. Клиент вычисляет хеш: SHA-256(мастер-ключ) → 256 бит
8. Клиент отправляет хеш на сервер
9. Сервер сравнивает хеши
10. При успехе сервер возвращает зашифрованный приватный RSA-ключ

Фаза 3 — Расшифровка ключей:

11. Клиент расшифровывает приватный RSA-ключ мастер-ключом (AES-256-CBC)
12. Клиент готов к работе с зашифрованными данными

Принцип Zero Knowledge

Мастер-пароль никогда не покидает клиент. Сервер видит только хеш мастер-ключа. Приватный RSA-ключ передаётся только в зашифрованном виде.

---

Параметры соли

Параметр	Значение
Длина	20 символов
Алфавит	A-Z, a-z, 0-9, @, ! (64 символа)
Энтропия	~120 бит
Генерация	На сервере при создании/изменении мастер-пароля
Хранение	В профиле пользователя на сервере

Свойства соли:

• Каждый пользователь имеет уникальную соль
• При смене мастер-пароля генерируется новая соль
• Соль не является секретом, но обеспечивает уникальность хеша

---

Сценарии аутентификации

Первый вход (установка мастер-пароля)

1. Пользователь проходит базовую аутентификацию
2. Система определяет, что мастер-пароль не установлен
3. Сервер генерирует новую соль
4. Пользователь вводит новый мастер-пароль
5. Клиент выполняет криптографические операции:
   • Вычисляет мастер-ключ (PBKDF2)
   • Генерирует пару RSA-ключей (2048 бит)
   • Шифрует приватный RSA-ключ мастер-ключом (AES-256-CBC)
   • Вычисляет хеш мастер-ключа (SHA-256)
6. Клиент отправляет на сервер:
   • Публичный RSA-ключ (открыто)
   • Зашифрованный приватный RSA-ключ
   • Хеш мастер-ключа

Повторный вход

1. Базовая аутентификация
2. Получение параметров PBKDF2 (соль, итерации)
3. Ввод мастер-пароля
4. Вычисление мастер-ключа и хеша
5. Проверка хеша на сервере
6. Расшифровка приватного RSA-ключа (AES-256-CBC)

Смена мастер-пароля

1. Пользователь вводит текущий мастер-пароль
2. Проверка корректности (сравнение хешей)
3. Ввод нового мастер-пароля
4. Генерация новой соли на сервере
5. Пересчёт мастер-ключа и хеша
6. Расшифровка приватного RSA-ключа старым мастер-ключом
7. Перешифровка приватного RSA-ключа новым мастер-ключом (AES-256-CBC)
8. Сохранение новых данных на сервере

Сброс мастер-пароля (администратором)

Потеря данных

При сбросе мастер-пароля администратором:

• Генерируется новая пара RSA-ключей
• Пользователь теряет доступ к ранее зашифрованным данным
• Требуется повторное предоставление доступа к сейфам

1. Администратор инициирует сброс
2. Удаляются криптографические данные пользователя
3. Пользователь устанавливает новый мастер-пароль
4. Генерируются новые RSA-ключи
5. Администраторы сейфов должны повторно предоставить доступ

---

Модель угроз и защита

Защита мастер-пароля

Угроза	Защита
Перехват при вводе	Мастер-пароль обрабатывается только в браузере
Перехват при передаче	На сервер отправляется только хеш мастер-ключа
Атака перебором	PBKDF2 с 300 000 итераций
Радужные таблицы	Уникальная соль для каждого пользователя
Компрометация сервера	Сервер не хранит мастер-пароль и мастер-ключ

Защита хеша мастер-ключа

Угроза	Защита
Утечка хеша	Хеш вычислен от 512-битного ключа (не от пароля)
Подбор по хешу	PBKDF2 делает каждую попытку вычислительно дорогой
Восстановление пароля	Требуется сначала подобрать ключ, затем пароль

Защита сессий

Параметр	Access Token	Refresh Token
Время жизни	~2.8 часа	36 часов
Назначение	Аутентификация запросов	Обновление Access Token
Хранение	Безопасное хранилище браузера	Безопасное хранилище браузера

---

Обработка ошибок

Неверный мастер-пароль

1. Вычисленный хеш не совпадает с сохранённым
2. Сервер возвращает ошибку
3. Клиент предлагает повторить ввод
4. Возможны ограничения на количество попыток (настраивается администратором)

Отсутствие параметров 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

Версия для LLM