Files
buryan-infra/docs/AGE-KEY-AND-RESTORE.md
T
root 00f27eccbc Ключ age: уточнён охват — он защищает ВСЕ секреты, а не только VPN
Владелец спросил, про что задача 22, и это вскрыло мою неточность.

ЧТО ПРОВЕРЕНО ПО ДОКУМЕНТУ. Задача 22 в аудите — именно ключ age:
  «| 22 | Поручение: ключ age в Vaultwarden | ВАШЕ |»
  «| 22 | Ключ age → в Vaultwarden и на флешку | Без него секреты не восстановить |»
Отдельной задачи про пароль PVE в аудите НЕТ.

ГДЕ Я БЫЛ НЕТОЧЕН. Я описал ключ как «ключ к копиям VPN». На самом деле
он открывает secrets.yaml, где 8 секретов:
  database.password, backup.restic_password, authentik.api_token,
  vpn.mtg_secret, notify.matrix_token + адрес, порт, пользователь базы.

Разница принципиальная: потеря ключа означает потерю не только VPN, но и
пароля базы и ключа резервных копий. То есть без него не восстановить
почти ничего.

ИСПРАВЛЕНО:
* verify-age-key.sh теперь проверяет и secrets.yaml (расшифровывается,
  внутри 8 секретов), а не только .json-копии;
* docs/AGE-KEY-AND-RESTORE.md — охват описан верно, добавлен раздел про
  то, что ключ НЕ имеет отношения к паролю root на PVE;
* файл для владельца переименован в AGE-КЛЮЧ-все-секреты.txt и
  переписан: перечислено всё, что ключ открывает, включая пароль базы и
  ключ копий.

Результат проверки после правки: secrets.yaml расшифровывается (8
секретов), копии VPN расшифровываются (40 и 30 ключей), права 600, в Git
ключа нет.

Если владелец захочет вести пароль PVE наравне с остальными — это
отдельный пункт реестра, добавлю по его слову.
2026-10-17 11:31:09 +03:00

5.4 KiB

Ключ шифрования копий (age) и восстановление

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

Что открывает ключ

Не только VPN. Это главный ключ ко всем секретам хозяйства.

Файл Что внутри
ops/secrets-enc/secrets.yaml 8 секретов: пароль базы, ключ копий restic, токен Authentik, секрет Telegram-прокси, токен уведомлений, адрес/порт/пользователь базы
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 копия на другом хосте

Почему это важно. Потеря ключа означает потерю не только доступа к VPN, но и пароля базы и ключа резервных копий. То есть без него не восстановить почти ничего.

Про пароль PVE

Ключ age не имеет отношения к паролю root на самом PVE (192.168.1.10). Это отдельная вещь, и в поручениях аудита такой задачи нет. Если её нужно вести наравне — это отдельный пункт реестра.

Публичный ключ: age197n2mdprtp43fshumeph2gmllhwudsegh7pqsynkgxwf67gd94zqhnsedp (его можно показывать — он только для шифрования). Секретный — только у владельца.

Где ключ должен жить

По правилу из аудита — ключ и данные в разных местах:

  1. на сервере: /root/.buryan-age-key, права 600 (работает сейчас);
  2. в Vaultwarden — защищённой заметкой (делает владелец);
  3. на флешке, отдельно от компьютера.

Почему не в 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 приватной комнаты: проверка совпадала сама с собой.