145 lines
4.8 KiB
Markdown
145 lines
4.8 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. Создать план смены паролей.
|
||
|
||
---
|
||
|
||
## Обновление: секреты заполнены, скрипты могут их брать
|
||
|
||
### Помощник для скриптов
|
||
|
||
```
|
||
/opt/buryan-hub/scripts/secret.sh
|
||
```
|
||
|
||
**Использование:**
|
||
```bash
|
||
# Прямо
|
||
PASS=$(/opt/buryan-hub/scripts/secret.sh database password)
|
||
|
||
# Или подключить в скрипт
|
||
source /opt/buryan-hub/scripts/secret.sh
|
||
PASS=$(secret database password)
|
||
RESTIC=$(secret backup restic_password)
|
||
```
|
||
|
||
### Как перевести скрипт на секреты
|
||
|
||
**Было:**
|
||
```bash
|
||
PASSWORD=$(cat /root/.buryan-pg-password | cut -d= -f2)
|
||
```
|
||
|
||
**Стало:**
|
||
```bash
|
||
PASSWORD=$(/opt/buryan-hub/scripts/secret.sh database password)
|
||
```
|
||
|
||
**Плюсы:**
|
||
* секрет не лежит в открытом файле;
|
||
* при смене пароля правится одно место;
|
||
* секреты версионируются в Git (зашифрованными).
|
||
|
||
### Что заполнено сейчас
|
||
|
||
```
|
||
database.password — пароль базы
|
||
backup.restic_password— ключ шифрования копий
|
||
authentik.api_token — доступ к Authentik
|
||
vpn.mtg_secret — прокси Telegram
|
||
notify.matrix_token — токен бота Matrix
|
||
```
|
||
|
||
### Порядок перевода скрипта
|
||
|
||
1. Найти в скрипте чтение секрета из файла;
|
||
2. Заменить на вызов помощника;
|
||
3. **Проверить, что скрипт работает**;
|
||
4. Только потом убирать старый файл (или оставить как запас).
|
||
|
||
**ВАЖНО:** старые файлы НЕ удаляю, пока не убедился,
|
||
что все скрипты переведены и работают.
|