Секреты
ECOS Секрет — объект, содержащий конфиденциальные данные, такие как пароль, токен или ключ.
Расположение артефактов с данным типом: model/secret
Модель конфигурации:
id: String # идентификатор секрета
name: MLText # локализованное название
type: String # тип секрета: BASIC, TOKEN или CERTIFICATE
data: ObjectData # данные секрета. Полностью зависят от типа
Обычное чтение записи секрета через Records API возвращает описание без содержимого data. Для получения данных в коде используйте API EcosSecrets. При обновлении определения пустое или отсутствующее data сохраняет прежние данные; замена выполняется при передаче непустого объекта.
Типы секретов:
Тип |
Содержимое поля data |
|---|---|
BASIC |
username: String
password: String
|
TOKEN |
token: String
|
CERTIFICATE |
privateKey: String
certificate: String
|
Пример конфигурации:
---
id: content-storage-s3-credentials
name:
ru: Ключи доступа к API S3 хранилища
en: S3 storage API Keys
type: BASIC
data:
username: sMJjtYPxFGjPEKeFp1lC
password: KenKpEhD6Lag3acImDAq2ZeLtlSij1vyaYZt8lyH
Информация о секретах по умолчанию хранится и загружается из БД микросервиса ecos-model, но также есть возможность указать настройки через переменные среды. Для этого следует взять идентификатор секрета и сконвертировать его по следующим правилам:
Правила преобразования идентификатора в имя переменной окружения
Разбиваем camelCase на части через символ „_“. Например: camelCase → camel_Case
Заменяем все символы „-“ и „.“ на „_“
Заменяем все символы, которые не входят в перечень
[a-zA-Z0-9_]на_X{код_символа}_Переводим получившуюся строку в верхний регистр и добавляем префикс «ECOS_SECRET_»
Таким образом для примера выше мы можем задать следующие переменные среды:
ECOS_SECRET_CONTENT_STORAGE_S3_CREDENTIALS_TYPE=BASIC
ECOS_SECRET_CONTENT_STORAGE_S3_CREDENTIALS_USERNAME=sMJjtYPxFGjPEKeFp1lC
ECOS_SECRET_CONTENT_STORAGE_S3_CREDENTIALS_PASSWORD=KenKpEhD6Lag3acImDAq2ZeLtlSij1vyaYZt8lyH
Переменные среды приоритетнее хранилища секретов в БД микросервиса ecos-model и они могут быть заданы как непосредственно в микросервисе, который будет использовать эти секреты, так и в ecos-model.
Использование секретов в коде
Получение:
BasicSecretData basicData = EcosSecrets.getBasicData("content-storage-s3-credentials");
String username = basicData.getUsername();
String password = basicData.getPassword();
Подписка на изменения:
EcosSecrets.listenChanges((secretId) -> {
// здесь можем пересоздать подключения, которые зависят от secretId
return Unit.INSTANCE;
});
В интерфейсе
Настройки доступны в разделе «Секреты» (Рабочее пространство «Раздел администратора» - Модель):
Журнал доступен по адресу: v2/journals?journalId=ecos-secrets&viewMode=table&ws=admin$workspace
Форма создания:
Шифрование секретов
Секреты хранятся в базе данных в зашифрованном виде.
Ключ шифрования задается через переменные окружения (ENV) микросервиса ecos-model.
Настройки шифрования
Поддержка в Helm
При развёртывании через Helm передайте приведённые ниже переменные окружения в микросервис ecos-model. Способ их задания зависит от используемой версии чарта.
Переменные окружения
Переменная |
Описание |
По умолчанию |
|---|---|---|
ECOS_SECRET_ENCRYPTION_CURRENT_KEY |
Текущий AES-ключ в Base64. На продакшн-серверах встроенный ключ необходимо заменить. При активном профиле |
Встроенный ключ; требуется замена в production. |
ECOS_SECRET_ENCRYPTION_CURRENT_ALGORITHM |
Алгоритм шифрования. |
AES/GCM/NoPadding |
ECOS_SECRET_ENCRYPTION_CURRENT_IV_SIZE |
Размер вектора инициализации (IV). |
12 |
ECOS_SECRET_ENCRYPTION_CURRENT_TAG_SIZE |
Размер тега аутентификации (TAG). |
128 |
ECOS_SECRET_ENCRYPTION_PREVIOUS_KEY |
Предыдущий AES-ключ в Base64. Используется при ротации для расшифровки данных, которые затем шифруются текущим ключом. |
Пустое значение. |
Пример генерации ключа для ECOS_SECRET_ENCRYPTION_CURRENT_KEY:
import java.util.Base64
import javax.crypto.KeyGenerator
fun main() {
val keyGen = KeyGenerator.getInstance("AES")
keyGen.init(128) // AES key size 128
val secretKey = keyGen.generateKey()
val base64Key = Base64.getEncoder().encodeToString(secretKey.encoded)
println("Base64 Key: $base64Key")
}
Ротация ключей шифрования
Как ротировать ключ шифрования
Сгенерируйте новый AES-ключ.
Установите новый ключ в переменную окружения ECOS_SECRET_ENCRYPTION_CURRENT_KEY.
Старый ключ укажите в переменной ECOS_SECRET_ENCRYPTION_PREVIOUS_KEY.
Перезапустите
ecos-modelи проверьте логи ротации и доступ к секретам.
При запуске ecos-model данные, зашифрованные другим ключом, расшифровываются предыдущим ключом и шифруются текущим. Уже использующие текущий ключ записи не перешифровываются. Старые незашифрованные данные шифруются текущим ключом.
Предыдущий ключ должен соответствовать сохранённому хешу ключа записи. Если он отсутствует, не соответствует хешу или метаданные шифрования не читаются, запись пропускается с ошибкой в логах. Сам факт запуска сервиса не гарантирует завершения ротации всех секретов.
Обычное чтение данных использует текущий ключ. При незавершённой ротации исправьте причину ошибки и повторите её до следующей смены ключа.
Инструкция для администраторов
Чек-лист при развёртывании нового сервера
При развертывании нового сервера необходимо каждый раз генерировать уникальный ключ шифрования.
Используйте приведённый выше код для генерации AES-ключа.
Убедитесь, что встроенный ключ заменён на новый. Диагностические сообщения о встроенном ключе зависят от профиля запуска и не заменяют проверку конфигурации.