Files
buryan-infra/ops/security/SECRETS-INVENTORY.md

199 lines
8.3 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.
# Инвентаризация секретов
Составлено 16.10.2026. **Значения здесь не хранятся** — только
расположение, назначение и важность.
## На узле (домашний сервер)
| Файл | Права | Секретов | Что это |
|---|---|---|---|
| `/root/pve.key` | 600 | 2 | ключ узла |
| `/root/.buryan-pg-password` | 600 | 1 | **пароль базы** |
| `/root/.buryan-mtg` | 600 | 1 | секрет mtg (Telegram) |
| `/root/.buryan-vpn` | 600 | 5 | ключи VPN |
| `/root/.buryan-vpn-final` | 600 | 5 | рабочие ссылки VPN |
| `/root/.buryan-adguard` | 600 | 2 | вход AdGuard |
| `/root/.restic-password` | 600 | 1 | **ключ шифрования копий** |
| `/root/bots-tokens.env` | 600 | 5 | токены ботов |
| `/root/.buryan-notify.env` | 600 | 1 | доступ к уведомлениям |
| `/root/.buryan-bots-matrix.env` | 600 | 10 | **доступы ботов Matrix** |
| `/root/.buryan-monitor.env` | 600 | 1 | наблюдение |
| `/root/buryan-infra/ops/secrets/authentik-api.env` | 600 | 1 | **доступ к Authentik** |
| `/opt/buryan-hub/agent-swarm/.env` | 600 | 1 | агент |
**Исправлено 16.10.2026** (были открыты):
| Файл | Было | Стало |
|---|---|---|
| `/root/v1-task5-check-password-impact.sh` | 644 | 600 |
| `/root/v1-task5-fix-immich-password.sh` | 644 | 600 |
| `/root/bot-extra.env` | 644 | 600 |
| `/opt/telegram-bot/.env` | 644 | 600 |
| `/opt/remediation-api/.env` | 644 | 600 |
| `/opt/proxy/.env` | 644 | 600 |
| `/opt/buryan-hub/.env` | 644 | 600 |
| `/opt/buryan-hub/data/portainer/portainer.key` | 755 | 600 |
**Матрица (CT 155):**
| Файл | Было | Стало |
|---|---|---|
| `matrix.buryans.ru.signing.key` | **777** | 600 |
## В контейнерах
| CT | Имя | Файлов с секретами |
|---|---|---|
| 105 | files-lxc | 1 |
| 108 | automation-lxc | 2 |
| 109 | cloud-lxc | 1 |
| 113 | backup-lxc | 1 |
| 114 | authentik-security | 2 |
| 115 | OpenClaw | 1 |
| 127 | linkwarden-lxc | 1 |
| 140 | gitea-lxc | 1 |
| 155 | matrix | 1 |
## Самое ценное — по важности
| # | Что | Где | Почему критично |
|---|---|---|---|
| 1 | **Мастер-пароль Vaultwarden** | у владельца | все пароли семьи |
| 2 | **Ключ подписи Matrix** | CT 155 | без него переписка не расшифруется |
| 3 | **Пароль базы PostgreSQL** | `.buryan-pg-password` | все 40 баз |
| 4 | **Ключ шифрования копий** | `.restic-password` | без него копии на VPS — мусор |
| 5 | **Секреты Authentik** | `authentik-api.env` | вход от имени приложений |
| 6 | **Токены ботов** | `bots-tokens.env` | управление Matrix и Telegram |
## Что уже есть для хранения
| Средство | Состояние | Для чего годится |
|---|---|---|
| **OpenBao** | работает (192.168.1.109:8200) | полноценное хранилище |
| **Vaultwarden** | работает (192.168.1.109:8081) | пароли для людей |
| SOPS + age | не установлены | секреты в Git |
## План
```
ЭТАП 1 (сделано): закрыть права на файлах
ЭТАП 2: завести все секреты в OpenBao
ЭТАП 3: научить скрипты брать секреты из OpenBao
ЭТАП 4: план смены паролей
```
## Правила
1. **Значения секретов НЕ попадают в Git.** Только расположение.
2. Для людей — Vaultwarden. Для служб — OpenBao.
3. Права на файлах с секретами — **600**, не иначе.
4. Ключ подписи Matrix — **резервная копия отдельно** (без него
история переписки теряется навсегда).
---
## Уточнение от 16.10.2026 — что на порту 8200
Проверка показала: **на 192.168.1.109:8200 НЕ OpenBao.**
```
отклик корня: 302
адрес состояния: "Resource not found"
```
Настоящий OpenBao на `/v1/sys/health` отдаёт состояние хранилища,
а не «не найдено». Значит там другая служба.
**ВЫВОД: полноценного хранилища секретов пока НЕТ.**
## Что сделано в задаче 14
```
✅ Закрыто 8 файлов с секретами (644 → 600)
✅ Ключ подписи Matrix закрыт (777 → 600)
✅ Создана инвентаризация (этот файл)
✅ Открытых файлов с секретами: 0
```
## Что осталось
```
1. ВЫБРАТЬ хранилище:
* SOPS + age — просто, секреты в Git, нет службы
* OpenBao — полноценно, но надо ставить
* Vaultwarden — уже есть, но для людей, не для служб
2. ПЕРЕНЕСТИ секреты в выбранное хранилище.
3. НАУЧИТЬ скрипты брать секреты из хранилища
(сейчас читают файлы напрямую).
4. СОЗДАТЬ план смены паролей.
```
## Моя рекомендация
**Начать с SOPS + age.** Причины:
| | SOPS + age | OpenBao |
|---|---|---|
| Сложность | низкая | высокая |
| Зависимость от службы | нет | есть |
| Секреты в Git | ✅ да | ❌ нет |
| Разделение доступа | нет | ✅ да |
| Точки отказа | нет | +1 |
**Для нашего хозяйства SOPS достаточно:** секретов немного
(~70), доступ нужен только администратору, службы читают
файлы локально.
**OpenBao стоит ставить, если понадобится:**
* выдавать службам короткоживущие доступы;
* разграничивать, кто какой секрет видит;
* менять пароли автоматически.
## Как работает SOPS + age (кратко)
```
1. Создаётся ключ age (один файл, хранится отдельно)
2. Секреты шифруются этим ключом → файл в Git
3. В файле видно СТРУКТУРУ, но не значения:
DB_PASSWORD=ENC[AES256_GCM,data:...,type:str]
4. Расшифровка: sops -d secrets.enc.yaml
5. Ключ age хранится ВНЕ Git (в копии)
```
**Плюс:** секреты версионируются вместе с настройками —
видно, кто и когда менял, и можно откатить.
**Минус:** у кого ключ age — тот видит все секреты.
Для одного администратора это приемлемо.
## Файлы, которые надо перенести первыми
| Приоритет | Файл | Почему |
|---|---|---|
| 1 | `.buryan-pg-password` | все 40 баз |
| 2 | `.restic-password` | без него копии — мусор |
| 3 | `authentik-api.env` | вход от имени приложений |
| 4 | `.buryan-bots-matrix.env` | управление Matrix |
| 5 | `bots-tokens.env` | боты |
| 6 | `.buryan-mtg`, `.buryan-vpn*` | обход блокировок |
| 7 | `.buryan-adguard`, `.buryan-notify.env` | службы |
## Отдельно: ключ подписи Matrix
**Этому ключу нужна ОТДЕЛЬНАЯ резервная копия.**
`/data/matrix.buryans.ru.signing.key` — без него вся история
переписки в Matrix становится нерасшифровываемой.
```
Место: CT 155, том matrix-simple_synapse_data
Копии: /root/matrix-backups/config/ (уже есть)
Права: 600 (исправлено 16.10)
```
**Проверить, что ключ есть в копиях Matrix:**
```bash
tar tzf /root/matrix-backups/config/matrix-config-*.tar.gz | grep signing
```