From bd045706b51b7f84ea62df1b8af9b4c0e57c7605 Mon Sep 17 00:00:00 2001 From: Roman Buryan Date: Wed, 14 Oct 2026 14:40:33 +0300 Subject: [PATCH] =?UTF-8?q?docs:=20=D0=BF=D0=BB=D0=B0=D0=BD=20=D1=80=D0=BE?= =?UTF-8?q?=D1=82=D0=B0=D1=86=D0=B8=D0=B8=20=D1=81=D0=B5=D0=BA=D1=80=D0=B5?= =?UTF-8?q?=D1=82=D0=BE=D0=B2=20=D0=BA=D0=B0=D0=BA=20=D0=BE=D1=82=D0=B4?= =?UTF-8?q?=D0=B5=D0=BB=D1=8C=D0=BD=D0=BE=D0=B5=20=D0=BD=D0=B0=D0=BF=D1=80?= =?UTF-8?q?=D0=B0=D0=B2=D0=BB=D0=B5=D0=BD=D0=B8=D0=B5=20=D1=80=D0=B0=D0=B1?= =?UTF-8?q?=D0=BE=D1=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/SECRETS-ROTATION-PLAN.md | 133 ++++++++++++++++++++++++++++++++++ 1 file changed, 133 insertions(+) create mode 100644 docs/SECRETS-ROTATION-PLAN.md diff --git a/docs/SECRETS-ROTATION-PLAN.md b/docs/SECRETS-ROTATION-PLAN.md new file mode 100644 index 0000000..77b6301 --- /dev/null +++ b/docs/SECRETS-ROTATION-PLAN.md @@ -0,0 +1,133 @@ +# План ротации секретов + +**Создан:** 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, +и остальные сервисы. Пока в работе другие этапы (поток обновлений, наблюдаемость), +такой риск неоправдан. Правильнее закрыть текущие задачи, подготовить карту +зависимостей и провести ротацию отдельным окном.