Skip to content

Vault and Crypto ru

Se.Cherkasov edited this page Aug 23, 2026 · 1 revision

Хранилище и криптография

English · Русский

Криптография не проходила независимый аудит. Она собрана из проверенных примитивов (libsodium, BouncyCastle, Nimbus SRP-6a), а не изобретена, но сама композиция сторонней стороной не проверялась. См. SECURITY.md.

Иерархия ключей

flowchart TD
  PW[мастер-пароль] -->|Argon2id m=64МиБ t=3 p=4, соль| MK[masterKey · 256 бит]
  MK -->|обёртка / развёртка| DK[dataKey · 256 бит, случайный]
  MK -->|ветка HKDF| AK[authKey → верификатор SRP-6a]
  DK -->|XChaCha20-Poly1305 + AAD| REC[записи хранилища]
  AK --> SRV[(сервер синхронизации:<br/>верификатор + обёрнутый dataKey + шифротексты)]
Loading
  • masterKey существует только в памяти, никогда не сериализуется и затирается (zeroize()), как только перестаёт быть нужен: это вывод Argon2id, и дамп кучи или своп его бы раскрыли.
  • dataKey случаен, шифрует каждую запись и хранится только обёрнутым под masterKey. Смена мастер-пароля переобёртывает его; записи не перешифровываются.
  • authKey детерминированно выводится из masterKey для аутентификации синхронизации. Сервер его не получает — только SRP-6a-верификатор.

KDF_MEMORY_MIB вынесена в константу, потому что панель Хранилища сообщает, как защищены секреты на экране, и число в UI не должно разойтись с используемым.

Формат записи

data class VaultRecord(
    val id: String, val type: RecordType, val version: Long,
    val updatedAt: Long, val deviceId: String, val deleted: Boolean,
    val blob: ByteArray,   // XChaCha20-Poly1305(dataKey, payload)
)

Метаданные лежат открыто; blob запечатан с AAD, связанным со всеми этими метаданными (recordAad), поэтому запись нельзя подставить в другой слот, а её открытые метаданные нельзя подменить, не провалив проверку тега. Блобы, запечатанные до 0.1.3, связывали только id‖type; они обновляются на месте при первой разблокировке и до этого не считаются доверенными при чтении и слиянии.

Та же структура — единица E2E-синхронизации: version — счётчик Лампорта для LWW, а удаление — надгробие, а не физическое стирание.

RecordType покрывает хосты, группы, секреты, известные хосты, доверенные CA, сниппеты, ранбуки и журналы прогонов, туннели, настройки, историю терминала, команды и их идентичности, снимки корзины. IDENTITY — легаси: не пишется, оставлен, чтобы старые надгробия разбирались.

Файл

VaultFileBody
├── meta: { formatVersion, salt, wrappedDataKey }   ← открыто
└── records: [ VaultRecord … ]                      ← блобы зашифрованы

FileVault (okio, десктоп и Android) кэширует записи в памяти и переписывает файл атомарно (временный файл + atomicMove). Мутаторы сначала пишут новый снимок на диск и только при успехе фиксируют его в полях, поэтому неудачная запись оставляет кэш, meta и dataKey нетронутыми. Нечитаемый файл при разблокировке даёт UnlockResult.Corrupted, а не частичное состояние.

Соглашение об ошибках в VaultCrypto: unwrapDataKey и open возвращают null только при провале AEAD-тега (неверный пароль или повреждённый шифротекст) — ожидаемый исход. Структурно некорректный ввод (неверная длина ключа, блоб без места под nonce и тег) — ошибка программиста, и он бросает исключение.

Транзакции

vault.transaction { … } выполняет read-modify-write под собственным реентерабельным замком хранилища. Всё составное — переупорядочивание хостов, слияние удалённой пачки — обязано идти через него, иначе изменение, посчитанное по устаревшему снимку, затрёт только что слитое обновление. Это реальный дефект, ради которого правило и существует (VaultHostStore против фонового слияния).

Слияние удалённых записей

Vault.mergeRemote возвращает MergeResult(applied, rejected). Rejected — победители LWW, чей блоб не прошёл аутентификацию против заявленных метаданных: подделанная или воспроизведённая запись со скомпрометированного сервера. Такие записи не сохраняются, локальная версия остаётся, и отказ показывается, а не проглатывается.

Файлы на диске

Файлы с секретами пишутся через vault/atomicWriteUtf8 — атомарно, 0600, и никогда обычным writeText (который однажды сломал TOFU known_hosts и оставил всемирно читаемые файлы хранилища). Экспорт ключа в выбранное пользователем место идёт через PrivateConfig.writePrivateFile: файл защищается, но каталог пользователя не переразмечается.

Сравнение секретов — vault/constantTimeEquals, промежуточные копии ключей обнуляются.

Биометрия

VaultBiometrics + BiometricKeyStore (на Android — AndroidBiometricKeyStore) держат привязанную к биометрии обёртку материала разблокировки. Прочность привязки честно сообщается UI: устройство, способное лишь на более слабую привязку, так и говорит. После подключения к синхронизации биометрию нужно настроить заново, потому что подключение меняет ключ хранилища.

Корзина и журнал безопасности

TrashStore хранит снимок удалённой записи как отдельный тип записи на 30-дневное окно — намеренно не «толстое надгробие», чтобы клиенты, не знающие типа, хранили его дословно и никогда не показывали. SecurityLog записывает события безопасности (смена пароля, регистрация биометрии, копирование секретов, смена ключей хостов) внутрь хранилища.

Границы модели угроз

Защищает: от кражи данных при хранении, от любопытного или скомпрометированного сервера синхронизации, от прослушивания учётных данных синхронизации. Не защищает: от скомпрометированного устройства, от слабого мастер-пароля (восстановления нет), от вредоносных удалённых хостов и от секретов, которые вы сами отправили облачному AI.

Clone this wiki locally