docs: план ротации секретов как отдельное направление работ

This commit is contained in:
root committed 2026-10-14 14:40:33 +03:00
1 parent ba56343b6e
commit bd045706b5
1 file changed
+133
+133
View File
@@ -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,
и остальные сервисы. Пока в работе другие этапы (поток обновлений, наблюдаемость),
такой риск неоправдан. Правильнее закрыть текущие задачи, подготовить карту
зависимостей и провести ротацию отдельным окном.