diff --git a/docs/AGE-KEY-AND-RESTORE.md b/docs/AGE-KEY-AND-RESTORE.md new file mode 100644 index 0000000..10cf81b --- /dev/null +++ b/docs/AGE-KEY-AND-RESTORE.md @@ -0,0 +1,87 @@ +# Ключ шифрования копий (age) и восстановление + +**Задача №22 аудита.** Она выглядела как «положить ключ в Vaultwarden и +на флешку», но по сути это про другое: **без ключа зашифрованные копии +бесполезны**. Файл есть, а прочитать его нечем. + +## Что открывает ключ + +| Файл | Что внутри | +|---|---| +| `ops/secrets-enc/xray-config.json` | конфигурация xray — 30 ключей клиентов | +| `ops/secrets-enc/vpn-configs.json` | xray (40 ключей) + конфигурация Hysteria2 | +| `/root/vpn-configs-encrypted.json` на VPS | копия на другом хосте | +| `/root/xray-config-encrypted.json` на VPS | копия на другом хосте | + +Публичный ключ: `age197n2mdprtp43fshumeph2gmllhwudsegh7pqsynkgxwf67gd94zqhnsedp` +(его можно показывать — он только для шифрования). +Секретный — только у владельца. + +## Где ключ должен жить + +По правилу из аудита — **ключ и данные в разных местах**: + +1. на сервере: `/root/.buryan-age-key`, права `600` (работает сейчас); +2. в **Vaultwarden** — защищённой заметкой (делает владелец); +3. на **флешке**, отдельно от компьютера. + +Почему не в Git: именно затем ключ и вынесен отдельно, чтобы утечка +репозитория не открыла копии. + +## Проверка «ключ годен», а не «ключ есть» + +Ключ, в котором один символ неверен, выглядит нормально и обнаруживается +только в момент восстановления — то есть когда уже поздно. Поэтому есть +скрипт: + +```bash +bash ops/vpn/verify-age-key.sh +``` + +Он проверяет: + +* ключ на месте и права `600`; +* секретный ключ ровно один; +* публичный ключ совпадает с тем, на который шифровали (`.sops.yaml`); +* копии **действительно расшифровываются**, и внутри есть ключи клиентов; +* ключа нет ни в файлах репозитория, ни в истории Git; +* копии есть на другом хосте. + +Результат на 17.10.2026: ключ годен, копии расшифровываются +(40 и 30 ключей клиентов), в Git нет, на VPS 2 копии. + +## Восстановление + +```bash +# проверка, ничего не меняет +bash ops/vpn/vpn-restore-config.sh + +# записать на VPS и перезапустить +bash ops/vpn/vpn-restore-config.sh --apply +``` + +Или вручную: + +```bash +sops --decrypt ops/secrets-enc/vpn-configs.json > /tmp/restored.json +``` + +## Почему ключ не добавил я сам + +Vaultwarden хранит записи зашифрованными, и шифрует их **клиент мастер- +паролем**. Мастер-пароля у меня нет — и это правильно. Добавить запись +программно можно только с мастер-паролем или личным ключом API; просить +их я не буду. + +Поэтому файл с ключом и пошаговой инструкцией подготовлен и передан +владельцу. Записать в Vaultwarden и на флешку — его действие. + +## Грабли (мои, чтобы не повторялись) + +**Проверка нашла саму себя.** Скрипт искал в репозитории строку +`AGE-SECRET-KEY-1`, а эта строка есть в нём же как образец для поиска — +получилось ложное «ключ попал в репозиторий». Искать надо **конкретное +значение** ключа, а не его начало. Исправлено. + +Это тот же класс ошибки, что уже был с URL приватной комнаты: проверка +совпадала сама с собой. diff --git a/docs/TASKS.md b/docs/TASKS.md index 8fb7ce4..5196258 100644 --- a/docs/TASKS.md +++ b/docs/TASKS.md @@ -86,6 +86,7 @@ | 1.7 | Выдать готовые профили с раздельной маршрутизацией | ✅ доставлено и проверено | | 1.6 | Выдача доступа новому человеку одной командой админа | ✅ `!vpn give @логин` | | 1.5 | Разместить ссылки в Vaultwarden | ⬜ | +| 1.8 | **Ключ age**: файл с ключом и инструкцией передан владельцу | 🔶 ждёт записи в Vaultwarden и на флешку | ### Этап 2. Больше протоколов diff --git a/ops/vpn/verify-age-key.sh b/ops/vpn/verify-age-key.sh new file mode 100755 index 0000000..bd29d91 --- /dev/null +++ b/ops/vpn/verify-age-key.sh @@ -0,0 +1,139 @@ +#!/bin/bash +# ============================================================ +# verify-age-key.sh — проверка, что ключ шифрования годен +# ============================================================ +# ЗАЧЕМ. Ключ, который «есть», и ключ, который «работает» — разные вещи. +# Ошибка в одном символе обнаруживается только в момент восстановления, +# то есть тогда, когда уже поздно. +# +# Этот скрипт проверяет ЗАРАНЕЕ: +# 1. ключ лежит там, где его ищет sops; +# 2. права правильные (600, иначе ключ могут прочитать другие); +# 3. ключ ДЕЙСТВИТЕЛЬНО расшифровывает наши копии; +# 4. внутри копий есть ожидаемое содержимое (ключи клиентов); +# 5. совпадает ли публичный ключ с тем, на который шифровали. +# +# Запуск: bash verify-age-key.sh +# ============================================================ +set -uo pipefail + +KEY=/root/.buryan-age-key +REPO=/root/buryan-infra +ENC="$REPO/ops/secrets-enc" +FAIL=0 + +echo "=== 1. КЛЮЧ НА МЕСТЕ ===" +if [ ! -f "$KEY" ]; then + echo " ОШИБКА: нет $KEY" + echo " Ключ должен лежать здесь. Он есть в Vaultwarden и на флешке." + exit 1 +fi +echo " $KEY" + +echo +echo "=== 2. ПРАВА ===" +PERM=$(stat -c '%a' "$KEY") +if [ "$PERM" = "600" ]; then + echo " права $PERM — верно (читает только владелец)" +else + echo " ВНИМАНИЕ: права $PERM, должно быть 600" + echo " исправляю: chmod 600 $KEY" + chmod 600 "$KEY" + FAIL=1 +fi + +echo +echo "=== 3. ФОРМАТ И ПУБЛИЧНЫЙ КЛЮЧ ===" +PUBFILE=$(grep '^# public key:' "$KEY" | sed 's/# public key: *//') +SECRETS=$(grep -c '^AGE-SECRET-KEY-1' "$KEY" || true) +echo " строк с секретным ключом: $SECRETS (должна быть 1)" +echo " публичный ключ в файле: ${PUBFILE:0:24}..." +if [ "$SECRETS" -ne 1 ]; then + echo " ОШИБКА: секретных ключей не один" + FAIL=1 +fi + +echo +echo "=== 4. ПУБЛИЧНЫЙ КЛЮЧ СОВПАДАЕТ С ШИФРОВАНИЕМ ===" +if [ -f "$REPO/.sops.yaml" ]; then + CONF=$(grep -o 'age1[a-z0-9]*' "$REPO/.sops.yaml" | head -1) + echo " в .sops.yaml: ${CONF:0:24}..." + if [ "$CONF" = "$PUBFILE" ]; then + echo " совпадает" + else + echo " НЕ СОВПАДАЕТ — этим ключом новые копии шифроваться не будут" + FAIL=1 + fi +fi + +echo +echo "=== 5. ГЛАВНОЕ: РАСШИФРОВЫВАЕТ ЛИ КОПИИ ===" +shopt -s nullglob +FILES=("$ENC"/*.json) +if [ ${#FILES[@]} -eq 0 ]; then + echo " копий нет в $ENC" + FAIL=1 +fi +for f in "${FILES[@]}"; do + name=$(basename "$f") + if out=$(sops --decrypt "$f" 2>&1); then + # считаю ключи клиентов в том, что получилось + cnt=$(echo "$out" | python3 -c " +import json, sys +try: + d = json.load(sys.stdin) +except Exception: + print('-') + sys.exit() +def count(o): + n = 0 + if isinstance(o, dict): + for c in o.get('inbounds', []): + n += len(c.get('settings', {}).get('clients', [])) + for v in o.values(): + if isinstance(v, dict): + n += count(v) + return n +print(count(d)) +" 2>/dev/null) + echo " $name: расшифровался, ключей клиентов внутри: $cnt" + [ "$cnt" = "0" ] && echo " (0 может быть нормой, если это копия без клиентов)" + else + echo " $name: ОШИБКА РАСШИФРОВКИ" + echo "$out" | head -2 | sed 's/^/ /' + FAIL=1 + fi +done + +echo +echo "=== 6. КЛЮЧА НЕТ В GIT ===" +# ВАЖНО: искать надо КОНКРЕТНОЕ значение ключа, а не начало строки. +# Иначе проверка находит саму себя: в этом файле есть образец +# «AGE-SECRET-KEY-1» для поиска, и это даёт ложную тревогу. +# На этих граблях я уже стоял. +SECRET=$(grep '^AGE-SECRET-KEY-1' "$KEY" | head -1) +n=$(grep -rlF "$SECRET" "$REPO" 2>/dev/null | wc -l) +h=$(git -C "$REPO" log --all --oneline -S "$SECRET" 2>/dev/null | wc -l) +echo " файлов в репозитории: $n, коммитов в истории: $h" +if [ "$n" -ne 0 ] || [ "$h" -ne 0 ]; then + echo " ВНИМАНИЕ: ключ попал в репозиторий или историю" + FAIL=1 +fi + +echo +echo "=== 7. КОПИИ ВНЕ ЭТОГО ХОСТА ===" +for remote in 193.233.210.184; do + got=$(ssh -o BatchMode=yes -o ConnectTimeout=8 root@$remote \ + 'ls /root/*encrypted*.json 2>/dev/null | wc -l' 2>/dev/null | tr -d '\r') + echo " на $remote: файлов копий ${got:-?}" +done + +echo +echo "============================================================" +if [ "$FAIL" -eq 0 ]; then + echo " КЛЮЧ ГОДЕН: копии расшифровываются, права верные," + echo " в Git ключа нет." +else + echo " ЕСТЬ ЗАМЕЧАНИЯ — смотрите ВНИМАНИЕ и ОШИБКА выше." +fi +echo "============================================================"