Ключ 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 приватной комнаты: проверка совпадала сама с собой.
This commit is contained in:
1 parent
c6d006a509
commit
f9e46ab664
3 files changed
+227
No files matched your search
@@ -0,0 +1,87 @@
|
||||
# Ключ шифрования копий (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
|
||||
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 приватной комнаты: проверка
|
||||
совпадала сама с собой.
|
||||
@@ -86,6 +86,7 @@
|
||||
| 1.7 | Выдать готовые профили с раздельной маршрутизацией | ✅ доставлено и проверено |
|
||||
| 1.6 | Выдача доступа новому человеку одной командой админа | ✅ `!vpn give @логин` |
|
||||
| 1.5 | Разместить ссылки в Vaultwarden | ⬜ |
|
||||
| 1.8 | **Ключ age**: файл с ключом и инструкцией передан владельцу | 🔶 ждёт записи в Vaultwarden и на флешку |
|
||||
|
||||
### Этап 2. Больше протоколов
|
||||
|
||||
|
||||
Reference in new issue
Block a user