Files
buryan-infra/docs/SECRETS-ROTATION-PLAN.md

10 KiB
Raw Permalink Blame History

План ротации секретов

Создан: 2026-10-14 Статус: отдельное направление работ. Не выполняется попутно с другими этапами. Причина выделения: см. раздел 1.


1. Почему это отдельная часть, а не «попутная уборка»

Ротация секретов выглядит как простая задача: сменить пароль в одном месте. На практике каждое значение живёт в нескольких конфигурациях, и смена «в одном месте» ломает сервис. Пример из этой же инфраструктуры: мастер-пароль используется в четырёх ключах homeserver.yaml, в базе Mealie, в Authentik и в расписании мониторинга. Смена без карты «где что лежит» останавливает Matrix, SSO и мониторинг одновременно.

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

Второй довод: ротация — единственный вид работ, который не даёт видимого результата, но при ошибке ломает всё сразу. Его нужно делать спокойно и отдельным окном.


2. Что известно и где это лежит

🔴 Группа A — секреты в Git (устранение не требует ротации)

Утечка уже произошла, значение считается скомпрометированным. Но сначала нужно убрать значения из репозиториев, иначе ротация бессмысленна: новое значение снова окажется в Git.

Что Где
Токен Gitea ops/weekly-report.sh, infra/n8n/workflows/workflow-current.json, ops/backups/*.json
Токены ботов ops/sprint1/*.sh (6 файлов), workflows/n8n/f6-2-*.json (уже вынесен в плейсхолдер)
Токен Authentik workflows/n8n/f6-2-*.json
Мастер-пароль docs/matrix-sprint-runbook.md
Репозиторий root/buryan-hub каталог data/ целиком: кластер PostgreSQL, токены Home Assistant, ключ шифрования n8n, приватные ключи

Порядок: вычистить значения из рабочего дерева → вычистить историю root/buryan-hub (git filter-repo + force-push) → только потом менять значения.

🔴 Группа B — открытые текстом вне Git

Что Где Кто использует
Мастер-пароль (6+ мест) homeserver.yaml ×4, Mealie, Authentik, cron мониторинга Matrix, Mealie, Authentik, контроль пула
Пароль Bitwarden API tools/gitea-recon.py, D:\Пароли.txt доступ ко всему сейфу
Токен Gitea (root) D:\Пароли.txt, скрипты CI/CD, n8n, бот
Ключи DeepSeek и Qwen D:\Пароли.txt, secrets-master-catalog.sh ИИ-вызовы
Пароль matrix_db /root/.matrix-pg-pass Synapse
Пароль restic /root/.restic-password offsite-копии
Пароль buryan_monitor вынесен в /root/.buryan-monitor.env (было в файле расписания) контроль пула
Токены пяти ботов переписка, /root/bots-tokens.env боты

🟡 Группа C — слабые или переиспользованные

Что Проблема
abcdefghijklmnop1234567890ABCDEF слабый, используется и как JWT n8n, и как cookie oauth2-proxy
pg_hba.conf доступ по всей локальной сети, метод md5 вместо scram-sha-256
Один пароль Duplicati на всех 28 контейнерах передан аргументом командной строки, виден через ps

3. Правила, без которых ротация не имеет смысла

  1. Сначала убрать из Git, потом менять. Иначе новое значение утечёт тем же путём.
  2. Один секрет — одно место хранения. Файл .env с правами 600 либо Vaultwarden. Никаких значений в командных строках, в расписании, в JSON workflow.
  3. Перед сменой — карта потребителей. Если непонятно, кто использует значение, менять нельзя.
  4. Порядок от простого к сложному. Секреты с одним потребителем меняются первыми, мастер-пароль — последним.
  5. Каждая группа — отдельная проверка. После смены убедиться, что сервис работает, и только потом идти дальше.
  6. Окно и откат. Перед группой — снимок контейнера или копия конфигурации.
  7. Никогда не во время другого спринта. Если сервис в работе — он не в этой группе.

4. Предлагаемые этапы

Этап Что делаем Риск Что проверяем
0 Вычистить значения из рабочего дерева всех репозиториев; перевести скрипты на чтение из .env низкий grep по репозиториям не находит значений
1 Вычистить историю root/buryan-hub, закрыть доступ агентам и вебхуку средний клон не содержит каталога data/
2 Ротация одиночных секретов: пять токенов ботов, токен Gitea, токен Authentik, ключи DeepSeek и Qwen низкий каждый бот отвечает, задачи создаются
3 Ротация паролей баз: matrix_db, buryan_monitor, MySQL, authentik_db средний сервисы подключаются к базам
4 Ротация Bitwarden API и перенос всех значений в Vaultwarden средний доступ к сейфу, запись и чтение
5 Мастер-пароль: Matrix, Mealie, Authentik — по одному сервису высокий каждый сервис после смены
6 pg_hba.conf → scram-sha-256 и точечные правила вместо всей подсети средний все подключения из списка
7 Duplicati: уникальные пароли, убрать из командной строки, интерфейс только на localhost низкий копии создаются

Этапы 0 и 1 — предварительные. Они не меняют значения, но без них остальное бессмысленно, и их можно делать в любое время: они никого не прерывают.


5. Что нужно подготовить перед началом

  • Реестр потребителей каждого секрета (по образцу docs/BOTS.md)
  • Проверенный доступ в Vaultwarden и понятная структура папок
  • Согласованное окно: этапы 5 и 6 требуют остановки сервисов
  • Снимки или копии конфигураций перед каждой группой
  • Решение владельца о порядке: сначала простое или сначала критичное

6. Что уже сделано попутно

  • Пароль buryan_monitor вынесен из общедоступного файла расписания в /root/.buryan-monitor.env с правами 600.
  • Токен бота доступов вынесен из workflow в плейсхолдер, реестр ботов (docs/BOTS.md) хранит роли без значений.
  • Введено правило: один бот — одна роль — одно место хранения токена, что делает ротацию ботов правкой одной строки в одном файле.

Это подготовка, а не ротация. Значения остаются прежними.


7. Почему не сейчас

Ротация мастер-пароля затрагивает Matrix, Authentik и Mealie одновременно. Любая ошибка в этот момент остановит SSO — а на SSO завязаны и Gitea, и Grafana, и остальные сервисы. Пока в работе другие этапы (поток обновлений, наблюдаемость), такой риск неоправдан. Правильнее закрыть текущие задачи, подготовить карту зависимостей и провести ротацию отдельным окном.