# План ротации секретов **Создан:** 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, и остальные сервисы. Пока в работе другие этапы (поток обновлений, наблюдаемость), такой риск неоправдан. Правильнее закрыть текущие задачи, подготовить карту зависимостей и провести ротацию отдельным окном.