Ключ age: проверка годности, документация, файл для владельца

Задача №22 аудита. Суть не в «положить в Vaultwarden», а в том, что без
ключа зашифрованные копии бесполезны: файл есть, прочитать нечем.

ЧТО СДЕЛАНО:
* добавлен ops/vpn/verify-age-key.sh — проверка «ключ ГОДЕН», а не
  «ключ есть». Ошибка в одном символе иначе обнаружится только в момент
  восстановления, когда уже поздно. Скрипт проверяет: ключ на месте и с
  правами 600; секретный ключ ровно один; публичный совпадает с тем, на
  который шифровали; копии ДЕЙСТВИТЕЛЬНО расшифровываются; ключа нет в
  файлах и в истории Git; копии есть на другом хосте;
* docs/AGE-KEY-AND-RESTORE.md — что ключ открывает, где должен жить
  (сервер + Vaultwarden + флешка, ключ отдельно от данных), как
  восстановить;
* файл с ключом и пошаговой инструкцией подготовлен и передан владельцу
  для скачивания.

РЕЗУЛЬТАТ ПРОВЕРКИ: ключ годен. Расшифровываются обе копии —
vpn-configs.json (40 ключей клиентов) и xray-config.json (30). Права 600.
Публичный ключ совпадает с .sops.yaml. В Git ключа нет: ни в файлах, ни
в истории коммитов. На VPS лежат 2 зашифрованные копии.

ПОЧЕМУ КЛЮЧ НЕ ДОБАВЛЕН В VAULTWARDEN МНОЮ: Vaultwarden шифрует записи
клиентским мастер-паролем. Мастер-пароля у меня нет — и это правильно.
Добавить запись программно можно только с ним или с личным ключом API;
просить их я не буду. Записать в Vaultwarden и на флешку — действие
владельца.

ГРАБЛИ (мои): проверка нашла саму себя. Скрипт искал строку
AGE-SECRET-KEY-1, а она есть в нём же как образец для поиска — вышло
ложное «ключ попал в репозиторий». Искать надо КОНКРЕТНОЕ значение
ключа, а не его начало. Исправлено. Тот же класс ошибки уже был с URL
приватной комнаты: проверка совпадала сама с собой.
This commit is contained in:
root committed 2026-10-17 11:16:32 +03:00
1 parent c6d006a509
commit f9e46ab664
3 files changed
+227

No files matched your search

+87
View File
@@ -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 приватной комнаты: проверка
совпадала сама с собой.
+1
View File
@@ -86,6 +86,7 @@
| 1.7 | Выдать готовые профили с раздельной маршрутизацией | ✅ доставлено и проверено |
| 1.6 | Выдача доступа новому человеку одной командой админа | ✅ `!vpn give @логин` |
| 1.5 | Разместить ссылки в Vaultwarden | ⬜ |
| 1.8 | **Ключ age**: файл с ключом и инструкцией передан владельцу | 🔶 ждёт записи в Vaultwarden и на флешку |
### Этап 2. Больше протоколов
+139
View File
@@ -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 "============================================================"