Files

OpenBao

OpenBao работает вне dev-mode с single-node integrated Raft. Данные сохраняются в /openbao/data, API принимает только TLS 1.3 на 8200, cluster transport использует 8201. Сертификат и ключ передаются в /run/security/openbao, а не входят в образ.

Идентичности

messenger-api и messenger-worker — разные AppRole. Каждая роль:

  • читает только свой secret/data/messenger/<service> в KV v2;
  • получает renewable token на 15 минут с максимальным TTL 1 час;
  • использует короткоживущий SecretID с TTL один час;
  • не получает policy default, доступ к чужому secret или управление policies.

OpenBao Agent читает RoleID и короткоживущий SecretID, renew-ит token и повторно аутентифицируется после его истечения или рестарта. SecretID действует один час и хранится в operator-controlled каталоге с правами 0600; после истечения оператор выдаёт новый через openbao-issue-approle.sh. KV v2 secret рендерится в защищённый Docker volume /run/openbao-secrets/secrets.json с правами 0600; токен Agent хранится отдельно в tmpfs /run/openbao-agent. Старый rendered secret не считается признаком здоровья: healthcheck также проверяет token и процесс Agent.

Bootstrap оператора

Все команды выполняются с проверкой CA и hostname. BAO_ADDR по умолчанию равен https://localhost:8200, BAO_CACERT — .runtime/security/openbao/ca.crt.

scripts/openbao-init.sh
scripts/openbao-unseal.sh
chmod 0600 .runtime/openbao/seed/api.json .runtime/openbao/seed/worker.json
scripts/openbao-bootstrap.sh \
  "$PWD/.runtime/openbao/seed/api.json" \
  "$PWD/.runtime/openbao/seed/worker.json"
scripts/openbao-test-policy.sh

Seed-файлы — непустые JSON-объекты с фактическими credentials сервиса. Скрипт не выводит значения в консоль. operator init создаёт три unseal share с threshold 2 и сохраняет единственную локальную копию в .runtime/openbao/operator/init.json с правами 0600. Этот каталог игнорируется Git.

Для учебного локального стенда оператор хранит init-файл вне контейнера. В реальном окружении shares нужно разделить между операторами либо защитить KMS/HSM, а root token отозвать после настройки recovery-доступа. API, worker и Agent не получают root token или unseal shares.

После обычного перезапуска данные остаются в Raft volume, но процесс остаётся sealed до ручного scripts/openbao-unseal.sh. Перезапуск API и worker не требует unseal.

Ротация

chmod 0600 .runtime/openbao/seed/api-next.json
scripts/openbao-rotate.sh api "$PWD/.runtime/openbao/seed/api-next.json"

Ротация создаёт новую версию KV v2 и новый короткоживущий SecretID; предыдущий accessor отзывается. Agent перечитывает статический secret не позднее пяти минут. Уже выданный token может жить до своего TTL, поэтому при компрометации дополнительно отзывают его accessor или отключают роль и перезапускают Agent с новой идентичностью.

scripts/openbao-test-policy.sh выдаёт временные AppRole credentials, проверяет разрешённое чтение собственного пути, запрет чужого пути, записи и управления policies, а также renewal. Временные tokens отзываются при завершении.