Files

6.3 KiB
Raw Permalink Blame History

Секреты: 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 секреты НЕ расшифруются.

Ключ надо положить:

  1. В Vaultwarden — как защищённую заметку;
  2. На внешний носитель — флешка, отдельно от сервера;
  3. В копии — но помните: если ключ лежит рядом с зашифрованным файлом, шифрование бесполезно.

Правило: ключ и зашифрованные данные — в РАЗНЫХ местах.

Проверить, что ключ есть в резервных копиях

# Ключ НЕ должен попадать в Git (проверено)
cd /root/buryan-infra && git check-ignore -v buryan-age-key

# Но должен быть в копиях системы
ls -la /root/.buryan-age-key

Добавить новый секрет

sops ops/secrets-enc/secrets.yaml
# добавить строку, сохранить — зашифруется автоматически

Что дальше

  1. Заполнить реальные значения (сейчас заглушки «ЗАПОЛНИТЬ»);
  2. Научить скрипты брать секреты из этого файла;
  3. Убрать секреты из открытых .env файлов;
  4. Создать план смены паролей.

Обновление: секреты заполнены, скрипты могут их брать

Помощник для скриптов

/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

Порядок перевода скрипта

  1. Найти в скрипте чтение секрета из файла;
  2. Заменить на вызов помощника;
  3. Проверить, что скрипт работает;
  4. Только потом убирать старый файл (или оставить как запас).

ВАЖНО: старые файлы НЕ удаляю, пока не убедился, что все скрипты переведены и работают.


Обновление: помощник с запасным путём

Помощник /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)

Порядок:

  1. копия скрипта;
  2. замена чтения на помощника;
  3. запуск и проверка результата;
  4. если работает — оставить; если нет — вернуть копию.

Что проверено

✅ помощник отдаёт все 5 секретов из SOPS
✅ запасной путь (старые файлы) работает
✅ уведомления работают
✅ проверка копий работает
✅ проверка служб работает