Безопасность, Криптография и GitOps
Starry реализует бескомпромиссную модель безопасности: конфигурационные файлы кластера могут безопасно храниться в публичных Git-репозиториях, так как все чувствительные данные зашифрованы с использованием алгоритма AES-256-GCM с обязательной контекстной привязкой AAD (Additional Authenticated Data).
1. Контекстная привязка AAD: Защита от Cut-and-Paste атак
Классическая проблема зашифрованных секретов в Git — возможность злоумышленника или невнимательного оператора скопировать зашифрованную строку из одного поля в другое (например, подменить пароль непривилегированного пользователя значением SSH-ключа root).
В Starry каждое значение шифруется с привязкой к каноническому JSON-пути поля в конфигурационном дереве:
- Секрет для поля
nodes.bocchi.ssh_keyшифруется сAAD = "nodes.bocchi.ssh_key" - При попытке перенести этот зашифрованный блок в поле
services.api.db_password, расшифровка завершится с ошибкойCryptographicExceptionиз-за несовпадения тега аутентификации!
2. Форматы секретов в конфигурации
Открытые секреты (PLAIN[...])
При подготовке изменений разработчик может записать секрет в открытом виде:
nodes:
bocchi:
host: "192.168.1.10"
ssh_key: "PLAIN[-----BEGIN OPENSSH PRIVATE KEY-----...]"При запуске команды starry encrypt Starry автоматически обнаруживает все открытые секреты, заменяет их на зашифрованные и сохраняет файлы:
starry encrypt --key $STARRY_MASTER_KEY ./clusterЗашифрованные секреты (ENC[...])
Результат шифрования записывается в компактном конвертном формате:
ENC[AES256_GCM:v1:<base64_nonce>:<base64_cipher>:<base64_tag>]3. Регулярная ротация Мастер-Ключа в GitHub Actions
Для соответствия строгим стандартам безопасности рекомендуется регулярно (например, ежемесячно) производить полную перешифровку всех секретов новым мастер-ключом.
Starry автоматизирует этот процесс одной командой:
starry encrypt global --reencrypt \
--old-key-env STARRY_MASTER_KEY_OLD \
--new-key-env STARRY_MASTER_KEY_NEW \
--allow-config-edit \
--git-commit \
--git-push \
--update-github-secret STARRY_MASTER_KEYЭта команда:
- Рекурсивно сканирует все конфигурационные файлы (
.yaml,.json,.toml). - Расшифровывает старым ключом, валидируя AAD каждого поля.
- Шифрует новым ключом со свежим криптографическим Nonce на каждое поле.
- Транзакционно перезаписывает файлы через временный файл (
temp-file rename). - Создает Git-коммит и пушит его в репозиторий.
- Обновляет секрет
STARRY_MASTER_KEYв GitHub Actions черезgh secret set.