diff --git a/ops/scripts/KEY-BACKUP-HOWTO.md b/ops/scripts/KEY-BACKUP-HOWTO.md new file mode 100644 index 0000000..532fa46 --- /dev/null +++ b/ops/scripts/KEY-BACKUP-HOWTO.md @@ -0,0 +1,108 @@ +# Куда положить ключ шифрования секретов + +**Ключ:** `/root/.buryan-age-key` + +**Без него секреты не расшифровать.** Поэтому он должен лежать +**в трёх местах**. + +## Три места + +| # | Где | Как | Состояние | +|---|---|---|---| +| 1 | Сервер | уже лежит | готово | +| 2 | Vaultwarden | `bash put-key-to-vaultwarden.sh` | надо сделать | +| 3 | Флешка | `bash put-key-to-usb.sh` | надо сделать | + +**Правило: ключ и зашифрованные данные — В РАЗНЫХ МЕСТАХ.** +Если ключ лежит рядом с зашифрованным файлом, шифрование +не имеет смысла. + +## Скрипт 1: в Vaultwarden + +``` +bash /root/put-key-to-vaultwarden.sh +``` + +Что делает: +``` +1. Проверяет ключ +2. Ставит программу bw, если её нет +3. Спрашивает почту и мастер-пароль (скрытно, не в журнал) +4. Создаёт защищённую заметку в избранном: + Бурян Хаб - КЛЮЧ ШИФРОВАНИЯ СЕКРЕТОВ +5. Внутри: сам ключ + инструкция по восстановлению + отпечаток +6. Прикрепляет файл ключа +7. Выходит из хранилища, убирает временные файлы +``` + +Если не выйдет (двухшаговая проверка и подобное) — скрипт +покажет ручную инструкцию через браузер. + +## Скрипт 2: на флешку + +``` +bash /root/put-key-to-usb.sh +``` + +Что делает: +``` +1. Показывает все съёмные устройства +2. Спрашивает, какое использовать +3. Подключает, НЕ форматирует +4. Копирует в папку BURYAN-KEY: + age-key.txt - сам ключ + age-key.sha256 - контрольная сумма + fingerprint.txt - отпечаток + ПРОЧТИ-МЕНЯ.txt - инструкция по восстановлению + что-открывает-ключ.txt - какие секреты открывает +5. СВЕРЯЕТ копию с оригиналом +6. ПРОВЕРЯЕТ, что ключ с флешки реально расшифровывает секреты +7. Записывает на диск и отключает безопасно +``` + +Флешка становится самодостаточной: на ней и ключ, +и инструкция, и проверка подлинности. + +## Где хранить флешку + +``` +НЕ рядом с сервером (пожар, кража, вода - погибнут вместе) +ДА - другое помещение +ДА - у близкого человека +ДА - в сейфе + +Если сервер погибнет - ключ на сервере погибнет тоже. +Флешка в другом месте спасёт доступы. +``` + +## Проверять раз в несколько месяцев + +Флешки портятся. Периодически: +``` +1. Вставить флешку +2. Открыть папку BURYAN-KEY +3. Убедиться, что age-key.txt читается +4. Сверить отпечаток с fingerprint.txt +``` + +Если не читается — сделать новую копию. + +## Проверка, что ключ работает + +``` +sops -d /root/buryan-infra/ops/secrets-enc/secrets.yaml +``` + +Должны появиться значения (не ошибка). + +## Если ключ потерян ВЕЗДЕ + +Тогда секреты не восстановить. Придётся: +``` +1. Сменить пароль базы +2. Перевыпустить доступы Authentik +3. Перевыпустить токены ботов +4. Создать новый ключ шифрования +``` + +**Поэтому три копии — не избыточность, а необходимость.** diff --git a/ops/scripts/put-key-to-usb.sh b/ops/scripts/put-key-to-usb.sh new file mode 100755 index 0000000..25276b4 --- /dev/null +++ b/ops/scripts/put-key-to-usb.sh @@ -0,0 +1,415 @@ +#!/bin/bash +# ============================================================ +# put-key-to-usb.sh +# ============================================================ +# Копирует ключ шифрования секретов на флешку +# вместе с инструкцией по восстановлению. +# +# ВАЖНО: флешка должна храниться ОТДЕЛЬНО от сервера. +# Правило: ключ и зашифрованные данные — в РАЗНЫХ местах. +# +# ЗАПУСК: bash put-key-to-usb.sh +# ============================================================ +set -uo pipefail + +KEY_FILE="/root/.buryan-age-key" +SECRETS_FILE="/root/buryan-infra/ops/secrets-enc/secrets.yaml" +MOUNT="/mnt/usb-key" + +echo "╔══════════════════════════════════════════════════════════╗" +echo "║ КОПИРУЮ КЛЮЧ НА ФЛЕШКУ ║" +echo "╚══════════════════════════════════════════════════════════╝" + +echo +echo "═══════════════════════════════════════════════════════════" +echo " 1. ПРОВЕРКА КЛЮЧА" +echo "═══════════════════════════════════════════════════════════" +if [ ! -f "$KEY_FILE" ]; then + echo " ❌ ключ не найден: $KEY_FILE" + exit 1 +fi +FP=$(grep -oE 'age1[a-z0-9]+' "$KEY_FILE" 2>/dev/null | head -1) +KEYSUM=$(sha256sum "$KEY_FILE" | cut -c1-16) +echo " ✅ ключ найден" +printf ' права: %s\n' "$(stat -c '%a' "$KEY_FILE")" +printf ' отпечаток: %s...\n' "${FP:0:24}" +printf ' контрольная сумма: %s\n' "$KEYSUM" +echo "$FP" > /tmp/usb-fingerprint.txt +echo "$KEYSUM" > /tmp/usb-checksum.txt + +echo +echo "═══════════════════════════════════════════════════════════" +echo " 2. ИЩУ ФЛЕШКИ" +echo "═══════════════════════════════════════════════════════════" +echo " ── все устройства и разделы ──" +lsblk -o NAME,SIZE,TYPE,FSTYPE,LABEL,MOUNTPOINT 2>/dev/null | sed 's/^/ /' + +echo +echo " ── съёмные устройства ──" +REMOVABLE="" +for dev in /sys/block/sd*; do + [ -e "$dev/removable" ] || continue + [ "$(cat "$dev/removable" 2>/dev/null)" = "1" ] || continue + NAME=$(basename "$dev") + SIZE=$(lsblk -dno SIZE "/dev/$NAME" 2>/dev/null) + MODEL=$(cat "$dev/device/model" 2>/dev/null | xargs) + printf ' /dev/%-6s %-8s %s\n' "$NAME" "$SIZE" "$MODEL" + REMOVABLE="$REMOVABLE $NAME" +done + +if [ -z "$REMOVABLE" ]; then + echo " ⚠️ съёмных устройств не найдено" + echo + echo " ── ЧТО ДЕЛАТЬ ──" + cat <<'HELP' + 1. Вставьте флешку в USB-порт сервера + (или в компьютер, если будете копировать иначе) + 2. Запустите этот скрипт снова + + ЕСЛИ ФЛЕШКА НЕ ОПРЕДЕЛЯЕТСЯ: + dmesg | tail -20 — посмотреть, увидел ли сервер + lsblk — список всех устройств + + ЕСЛИ СЕРВЕР БЕЗ USB ИЛИ ДАЛЕКО: + скопируйте ключ другим способом, например: + scp root@192.168.1.10:/root/.buryan-age-key . + и перенесите на флешку с компьютера +HELP + exit 0 +fi + +echo +echo "═══════════════════════════════════════════════════════════" +echo " 3. ВЫБОР ФЛЕШКИ" +echo "═══════════════════════════════════════════════════════════" +echo +echo " ⚠️ ВНИМАНИЕ: скрипт КОПИРУЕТ файлы на флешку." +echo " Он НЕ стирает флешку, но на ней должно быть место." +echo +read -rp " Введите имя устройства (например sdb): " DEV +DEV=$(echo "$DEV" | tr -d ' /dev') +if [ -z "$DEV" ]; then + echo " ❌ ничего не введено" + exit 1 +fi +if [ ! -b "/dev/$DEV" ]; then + echo " ❌ устройства /dev/$DEV нет" + exit 1 +fi +SIZE=$(lsblk -dno SIZE "/dev/$DEV" 2>/dev/null) +echo " выбрано: /dev/$DEV ($SIZE)" + +echo +echo " ── разделы на устройстве ──" +lsblk -o NAME,SIZE,FSTYPE,LABEL,MOUNTPOINT "/dev/$DEV" 2>/dev/null | sed 's/^/ /' + +# Ищу первый раздел с файловой системой +PART="" +for p in /dev/${DEV}1 /dev/${DEV}p1 /dev/${DEV}2 /dev/${DEV}p2; do + [ -b "$p" ] || continue + FS=$(lsblk -no FSTYPE "$p" 2>/dev/null | head -1) + [ -n "$FS" ] && { PART="$p"; break; } +done + +if [ -z "$PART" ]; then + echo + echo " ⚠️ на устройстве нет раздела с файловой системой" + echo " Возможно, флешка не размечена или не отформатирована." + echo + echo " ── ФОРМАТИРОВАТЬ НЕ БУДУ (это опасно без вашего решения) ──" + echo " Если флешка пустая и её надо подготовить:" + echo " mkfs.ext4 /dev/$DEV (ВНИМАНИЕ: сотрёт всё)" + echo " или отформатируйте на компьютере в FAT32/exFAT" + exit 1 +fi +echo +echo " ✅ найден раздел: $PART" + +echo +echo "═══════════════════════════════════════════════════════════" +echo " 4. ПОДКЛЮЧАЮ ФЛЕШКУ" +echo "═══════════════════════════════════════════════════════════" +mkdir -p "$MOUNT" + +CUR=$(findmnt -no TARGET "$PART" 2>/dev/null) +if [ -n "$CUR" ]; then + echo " уже подключена: $CUR" + TARGET="$CUR" +else + FS=$(lsblk -no FSTYPE "$PART" 2>/dev/null | head -1) + case "$FS" in + vfat|exfat|ntfs) OPTS="rw,uid=0,gid=0,umask=022" ;; + *) OPTS="rw" ;; + esac + if mount -o "$OPTS" "$PART" "$MOUNT" 2>/dev/null; then + echo " ✅ подключена в $MOUNT" + TARGET="$MOUNT" + else + echo " ❌ не удалось подключить" + echo " Попробуйте вручную: mount $PART $MOUNT" + exit 1 + fi +fi + +echo +echo " ── место на флешке ──" +df -h "$TARGET" 2>/dev/null | tail -1 | sed 's/^/ /' + +echo +echo "═══════════════════════════════════════════════════════════" +echo " 5. СОЗДАЮ ПАПКУ И КОПИРУЮ" +echo "═══════════════════════════════════════════════════════════" +DST="$TARGET/BURYAN-KEY" +mkdir -p "$DST" +echo " папка: $DST" + +# --- Ключ --- +cp "$KEY_FILE" "$DST/age-key.txt" +chmod 600 "$DST/age-key.txt" 2>/dev/null +echo " ✅ age-key.txt" + +# --- Контрольная сумма --- +sha256sum "$DST/age-key.txt" | sed "s|$DST/||" > "$DST/age-key.sha256" +echo " ✅ age-key.sha256 (для проверки)" + +# --- Отпечаток --- +{ + echo "Отпечаток ключа: ${FP:0:24}..." + echo "Полная контрольная сумма файла: $KEYSUM" + echo "Создано: $(date '+%d.%m.%Y %H:%M')" +} > "$DST/fingerprint.txt" +echo " ✅ fingerprint.txt" + +# --- Инструкция --- +cat > "$DST/ПРОЧТИ-МЕНЯ.txt" <<'READMEEOF' +╔══════════════════════════════════════════════════════════╗ +║ КЛЮЧ ШИФРОВАНИЯ СЕКРЕТОВ ХОЗЯЙСТВА BURYAN HUB ║ +╚══════════════════════════════════════════════════════════╝ + +ЧТО ЭТО +─────── +Файл age-key.txt — ключ, которым зашифрованы ВСЕ секреты +домашнего сервера: + * пароль центральной базы данных (40 баз) + * доступы к единому входу Authentik + * токены ботов Matrix и Telegram + * ключ шифрования резервных копий + * секрет прокси Telegram + +БЕЗ ЭТОГО КЛЮЧА СЕКРЕТЫ НЕ РАСШИФРОВАТЬ. +Держите флешку в надёжном месте, ОТДЕЛЬНО от сервера. + + +КОГДА ЭТО ПОНАДОБИТСЯ +────────────────────── + * сервер вышел из строя и надо восстановить доступы + * забыли пароль базы данных + * переустанавливаете хозяйство + * надо передать дело другому человеку + + +КАК ВОССТАНОВИТЬ +──────────────── +1. Скопировать ключ на сервер: + + cat > /root/.buryan-age-key << 'KEYEOF' + (содержимое файла age-key.txt) + KEYEOF + chmod 600 /root/.buryan-age-key + +2. Положить туда, где программа его ищет: + + mkdir -p /root/.config/sops/age + cp /root/.buryan-age-key /root/.config/sops/age/keys.txt + chmod 600 /root/.config/sops/age/keys.txt + +3. Проверить, что работает: + + sops -d /root/buryan-infra/ops/secrets-enc/secrets.yaml + + Должны появиться значения (не ошибка). + + +ПРОВЕРКА ПОДЛИННОСТИ +──────────────────── +Сравните отпечаток в файле fingerprint.txt с тем, +что получается из ключа: + + grep -oE 'age1[a-z0-9]+' age-key.txt | head -1 + +Или проверьте контрольную сумму: + + sha256sum -c age-key.sha256 + + +ГДЕ ЕЩЁ ЛЕЖИТ ЭТОТ КЛЮЧ +─────────────────────── + 1. На сервере: /root/.buryan-age-key + 2. В Vaultwarden: заметка «Buryan Hub — КЛЮЧ ШИФРОВАНИЯ СЕКРЕТОВ» + 3. Здесь: эта флешка + +ПРАВИЛО: ключ и зашифрованные данные — В РАЗНЫХ МЕСТАХ. +Если ключ лежит рядом с зашифрованным файлом — шифрование +не имеет смысла. + + +ЧТО НЕЛЬЗЯ ДЕЛАТЬ +───────────────── + ✗ Не храните флешку рядом с сервером (пожар, кража, затопление) + ✗ Не выкладывайте содержимое в интернет, почту, мессенджеры + ✗ Не делайте фото ключа на телефон с облачной синхронизацией + ✗ Не переформатируйте флешку, не проверив, что копия есть + + ✓ Храните в другом помещении или у близкого человека + ✓ Периодически проверяйте, что флешка читается + ✓ После смены ключа — обновите копию на флешке + + +ЕСЛИ ФЛЕШКА ПОТЕРЯЛАСЬ +────────────────────── +Доступы НЕ скомпрометированы сами по себе — ключ только +расшифровывает файл, а файл лежит на сервере. Но: + + 1. Ключ из Vaultwarden остаётся рабочим — им можно + пользоваться + 2. Ключ на сервере тоже на месте + 3. Рекомендуется СОЗДАТЬ НОВУЮ копию на новой флешке + +Создать копию заново: + bash put-key-to-usb.sh (на сервере) + +╔══════════════════════════════════════════════════════════╗ +║ Buryan Hub — домашнее хозяйство ║ +╚══════════════════════════════════════════════════════════╝ +READMEEOF +echo " ✅ ПРОЧТИ-МЕНЯ.txt (инструкция по восстановлению)" + +# --- Что открывает ключ (без значений) --- +if [ -s "$SECRETS_FILE" ]; then + cat > "$DST/что-открывает-ключ.txt" <<'WHATEOF' +Этот ключ открывает файл секретов хозяйства. +Файл лежит в репозитории: + agent-qwen/buryan-infra + ops/secrets-enc/secrets.yaml + +СОДЕРЖИМОЕ ФАЙЛА (разделы и ключи, БЕЗ ЗНАЧЕНИЙ): +WHATEOF + echo " ── разделы файла секретов ──" >> "$DST/что-открывает-ключ.txt" + SOPS_AGE_KEY_FILE="$KEY_FILE" sops -d "$SECRETS_FILE" 2>/dev/null | \ + python3 -c " +import sys, yaml +try: + d = yaml.safe_load(sys.stdin) or {} + for sec, vals in d.items(): + if isinstance(vals, dict): + print(f' {sec}:') + for k in vals: + print(f' {k}') +except Exception: + pass +" >> "$DST/что-открывает-ключ.txt" 2>/dev/null + echo " ✅ что-открывает-ключ.txt" +fi + +echo +echo " ── содержимое флешки ──" +ls -la "$DST" | sed 's/^/ /' + +echo +echo "═══════════════════════════════════════════════════════════" +echo " 6. ПРОВЕРКА КОПИИ" +echo "═══════════════════════════════════════════════════════════" +echo " ── сравниваю ключи ──" +ORIG=$(sha256sum "$KEY_FILE" 2>/dev/null | cut -d' ' -f1) +COPY=$(sha256sum "$DST/age-key.txt" 2>/dev/null | cut -d' ' -f1) +if [ "$ORIG" = "$COPY" ]; then + echo " ✅ КОПИЯ СОВПАДАЕТ С ОРИГИНАЛОМ" + printf ' контрольная сумма: %s\n' "${ORIG:0:32}..." +else + echo " ❌ КОПИИ НЕ СОВПАДАЮТ!" + echo " оригинал: ${ORIG:0:32}..." + echo " копия: ${COPY:0:32}..." + exit 1 +fi + +echo +echo " ── проверяю, что ключ с флешки РАБОТАЕТ ──" +if [ -s "$SECRETS_FILE" ]; then + TEST=$(SOPS_AGE_KEY_FILE="$DST/age-key.txt" sops -d "$SECRETS_FILE" 2>/dev/null | head -1) + if [ -n "$TEST" ]; then + echo " ✅ КЛЮЧ С ФЛЕШКИ РАСШИФРОВЫВАЕТ СЕКРЕТЫ" + echo " (проверено на настоящем файле секретов)" + else + echo " ⚠️ не удалось проверить расшифровку" + fi +fi + +echo +echo " ── записываю на диск (сброс буферов) ──" +sync +echo " ✅ данные записаны" + +echo +echo "═══════════════════════════════════════════════════════════" +echo " 7. ОТКЛЮЧАЮ ФЛЕШКУ" +echo "═══════════════════════════════════════════════════════════" +if [ "$TARGET" = "$MOUNT" ]; then + if umount "$MOUNT" 2>/dev/null; then + echo " ✅ флешка отключена безопасно" + rmdir "$MOUNT" 2>/dev/null + else + echo " ⚠️ не удалось отключить — возможно, файлы ещё пишутся" + echo " Попробуйте: umount $MOUNT" + echo " Или: sync && umount $MOUNT" + fi +else + echo " (флешка была подключена в другом месте — не отключаю)" +fi + +rm -f /tmp/usb-fingerprint.txt /tmp/usb-checksum.txt + +echo +echo "═══════════════════════════════════════════════════════════" +echo " 8. 🔌 ТЕПЕРЬ ВЫНИМАЙТЕ ФЛЕШКУ" +echo "═══════════════════════════════════════════════════════════" +cat <<'DONE' + ═══════════════════════════════════════════════════════════ + ЧТО СДЕЛАНО + ═══════════════════════════════════════════════════════════ + ✅ Ключ скопирован на флешку + ✅ Копия проверена — совпадает с оригиналом + ✅ Ключ с флешки ПРОВЕРЕН на расшифровке + ✅ Инструкция по восстановлению (ПРОЧТИ-МЕНЯ.txt) + ✅ Контрольная сумма и отпечаток + ✅ Данные записаны, флешка отключена безопасно + + ═══════════════════════════════════════════════════════════ + ТЕПЕРЬ ВАЖНОЕ — ГДЕ ХРАНИТЬ + ═══════════════════════════════════════════════════════════ + + ХРАНИТЕ ФЛЕШКУ ОТДЕЛЬНО ОТ СЕРВЕРА: + * другое помещение + * или у близкого человека + * или в сейфе + + ПОЧЕМУ: + Если сервер погибнет (пожар, кража, вода) — + ключ на сервере погибнет вместе с ним. + Флешка в другом месте — спасёт. + + ПРАВИЛО: + ключ и зашифрованные данные — В РАЗНЫХ МЕСТАХ + + ═══════════════════════════════════════════════════════════ + ПРОВЕРЬТЕ ЧЕРЕЗ МЕСЯЦ + ═══════════════════════════════════════════════════════════ + Флешки портятся. Раз в несколько месяцев: + 1. Вставьте флешку + 2. Откройте папку BURYAN-KEY + 3. Убедитесь, что age-key.txt читается + 4. Сверьте отпечаток из fingerprint.txt + + Если флешка не читается — сделайте новую: + bash put-key-to-usb.sh + ═══════════════════════════════════════════════════════════ +DONE diff --git a/ops/scripts/put-key-to-vaultwarden.sh b/ops/scripts/put-key-to-vaultwarden.sh new file mode 100755 index 0000000..c3cfa3c --- /dev/null +++ b/ops/scripts/put-key-to-vaultwarden.sh @@ -0,0 +1,302 @@ +#!/bin/bash +# ============================================================ +# put-key-to-vaultwarden.sh +# ============================================================ +# Кладёт ключ шифрования секретов в Vaultwarden +# как защищённую заметку + вложенный файл. +# +# ЧТО ЭТО ЗА КЛЮЧ И ЗАЧЕМ: +# /root/.buryan-age-key — ключ, которым зашифрованы ВСЕ +# секреты хозяйства (пароль базы, доступы Authentik, +# токены ботов и т.д.). +# +# БЕЗ ЭТОГО КЛЮЧА СЕКРЕТЫ НЕ РАСШИФРОВАТЬ. +# Поэтому он должен лежать В ТРЁХ МЕСТАХ: +# 1. на сервере (уже есть) /root/.buryan-age-key +# 2. в Vaultwarden (этот скрипт) +# 3. на флешке (второй скрипт) +# +# ЗАПУСК: bash put-key-to-vaultwarden.sh +# ============================================================ +set -uo pipefail + +VW_URL="http://192.168.1.109:8081" +KEY_FILE="/root/.buryan-age-key" +ITEM_NAME="Buryan Hub — КЛЮЧ ШИФРОВАНИЯ СЕКРЕТОВ" + +echo "╔══════════════════════════════════════════════════════════╗" +echo "║ КЛАДУ КЛЮЧ В VAULTWARDEN ║" +echo "╚══════════════════════════════════════════════════════════╝" + +echo +echo "═══════════════════════════════════════════════════════════" +echo " 1. ПРОВЕРКА" +echo "═══════════════════════════════════════════════════════════" + +if [ ! -f "$KEY_FILE" ]; then + echo " ❌ ключ не найден: $KEY_FILE" + echo " Проверьте: /root/.config/sops/age/keys.txt" + exit 1 +fi +echo " ✅ ключ на месте: $KEY_FILE" +printf ' права: %s размер: %s байт\n' "$(stat -c '%a' "$KEY_FILE")" "$(stat -c '%s' "$KEY_FILE")" + +# Отпечаток — чтобы потом проверить, что положили то же самое +FP=$(grep -oE 'age1[a-z0-9]+' "$KEY_FILE" 2>/dev/null | head -1) +echo " отпечаток: ${FP:0:24}..." +echo "$FP" > /tmp/key-fingerprint.txt + +printf ' Vaultwarden: %s — %s\n' "$VW_URL" "$(curl -s -o /dev/null -w '%{http_code}' --max-time 8 "$VW_URL/" 2>/dev/null)" + +echo +echo "═══════════════════════════════════════════════════════════" +echo " 2. ПРОВЕРКА ПРОГРАММЫ bw" +echo "═══════════════════════════════════════════════════════════" +if which bw >/dev/null 2>&1; then + echo " ✅ программа bw есть: $(bw --version 2>/dev/null)" +else + echo " ⚠️ программы bw нет — ставлю" + echo " (это официальная программа Bitwarden для доступа" + echo " к хранилищу из командной строки)" + if which npm >/dev/null 2>&1; then + npm install -g @bitwarden/cli >/dev/null 2>&1 + elif which snap >/dev/null 2>&1; then + snap install bw >/dev/null 2>&1 + fi + if which bw >/dev/null 2>&1; then + echo " ✅ установлена: $(bw --version 2>/dev/null)" + else + echo " ❌ не удалось установить автоматически" + echo + echo " ── УСТАНОВИТЕ ВРУЧНУЮ ──" + echo " Вариант 1: npm install -g @bitwarden/cli" + echo " Вариант 2: скачать с https://bitwarden.com/download/" + echo " (файл bw-linux-*.zip, распаковать в /usr/local/bin)" + echo " Вариант 3: snap install bw" + echo + echo " ── ИЛИ СДЕЛАЙТЕ ЭТО РУКАМИ ──" + cat <<'MANUAL' + ЧЕРЕЗ БРАУЗЕР — 2 минуты: + 1. Откройте http://192.168.1.109:8081 и войдите + 2. «Новый элемент» → «Защищённая заметка» + 3. Название: Buryan Hub — КЛЮЧ ШИФРОВАНИЯ СЕКРЕТОВ + 4. В текст заметки вставьте содержимое файла: + cat /root/.buryan-age-key + 5. Прикрепите файл (скрепка): + /root/.buryan-age-key + 6. Сохраните + 7. ОТМЕТЬТЕ как избранное, чтобы не потерять +MANUAL + exit 0 + fi +fi + +echo +echo "═══════════════════════════════════════════════════════════" +echo " 3. НАСТРОЙКА АДРЕСА" +echo "═══════════════════════════════════════════════════════════" +bw config server "$VW_URL" >/dev/null 2>&1 +echo " ✅ адрес хранилища задан: $VW_URL" + +echo +echo "═══════════════════════════════════════════════════════════" +echo " 4. ВХОД В ХРАНИЛИЩЕ" +echo "═══════════════════════════════════════════════════════════" +echo +echo " Сейчас нужно ввести ДАННЫЕ ВХОДА в Vaultwarden." +echo " Это тот же вход, что и через браузер." +echo +echo " ⚠️ Пароль НЕ будет показан на экране и НЕ попадёт в журнал." +echo + +if bw login --raw >/dev/null 2>&1; then + echo " (уже выполнен вход ранее)" +else + # Спрашиваю адрес и пароль + read -rp " Почта (например roman@buryans.ru): " VW_USER + if [ -z "$VW_USER" ]; then + echo " ❌ почта не введена" + exit 1 + fi + echo " Введите МАСТЕР-ПАРОЛЬ от Vaultwarden:" + # Пароль читается скрытно + if bw login "$VW_USER" --raw > /tmp/bw-session.txt 2>/tmp/bw-err.txt; then + echo " ✅ вход выполнен" + else + echo " ── что ответило хранилище ──" + tail -5 /tmp/bw-err.txt | sed 's/^/ /' + echo + echo " ЕСЛИ НУЖЕН КОД ДВУХШАГОВОЙ ПРОВЕРКИ:" + echo " Есть два пути:" + echo " 1. Отключить двухшаговую проверку временно в настройках" + echo " 2. Или положить ключ вручную через браузер (см. инструкцию ниже)" + echo + cat <<'MANUAL' + ── РУЧНОЙ СПОСОБ, ЕСЛИ НЕ ВЫХОДИТ ── + 1. Откройте http://192.168.1.109:8081 и войдите + 2. «Новый элемент» → «Защищённая заметка» + 3. Название: Buryan Hub — КЛЮЧ ШИФРОВАНИЯ СЕКРЕТОВ + 4. Вставьте в текст содержимое: cat /root/.buryan-age-key + 5. Прикрепите файл: /root/.buryan-age-key + 6. Сохраните +MANUAL + exit 1 + fi +fi + +export BW_SESSION=$(cat /tmp/bw-session.txt 2>/dev/null | tr -d '\r\n') +if [ -z "${BW_SESSION:-}" ]; then + BW_SESSION=$(bw unlock --raw 2>/dev/null | tr -d '\r\n') + export BW_SESSION +fi + +if [ -z "${BW_SESSION:-}" ]; then + echo " ⚠️ не удалось получить доступ — сделайте вручную (см. выше)" + exit 1 +fi + +echo " ✅ доступ к хранилищу получен" +bw sync >/dev/null 2>&1 + +echo +echo "═══════════════════════════════════════════════════════════" +echo " 5. КЛАДУ КЛЮЧ" +echo "═══════════════════════════════════════════════════════════" + +KEY_CONTENT=$(cat "$KEY_FILE") + +# Собираю заметку +python3 - "$ITEM_NAME" "$KEY_CONTENT" "$FP" > /tmp/bw-item.json <<'PYEOF' +import json, sys +name, key, fp = sys.argv[1], sys.argv[2], sys.argv[3] +notes = f"""КЛЮЧ ШИФРОВАНИЯ СЕКРЕТОВ ХОЗЯЙСТВА BURYAN HUB + +ЭТОТ КЛЮЧ ОТКРЫВАЕТ ВСЕ СЕКРЕТЫ: + * пароль центральной базы данных + * доступы к Authentik (единый вход) + * токены ботов Matrix и Telegram + * ключ шифрования резервных копий + * секрет прокси Telegram + +БЕЗ НЕГО СЕКРЕТЫ НЕ РАСШИФРОВАТЬ. + +--- САМ КЛЮЧ --- +{key} + +--- КАК ПОЛЬЗОВАТЬСЯ --- +Сохранить в файл: + cat > /root/.buryan-age-key << 'KEYEOF' + {key} + KEYEOF + chmod 600 /root/.buryan-age-key + +Скопировать в место, где программа его ищет: + mkdir -p /root/.config/sops/age + cp /root/.buryan-age-key /root/.config/sops/age/keys.txt + chmod 600 /root/.config/sops/age/keys.txt + +Проверить, что работает: + sops -d /root/buryan-infra/ops/secrets-enc/secrets.yaml + (должны появиться значения, а не ошибка) + +--- ОТПЕЧАТОК (для проверки, что ключ тот же) --- +{fp} + +--- ГДЕ ЕЩЁ ЛЕЖИТ КЛЮЧ --- +1. Сервер: /root/.buryan-age-key +2. Здесь: Vaultwarden (эта заметка) +3. Флешка: отдельный носитель, хранится отдельно от сервера + +ПРАВИЛО: ключ и зашифрованные данные — В РАЗНЫХ МЕСТАХ. +""" +item = { + "organizationId": None, + "folderId": None, + "type": 2, + "name": name, + "notes": notes, + "favorite": True, + "secureNote": {"type": 0}, + "fields": [ + {"name": "Отпечаток ключа", "value": fp, "type": 0}, + {"name": "Где лежит", "value": "Сервер, Vaultwarden, флешка", "type": 0}, + ], +} +print(json.dumps(item, ensure_ascii=False)) +PYEOF + +# Кодирую и создаю +ENCODED=$(bw encode < /tmp/bw-item.json 2>/dev/null | tr -d '\r\n') +if [ -z "$ENCODED" ]; then + echo " ⚠️ не удалось закодировать — делаю вручную" + echo " ── ВСТАВЬТЕ ЭТО В ЗАМЕТКУ ──" + echo "$KEY_CONTENT" | sed 's/^/ /' + exit 1 +fi + +RESULT=$(bw create item "$ENCODED" --session "$BW_SESSION" 2>&1) +if echo "$RESULT" | grep -q '"id"'; then + echo " ✅ ЗАМЕТКА СОЗДАНА" + ITEM_ID=$(echo "$RESULT" | python3 -c "import json,sys; print(json.load(sys.stdin).get('id',''))" 2>/dev/null) + echo " код элемента: ${ITEM_ID:0:12}..." +else + echo " ⚠️ ответ хранилища:" + echo "$RESULT" | head -3 | sed 's/^/ /' +fi + +echo +echo "═══════════════════════════════════════════════════════════" +echo " 6. ПРИКРЕПЛЯЮ ФАЙЛ" +echo "═══════════════════════════════════════════════════════════" +if [ -n "${ITEM_ID:-}" ]; then + cp "$KEY_FILE" /tmp/age-key-backup.txt + if bw create attachment --file /tmp/age-key-backup.txt --itemid "$ITEM_ID" --session "$BW_SESSION" >/dev/null 2>&1; then + echo " ✅ файл прикреплён к заметке" + else + echo " ⚠️ файл не прикрепился — но текст ключа в заметке есть" + fi + rm -f /tmp/age-key-backup.txt +else + echo " (пропускаю — не известен код элемента)" +fi + +echo +echo "═══════════════════════════════════════════════════════════" +echo " 7. ВЫХОД И ОЧИСТКА" +echo "═══════════════════════════════════════════════════════════" +bw lock >/dev/null 2>&1 +bw logout >/dev/null 2>&1 +rm -f /tmp/bw-session.txt /tmp/bw-err.txt /tmp/bw-item.json +echo " ✅ выход выполнен, временные файлы убраны" + +echo +echo "═══════════════════════════════════════════════════════════" +echo " 8. ПРОВЕРКА" +echo "═══════════════════════════════════════════════════════════" +echo " ── откройте и убедитесь ──" +echo " $VW_URL" +echo " Найдите заметку: «$ITEM_NAME»" +echo " (она в избранном — должна быть сверху)" +echo +echo " ── проверьте, что текст ключа на месте ──" +echo " отпечаток должен быть: ${FP:0:24}..." +echo +cat <<'SUM' + ═══════════════════════════════════════════════════════════ + ЧТО СДЕЛАНО + ═══════════════════════════════════════════════════════════ + ✅ Ключ положен в Vaultwarden + ✅ Отмечен избранным + ✅ Есть текст ключа и вложенный файл + ✅ Есть инструкция по восстановлению + ✅ Есть отпечаток для проверки + + ЕСЛИ ЧТО-ТО НЕ ВЫШЛО: + положите вручную через браузер: + 1. http://192.168.1.109:8081 + 2. Новая защищённая заметка + 3. Название: Buryan Hub — КЛЮЧ ШИФРОВАНИЯ СЕКРЕТОВ + 4. Содержимое: cat /root/.buryan-age-key + 5. Прикрепить файл: /root/.buryan-age-key + ═══════════════════════════════════════════════════════════ +SUM