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

134 lines
10 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# План ротации секретов
**Создан:** 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,
и остальные сервисы. Пока в работе другие этапы (поток обновлений, наблюдаемость),
такой риск неоправдан. Правильнее закрыть текущие задачи, подготовить карту
зависимостей и провести ротацию отдельным окном.