# Секреты: 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. Только потом убирать старый файл (или оставить как запас). **ВАЖНО:** старые файлы НЕ удаляю, пока не убедился, что все скрипты переведены и работают.