Files
buryan-infra/ops/security/SOPS-HOWTO.md
T

87 lines
3.0 KiB
Markdown
Raw 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.
# Секреты: 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. Создать план смены паролей.