From 9f594baf92c27de0f2843aa6f2ef0e6e2a705c51 Mon Sep 17 00:00:00 2001 From: Roman Buryan Date: Fri, 16 Oct 2026 16:42:27 +0300 Subject: [PATCH] =?UTF-8?q?=D1=81=D0=B5=D0=BA=D1=80=D0=B5=D1=82=D1=8B:=20?= =?UTF-8?q?=D0=B7=D0=BD=D0=B0=D1=87=D0=B5=D0=BD=D0=B8=D1=8F=20=D0=B7=D0=B0?= =?UTF-8?q?=D0=BF=D0=BE=D0=BB=D0=BD=D0=B5=D0=BD=D1=8B,=20=D1=81=D0=BE?= =?UTF-8?q?=D0=B7=D0=B4=D0=B0=D0=BD=20=D0=BF=D0=BE=D0=BC=D0=BE=D1=89=D0=BD?= =?UTF-8?q?=D0=B8=D0=BA=20=D0=B4=D0=BB=D1=8F=20=D1=81=D0=BA=D1=80=D0=B8?= =?UTF-8?q?=D0=BF=D1=82=D0=BE=D0=B2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ops/security/SOPS-HOWTO.md | 58 ++++++++++++++++++++++++++++++++++++++ ops/security/secret.sh | 32 +++++++++++++++++++++ 2 files changed, 90 insertions(+) create mode 100755 ops/security/secret.sh 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