diff --git a/ops/secrets-enc/secrets.example.yaml b/ops/secrets-enc/secrets.example.yaml deleted file mode 100644 index c878cb6..0000000 --- a/ops/secrets-enc/secrets.example.yaml +++ /dev/null @@ -1,31 +0,0 @@ -# ============================================================ -# СЕКРЕТЫ ХОЗЯЙСТВА — ЗАШИФРОВАННЫЙ ФАЙЛ -# ============================================================ -# Этот файл шифруется целиком. Значения видны только с ключом. -# -# Расшифровать: sops -d ops/secrets-enc/secrets.yaml -# Изменить: sops ops/secrets-enc/secrets.yaml -# ============================================================ - -# ── База данных ── -database: - host: "192.168.1.151" - port: "5432" - user: "postgres" - password: "ЗАПОЛНИТЬ" - -# ── Копии (restic) ── -backup: - restic_password: "ЗАПОЛНИТЬ" - -# ── Authentik (вход) ── -authentik: - api_token: "ЗАПОЛНИТЬ" - -# ── Обход блокировок ── -vpn: - mtg_secret: "ЗАПОЛНИТЬ" - -# ── Уведомления ── -notify: - matrix_token: "ЗАПОЛНИТЬ" diff --git a/ops/security/SOPS-HOWTO.md b/ops/security/SOPS-HOWTO.md new file mode 100644 index 0000000..fd20c9f --- /dev/null +++ b/ops/security/SOPS-HOWTO.md @@ -0,0 +1,86 @@ +# Секреты: SOPS + age + +Внедрено 16.10.2026. + +## Что установлено + +``` +age: 1.2.1 +sops: 3.13.3 + +Ключ шифрования: /root/.config/sops/age/keys.txt (права 600) +Копия ключа: /root/.buryan-age-key (права 600) +Файл секретов: ops/secrets-enc/secrets.yaml (зашифрован) +Настройка: .sops.yaml +``` + +## Как пользоваться + +```bash +# Посмотреть значения +sops -d ops/secrets-enc/secrets.yaml + +# Изменить (откроется редактор, при сохранении зашифруется) +sops ops/secrets-enc/secrets.yaml + +# Посмотреть СТРУКТУРУ без значений +cat ops/secrets-enc/secrets.yaml +``` + +## Что видно без ключа + +```yaml +database: + host: ENC[AES256_GCM,data:...,type:str] + password: ENC[AES256_GCM,data:...,type:str] +``` +**Значения нечитаемы. Ключи и структура — видны.** + +## ПОЧЕМУ SOPS, А НЕ OPENBAO + +| | SOPS + age | OpenBao | +|---|---|---| +| Зависимость от службы | **нет** | +1 точка отказа | +| Секреты в Git | ✅ версионируются | ❌ | +| Работа без сети | ✅ | ❌ | +| Разделение доступа | нет | ✅ | + +**Секретов ~70, доступ нужен одному администратору.** +SOPS достаточно. OpenBao — если понадобится выдавать +службам короткоживущие доступы. + +## ⚠️ ГЛАВНОЕ: КЛЮЧ + +**Без файла `keys.txt` секреты НЕ расшифруются.** + +Ключ надо положить: +1. **В Vaultwarden** — как защищённую заметку; +2. **На внешний носитель** — флешка, отдельно от сервера; +3. **В копии** — но помните: если ключ лежит рядом с + зашифрованным файлом, шифрование бесполезно. + +**Правило:** ключ и зашифрованные данные — в РАЗНЫХ местах. + +## Проверить, что ключ есть в резервных копиях + +```bash +# Ключ НЕ должен попадать в Git (проверено) +cd /root/buryan-infra && git check-ignore -v buryan-age-key + +# Но должен быть в копиях системы +ls -la /root/.buryan-age-key +``` + +## Добавить новый секрет + +```bash +sops ops/secrets-enc/secrets.yaml +# добавить строку, сохранить — зашифруется автоматически +``` + +## Что дальше + +1. Заполнить реальные значения (сейчас заглушки «ЗАПОЛНИТЬ»); +2. Научить скрипты брать секреты из этого файла; +3. Убрать секреты из открытых `.env` файлов; +4. Создать план смены паролей.