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 отзываются при завершении.