Files

190 lines
6.3 KiB
Markdown
Raw Permalink 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. Создать план смены паролей.
---
## Обновление: секреты заполнены, скрипты могут их брать
### Помощник для скриптов
```
/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. Только потом убирать старый файл (или оставить как запас).
**ВАЖНО:** старые файлы НЕ удаляю, пока не убедился,
что все скрипты переведены и работают.
---
## Обновление: помощник с запасным путём
Помощник `/opt/buryan-hub/scripts/secret.sh` теперь умеет два пути:
```
1. зашифрованный файл SOPS (основной)
2. старые файлы /root/.* (запасной)
```
**Зачем запасной:** чтобы переводить скрипты **по одному**
и не сломать работающие. Если SOPS недоступен — берётся
прежнее значение.
**Когда убирать запасной путь:** после того, как ВСЕ скрипты
переведены и проверены. Тогда старые файлы можно удалить,
а запасной код — убрать.
## Как переводить скрипт
```bash
# Было:
PG_PASS=$(grep -oE '^PG_PASSWORD=.*' /root/.buryan-pg-password | cut -d= -f2)
# Стало:
PG_PASS=$(/opt/buryan-hub/scripts/secret.sh database password)
```
**Порядок:**
1. копия скрипта;
2. замена чтения на помощника;
3. **запуск и проверка результата**;
4. если работает — оставить; если нет — вернуть копию.
## Что проверено
```
✅ помощник отдаёт все 5 секретов из SOPS
✅ запасной путь (старые файлы) работает
✅ уведомления работают
✅ проверка копий работает
✅ проверка служб работает
```