Skip to content

Безопасность, Криптография и 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[...]) ​

При подготовке изменений разработчик может записать секрет в открытом виде:

yaml
nodes:
  bocchi:
    host: "192.168.1.10"
    ssh_key: "PLAIN[-----BEGIN OPENSSH PRIVATE KEY-----...]"

При запуске команды starry encrypt Starry автоматически обнаруживает все открытые секреты, заменяет их на зашифрованные и сохраняет файлы:

bash
starry encrypt --key $STARRY_MASTER_KEY ./cluster

Зашифрованные секреты (ENC[...]) ​

Результат шифрования записывается в компактном конвертном формате:

text
ENC[AES256_GCM:v1:<base64_nonce>:<base64_cipher>:<base64_tag>]

3. Регулярная ротация Мастер-Ключа в GitHub Actions ​

Для соответствия строгим стандартам безопасности рекомендуется регулярно (например, ежемесячно) производить полную перешифровку всех секретов новым мастер-ключом.

Starry автоматизирует этот процесс одной командой:

bash
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

Эта команда:

  1. Рекурсивно сканирует все конфигурационные файлы (.yaml, .json, .toml).
  2. Расшифровывает старым ключом, валидируя AAD каждого поля.
  3. Шифрует новым ключом со свежим криптографическим Nonce на каждое поле.
  4. Транзакционно перезаписывает файлы через временный файл (temp-file rename).
  5. Создает Git-коммит и пушит его в репозиторий.
  6. Обновляет секрет STARRY_MASTER_KEY в GitHub Actions через gh secret set.

Released under the MIT License.