Установка
Данные и пароли подключений
Что Holkas хранит у себя, как защищает параметры баз, Git и S3 и почему вместе с базой состояния нужно беречь ключи.
На этой странице
База хранит настройки. Ключи позволяют их прочитать.
holkasweb.dbПараметры подключений — зашифрованы
Имена узлов, манифесты и история — вне этого шифрования
keys/Ключи Data Protection
Доступ ограничен правами файлов. Сами ключи не зашифрованы.
При подключении по паролю 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.
Что сделать при установке
- Выделите постоянный каталог данных. В Docker это обычно
/dataв подключённом томе, в Windows —%LOCALAPPDATA%\Holkas. Фактические пути видны в журнале запуска; их можно изменить параметрами запуска. - Ограничьте доступ к каталогу и резервным копиям. Учитывайте и файл SQLite, и
keys, и материалы операций. Полная копия содержит всё необходимое для расшифровки подключений. - Сохраняйте базу и исходные ключи вместе для восстановления. Копию ключей можно дополнительно держать отдельно в защищённом месте. Не удаляйте старые ключи только из-за истечения их срока действия: ими могут быть защищены существующие записи.
- Проверьте восстановление на отдельной установке. Должны вернуться вход, подключения и история. Пошаговые команды есть в инструкции резервного копирования.
Если потеряны ключи или осталась старая копия
Без нужных ключей Holkas не сможет прочитать защищённые подключения и не запустится с такими записями. Новая пустая папка keys не заменяет исходную. Сначала восстановите ключи из защищённой копии — подробнее о восстановлении.
При обновлении с версии до v0.1.12 действующие записи шифруются автоматически. Однако открытые реквизиты могут остаться в прежних архивах, копии перед обновлением, свободных страницах SQLite и WAL. Что учитывать при очистке старых копий.