10 KiB
План ротации секретов
Создан: 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. Правила, без которых ротация не имеет смысла
- Сначала убрать из Git, потом менять. Иначе новое значение утечёт тем же путём.
- Один секрет — одно место хранения. Файл
.envс правами 600 либо Vaultwarden. Никаких значений в командных строках, в расписании, в JSON workflow. - Перед сменой — карта потребителей. Если непонятно, кто использует значение, менять нельзя.
- Порядок от простого к сложному. Секреты с одним потребителем меняются первыми, мастер-пароль — последним.
- Каждая группа — отдельная проверка. После смены убедиться, что сервис работает, и только потом идти дальше.
- Окно и откат. Перед группой — снимок контейнера или копия конфигурации.
- Никогда не во время другого спринта. Если сервис в работе — он не в этой группе.
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, и остальные сервисы. Пока в работе другие этапы (поток обновлений, наблюдаемость), такой риск неоправдан. Правильнее закрыть текущие задачи, подготовить карту зависимостей и провести ротацию отдельным окном.