Docs / Безопасность

Безопасность

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

Модель прав

Единый переключатель PRIVILEGES — security boundary, поэтому задаётся только через env и не меняется из интерфейса.

Значение	Что разрешает	По умолчанию
`read-only`	Только чтение: граф, история, логи, inspect	да
`actions`	Start, stop, restart, pause, kill, remove	нет
`exec`	Терминал и exec внутрь контейнера	нет
`push`	Доставка секретов; требует `exec`	нет
`compose`	`up`/`down`/`restart`/`pull` проектов	нет
`all`	Все перечисленные возможности	нет

Проверка выполняется дважды: в приложении (скрытые кнопки и 403) и в docker-api (независимая политика и запись deny в аудит).

Агент вместо сокета

Веб-контейнер не монтирует docker.sock; сокет есть только у docker-api и compose-runner.
Приложение общается с агентом по типизированному /v1, а не сырым Docker API.
Raw-пути ограничены allow-list и доступны только сканерам томов и уязвимостей.
Агент маскирует Config.Env, не-compose labels и креденшелы в истории слоёв.

Аутентификация

Механизм	Детали
Пароль контура	`AUTH_TOKEN`; слабые и короткие значения останавливают запуск
JWT	Access 15 минут, refresh 7 дней, HS256; refresh ротируется при каждом обновлении
Rate limit	Не более 5 попыток входа в минуту с одного IP
OIDC (портал)	Authorization Code + PKCE (S256), nonce, проверка подписи по JWKS, allowlist по email/домену
Обмен SSO	Провайдерские токены меняются на пару JWT через одноразовый HttpOnly-cookie
WebSocket	Проверка `Origin` (same-origin + `ALLOWED_ORIGINS`)

Fail-closed. Без AUTH_TOKEN приложение не стартует. AUTH_DISABLED=true — только явный opt-out для доверенной локальной машины.

Шифрование

Каждый секрет шифруется AES-256-GCM собственным data key.
При заданном SECRET_MASTER_KEY data key оборачивается мастер-ключом и хранится с префиксом v2: (envelope).
AI-ключ и секрет вебхука хранятся отдельно и никогда не возвращаются в браузер — только флаг «задан».
Токены контуров в БД портала шифруются PORTAL_SECRET_MASTER_KEY и не попадают в UI.
Ротация мастер-ключа пере-оборачивает все data key и AI-ключ в одной транзакции.

Аудит и redaction

docker-api пишет в кольцевой буфер отказы (DENY) и все мутирующие вызовы. Приложение добавляет собственные события: действия с контейнерами, CRUD секретов, push, изменение настроек. Страница /#/security показывает решение, причину и IP клиента, /#/events — общую ленту.

Redaction логов включён по умолчанию: пароли, токены, JWT, URL-креденшелы и приватные ключи вырезаются из live-логов, истории и захваченных срезов.

Харденинг

Read-only rootfs у приложения и sidecar'ов, cap_drop, no-new-privileges.
Базовые и compose-образы закреплены по digest; scripts/check-pins.sh проверяет репозиторий.
Registry: pull анонимный, push — только по логину; каталог репозиториев (/v2/_catalog) без креденшелов закрыт.
Сетевые сегменты backend, control, telemetry — внутренние.
Статические сайты (лендинг, docs) работают под непривилегированным nginx, без cap'ов, со строгим CSP.
Компоуз-раннер принимает только узкий набор действий; произвольные аргументы запрещены.