Files
buryan-infra/ops/scripts/KEY-BACKUP-HOWTO.md
T

4.1 KiB

Куда положить ключ шифрования секретов

Ключ: /root/.buryan-age-key

Без него секреты не расшифровать. Поэтому он должен лежать в трёх местах.

Три места

# Где Как Состояние
1 Сервер уже лежит готово
2 Vaultwarden bash put-key-to-vaultwarden.sh надо сделать
3 Флешка bash put-key-to-usb.sh надо сделать

Правило: ключ и зашифрованные данные — В РАЗНЫХ МЕСТАХ. Если ключ лежит рядом с зашифрованным файлом, шифрование не имеет смысла.

Скрипт 1: в Vaultwarden

bash /root/put-key-to-vaultwarden.sh

Что делает:

1. Проверяет ключ
2. Ставит программу bw, если её нет
3. Спрашивает почту и мастер-пароль (скрытно, не в журнал)
4. Создаёт защищённую заметку в избранном:
     Бурян Хаб - КЛЮЧ ШИФРОВАНИЯ СЕКРЕТОВ
5. Внутри: сам ключ + инструкция по восстановлению + отпечаток
6. Прикрепляет файл ключа
7. Выходит из хранилища, убирает временные файлы

Если не выйдет (двухшаговая проверка и подобное) — скрипт покажет ручную инструкцию через браузер.

Скрипт 2: на флешку

bash /root/put-key-to-usb.sh

Что делает:

1. Показывает все съёмные устройства
2. Спрашивает, какое использовать
3. Подключает, НЕ форматирует
4. Копирует в папку BURYAN-KEY:
     age-key.txt              - сам ключ
     age-key.sha256           - контрольная сумма
     fingerprint.txt          - отпечаток
     ПРОЧТИ-МЕНЯ.txt          - инструкция по восстановлению
     что-открывает-ключ.txt   - какие секреты открывает
5. СВЕРЯЕТ копию с оригиналом
6. ПРОВЕРЯЕТ, что ключ с флешки реально расшифровывает секреты
7. Записывает на диск и отключает безопасно

Флешка становится самодостаточной: на ней и ключ, и инструкция, и проверка подлинности.

Где хранить флешку

НЕ рядом с сервером (пожар, кража, вода - погибнут вместе)
ДА - другое помещение
ДА - у близкого человека
ДА - в сейфе

Если сервер погибнет - ключ на сервере погибнет тоже.
Флешка в другом месте спасёт доступы.

Проверять раз в несколько месяцев

Флешки портятся. Периодически:

1. Вставить флешку
2. Открыть папку BURYAN-KEY
3. Убедиться, что age-key.txt читается
4. Сверить отпечаток с fingerprint.txt

Если не читается — сделать новую копию.

Проверка, что ключ работает

sops -d /root/buryan-infra/ops/secrets-enc/secrets.yaml

Должны появиться значения (не ошибка).

Если ключ потерян ВЕЗДЕ

Тогда секреты не восстановить. Придётся:

1. Сменить пароль базы
2. Перевыпустить доступы Authentik
3. Перевыпустить токены ботов
4. Создать новый ключ шифрования

Поэтому три копии — не избыточность, а необходимость.