From 74720ea7a5ed07effb8c8e421e9f9394a877b710 Mon Sep 17 00:00:00 2001 From: Roman Buryan Date: Fri, 16 Oct 2026 16:41:07 +0300 Subject: [PATCH] =?UTF-8?q?=D1=81=D0=B5=D0=BA=D1=80=D0=B5=D1=82=D1=8B:=20S?= =?UTF-8?q?OPS+age=20=D1=80=D0=B0=D0=B1=D0=BE=D1=82=D0=B0=D0=B5=D1=82,=20?= =?UTF-8?q?=D1=84=D0=B0=D0=B9=D0=BB=20=D0=B7=D0=B0=D1=88=D0=B8=D1=84=D1=80?= =?UTF-8?q?=D0=BE=D0=B2=D0=B0=D0=BD,=20=D0=BA=D0=BB=D1=8E=D1=87=20=D0=B7?= =?UTF-8?q?=D0=B0=D1=89=D0=B8=D1=89=D1=91=D0=BD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ops/secrets-enc/secrets.example.yaml | 31 ---------- ops/security/SOPS-HOWTO.md | 86 ++++++++++++++++++++++++++++ 2 files changed, 86 insertions(+), 31 deletions(-) delete mode 100644 ops/secrets-enc/secrets.example.yaml create mode 100644 ops/security/SOPS-HOWTO.md 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. Создать план смены паролей.