Files
buryan-infra/docs/AGE-KEY-AND-RESTORE.md
T
root f9e46ab664 Ключ 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
приватной комнаты: проверка совпадала сама с собой.
2026-10-17 11:16:32 +03:00

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 (его можно показывать — он только для шифрования). Секретный — только у владельца.

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

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

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