6.3 KiB
Секреты: 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
Как пользоваться
# Посмотреть значения
sops -d ops/secrets-enc/secrets.yaml
# Изменить (откроется редактор, при сохранении зашифруется)
sops ops/secrets-enc/secrets.yaml
# Посмотреть СТРУКТУРУ без значений
cat ops/secrets-enc/secrets.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 секреты НЕ расшифруются.
Ключ надо положить:
- В Vaultwarden — как защищённую заметку;
- На внешний носитель — флешка, отдельно от сервера;
- В копии — но помните: если ключ лежит рядом с зашифрованным файлом, шифрование бесполезно.
Правило: ключ и зашифрованные данные — в РАЗНЫХ местах.
Проверить, что ключ есть в резервных копиях
# Ключ НЕ должен попадать в Git (проверено)
cd /root/buryan-infra && git check-ignore -v buryan-age-key
# Но должен быть в копиях системы
ls -la /root/.buryan-age-key
Добавить новый секрет
sops ops/secrets-enc/secrets.yaml
# добавить строку, сохранить — зашифруется автоматически
Что дальше
- Заполнить реальные значения (сейчас заглушки «ЗАПОЛНИТЬ»);
- Научить скрипты брать секреты из этого файла;
- Убрать секреты из открытых
.envфайлов; - Создать план смены паролей.
Обновление: секреты заполнены, скрипты могут их брать
Помощник для скриптов
/opt/buryan-hub/scripts/secret.sh
Использование:
# Прямо
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)
Как перевести скрипт на секреты
Было:
PASSWORD=$(cat /root/.buryan-pg-password | cut -d= -f2)
Стало:
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
Порядок перевода скрипта
- Найти в скрипте чтение секрета из файла;
- Заменить на вызов помощника;
- Проверить, что скрипт работает;
- Только потом убирать старый файл (или оставить как запас).
ВАЖНО: старые файлы НЕ удаляю, пока не убедился, что все скрипты переведены и работают.
Обновление: помощник с запасным путём
Помощник /opt/buryan-hub/scripts/secret.sh теперь умеет два пути:
1. зашифрованный файл SOPS (основной)
2. старые файлы /root/.* (запасной)
Зачем запасной: чтобы переводить скрипты по одному и не сломать работающие. Если SOPS недоступен — берётся прежнее значение.
Когда убирать запасной путь: после того, как ВСЕ скрипты переведены и проверены. Тогда старые файлы можно удалить, а запасной код — убрать.
Как переводить скрипт
# Было:
PG_PASS=$(grep -oE '^PG_PASSWORD=.*' /root/.buryan-pg-password | cut -d= -f2)
# Стало:
PG_PASS=$(/opt/buryan-hub/scripts/secret.sh database password)
Порядок:
- копия скрипта;
- замена чтения на помощника;
- запуск и проверка результата;
- если работает — оставить; если нет — вернуть копию.
Что проверено
✅ помощник отдаёт все 5 секретов из SOPS
✅ запасной путь (старые файлы) работает
✅ уведомления работают
✅ проверка копий работает
✅ проверка служб работает