diff --git a/ops/security/SOPS-HOWTO.md b/ops/security/SOPS-HOWTO.md index fd20c9f..0a2d7e0 100644 --- a/ops/security/SOPS-HOWTO.md +++ b/ops/security/SOPS-HOWTO.md @@ -84,3 +84,61 @@ sops ops/secrets-enc/secrets.yaml 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. Только потом убирать старый файл (или оставить как запас). + +**ВАЖНО:** старые файлы НЕ удаляю, пока не убедился, +что все скрипты переведены и работают. diff --git a/ops/security/secret.sh b/ops/security/secret.sh new file mode 100755 index 0000000..c745ecd --- /dev/null +++ b/ops/security/secret.sh @@ -0,0 +1,32 @@ +#!/bin/bash +# ============================================================ +# secret.sh — получить секрет из зашифрованного файла +# ============================================================ +# Использование: +# source /opt/buryan-hub/scripts/secret.sh +# PASS=$(secret database password) +# +# или одной командой: +# /opt/buryan-hub/scripts/secret.sh database password +# ============================================================ +SECRETS_FILE="${SECRETS_FILE:-/root/buryan-infra/ops/secrets-enc/secrets.yaml}" +export SOPS_AGE_KEY_FILE="${SOPS_AGE_KEY_FILE:-/root/.config/sops/age/keys.txt}" + +secret() { # $1=раздел $2=ключ + local section="$1" key="$2" + command -v sops >/dev/null 2>&1 || { echo "нет sops" >&2; return 1; } + [ -f "$SECRETS_FILE" ] || { echo "нет файла секретов" >&2; return 1; } + sops --decrypt "$SECRETS_FILE" 2>/dev/null | python3 -c " +import sys, yaml +try: + d = yaml.safe_load(sys.stdin) + print(d.get('$section', {}).get('$key', '')) +except Exception: + pass +" 2>/dev/null +} + +# Если запущен как скрипт — вывести значение +if [ "${BASH_SOURCE[0]}" = "${0}" ]; then + secret "$1" "$2" +fi