docs: план ротации секретов как отдельное направление работ
This commit is contained in:
1 parent
ba56343b6e
commit
bd045706b5
1 file changed
+133
@@ -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,
|
||||
и остальные сервисы. Пока в работе другие этапы (поток обновлений, наблюдаемость),
|
||||
такой риск неоправдан. Правильнее закрыть текущие задачи, подготовить карту
|
||||
зависимостей и провести ротацию отдельным окном.
|
||||
Reference in new issue
Block a user