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