Files
buryan-infra/docs/AGE-KEY-AND-RESTORE.md
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

101 lines
5.4 KiB
Markdown

# Ключ шифрования копий (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
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 приватной комнаты: проверка
совпадала сама с собой.