Holkas
Написать в поддержку Поддержка

Установка

Данные и пароли подключений

Что Holkas хранит у себя, как защищает параметры баз, Git и S3 и почему вместе с базой состояния нужно беречь ключи.

На этой странице

База хранит настройки. Ключи позволяют их прочитать.

Каталог данных Holkas
holkasweb.db

Параметры подключений — зашифрованы

Имена узлов, манифесты и история — вне этого шифрования

keys/

Ключи Data Protection

Доступ ограничен правами файлов. Сами ключи не зашифрованы.

Что даёт копия этих файлов?

Для расшифровки нужны исходные ключи

Зашифрованные параметры подключений не прочитать одним открытием SQLite. Остальное содержимое базы не получает эту защиту.

Настройки можно расшифровать

Полный комплект нужен для восстановления Holkas. Поэтому доступ к нему нужно ограничивать так же, как доступ к самим реквизитам подключений.

Упрощённая схема для уже зашифрованных записей. В каталоге есть и другие файлы. Старые копии и остатки открытых реквизитов после обновления требуют отдельного внимания.

При подключении по паролю Holkas использует учётную запись, указанную в настройках базы. Поэтому возникает закономерный вопрос: не остаётся ли её пароль открытым текстом в небольшой служебной базе самого Holkas?

Сохранённые параметры подключений шифруются. Но это защита конкретных записей, а не всего сервера и всех файлов установки. Важно понимать, что она даёт и где заканчивается.

Что именно зашифровано

Начиная с v0.1.12, Holkas защищает весь JSON с параметрами сохранённого подключения с помощью ASP.NET Core Data Protection. Это относится к базам данных, Git и S3: пароль, токен или секретный ключ внутри этих параметров не лежит открытой строкой в действующей записи SQLite.

Защита применяется при создании и изменении подключения. При использовании Holkas расшифровывает настройки в памяти и передаёт их нужному транспорту. Программа должна иметь доступ к исходным реквизитам, чтобы подключиться к внешней системе.

Это работает в Standalone, Local и Team. Отключение формы входа в Local не отключает шифрование сохранённых подключений. При этом Local даёт полные права любому, кто может обратиться к серверу, — границы этого режима по-прежнему важны.

Три разные вещи, которые легко перепутать

ЧтоКак используется и хранится
Пароль для входа человека в HolkasДля локальной учётной записи сохраняется хеш BCrypt. Это другой механизм, не шифрование параметров подключения. В Team можно входить через SSO.
Пароль или токен подключения к базе, Git, S3Нужен серверу Holkas для работы с источником или приёмником. Хранится внутри зашифрованных параметров; расшифровывается при использовании.
Ключи Data ProtectionПозволяют Holkas читать зашифрованные настройки. Хранятся отдельно от SQLite в каталоге keys, но обычно на том же диске или в том же томе.

В форме и API секретные поля сохранённого подключения маскируются. Это помогает не показать пароль при обычном просмотре карточки; маска на экране и шифрование на диске решают разные задачи. Доступ к самому подключению задаётся правами чтения, записи и управления.

Где заканчивается защита

Весь файл SQLite не зашифрован. Имена подключений, манифесты, сведения об операциях и другие записи не становятся секретными только потому, что параметры подключения защищены. Планы, журналы и пакеты могут содержать исходный код и данные вашей доработки — им тоже нужен ограниченный доступ.

Ключи не защищены отдельным паролем. Holkas ограничивает доступ к ним средствами ОС: на Linux каталог получает права 700, файлы — 600; на Windows доступ остаётся у учётной записи процесса, SYSTEM и администраторов. Это не защита от администратора сервера или от копирования всего тома вместе с ключами.

Шифрование на диске не заменяет защиту соединения. Для доступа к веб-интерфейсу через сеть используйте HTTPS через свой прокси. Права учётной записи в СУБД и сетевой доступ к базе настраиваются отдельно от прав пользователя в Holkas.

Что сделать при установке

  1. Выделите постоянный каталог данных. В Docker это обычно /data в подключённом томе, в Windows — %LOCALAPPDATA%\Holkas. Фактические пути видны в журнале запуска; их можно изменить параметрами запуска.
  2. Ограничьте доступ к каталогу и резервным копиям. Учитывайте и файл SQLite, и keys, и материалы операций. Полная копия содержит всё необходимое для расшифровки подключений.
  3. Сохраняйте базу и исходные ключи вместе для восстановления. Копию ключей можно дополнительно держать отдельно в защищённом месте. Не удаляйте старые ключи только из-за истечения их срока действия: ими могут быть защищены существующие записи.
  4. Проверьте восстановление на отдельной установке. Должны вернуться вход, подключения и история. Пошаговые команды есть в инструкции резервного копирования.

Если потеряны ключи или осталась старая копия

Без нужных ключей Holkas не сможет прочитать защищённые подключения и не запустится с такими записями. Новая пустая папка keys не заменяет исходную. Сначала восстановите ключи из защищённой копии — подробнее о восстановлении.

При обновлении с версии до v0.1.12 действующие записи шифруются автоматически. Однако открытые реквизиты могут остаться в прежних архивах, копии перед обновлением, свободных страницах SQLite и WAL. Что учитывать при очистке старых копий.