Задача №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 приватной комнаты: проверка совпадала сама с собой.
4.4 KiB
Ключ шифрования копий (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
(его можно показывать — он только для шифрования).
Секретный — только у владельца.
Где ключ должен жить
По правилу из аудита — ключ и данные в разных местах:
- на сервере:
/root/.buryan-age-key, права600(работает сейчас); - в Vaultwarden — защищённой заметкой (делает владелец);
- на флешке, отдельно от компьютера.
Почему не в Git: именно затем ключ и вынесен отдельно, чтобы утечка репозитория не открыла копии.
Проверка «ключ годен», а не «ключ есть»
Ключ, в котором один символ неверен, выглядит нормально и обнаруживается только в момент восстановления — то есть когда уже поздно. Поэтому есть скрипт:
bash ops/vpn/verify-age-key.sh
Он проверяет:
- ключ на месте и права
600; - секретный ключ ровно один;
- публичный ключ совпадает с тем, на который шифровали (
.sops.yaml); - копии действительно расшифровываются, и внутри есть ключи клиентов;
- ключа нет ни в файлах репозитория, ни в истории Git;
- копии есть на другом хосте.
Результат на 17.10.2026: ключ годен, копии расшифровываются (40 и 30 ключей клиентов), в Git нет, на VPS 2 копии.
Восстановление
# проверка, ничего не меняет
bash ops/vpn/vpn-restore-config.sh
# записать на VPS и перезапустить
bash ops/vpn/vpn-restore-config.sh --apply
Или вручную:
sops --decrypt ops/secrets-enc/vpn-configs.json > /tmp/restored.json
Почему ключ не добавил я сам
Vaultwarden хранит записи зашифрованными, и шифрует их клиент мастер- паролем. Мастер-пароля у меня нет — и это правильно. Добавить запись программно можно только с мастер-паролем или личным ключом API; просить их я не буду.
Поэтому файл с ключом и пошаговой инструкцией подготовлен и передан владельцу. Записать в Vaultwarden и на флешку — его действие.
Грабли (мои, чтобы не повторялись)
Проверка нашла саму себя. Скрипт искал в репозитории строку
AGE-SECRET-KEY-1, а эта строка есть в нём же как образец для поиска —
получилось ложное «ключ попал в репозиторий». Искать надо конкретное
значение ключа, а не его начало. Исправлено.
Это тот же класс ошибки, что уже был с URL приватной комнаты: проверка совпадала сама с собой.