Repository navigation
Vault and Crypto ru
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 + шифротексты)]
-
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.
User guide
- Installation
- Getting started
- Hosts and connections
- Vault and credentials
- Terminal
- Files (SFTP)
- Port forwarding
- Remote desktops
- Snippets and runbooks
- Monitoring and guard
- AI assistant
- Sync and devices
- Teams and sharing
- Settings and shortcuts
- Android
- Troubleshooting
Development
- Architecture
- Building and running
- Connections and transports
- Terminal engine
- Vault and crypto
- Sync protocol
- Remote desktop stacks
- UI layer
- Testing and the gate
- Contributing and releases
Русский — оглавление