Владелец спросил, про что задача 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 наравне с остальными — это отдельный пункт реестра, добавлю по его слову.
101 lines
5.4 KiB
Markdown
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 приватной комнаты: проверка
|
|
совпадала сама с собой.
|