Перенос секретов — это не копирование строк из `.env` в новый интерфейс. Безопасная миграция сначала подключает приложение к хранилищу через workload identity, затем переносит и проверяет один credential, а старое значение отзывает только после подтверждения трафика. Так сбой доступа можно откатить без возвращения секрета в репозиторий.
Выберите целевую модель заранее: Vault KV или managed secret store подходит для статических значений, а database secrets engine может выдавать динамические учётные данные с ограниченным сроком. Не переносите устаревший общий пароль как вечный секрет, если сервис поддерживает короткоживущую роль или identity-based access.
Инвентаризация отделяет секрет от конфигурации
| Поле реестра | Пример | Зачем оно нужно |
|---|---|---|
| Владелец | Команда billing | Кто принимает решение о ротации |
| Потребители | api, worker, nightly job | Кого переключать и проверять |
| Тип | DB password, API token, certificate | Как хранить и обновлять |
| Источник сейчас | CI variable, файл на VM | Откуда удалить старую копию |
| Срок и ротация | 30 дней, overlap 2 часа | Когда новое значение станет обязательным |
| Сигнал здоровья | успешный login и error rate | Как принять или откатить cutover |
Не помещайте реальные значения в инвентаризационную таблицу. Хватит логического имени, пути назначения и идентификатора версии. Отдельно найдите секреты в history репозитория, образах, backup, wiki, build logs и на старых серверах: перенос рабочей копии не удаляет уже созданные дубликаты.
Приложение получает доступ по своей идентичности
Не раздавайте сервисам один постоянный Vault token. Свяжите workload с AppRole, Kubernetes auth, cloud IAM или другой подходящей машинной идентичностью и выдайте политику только на нужные пути и операции. Чтение секрета и администрирование хранилища принадлежат разным ролям.
path "kv/data/payments/api" {
capabilities = ["read"]
}
path "kv/metadata/payments/api" {
capabilities = ["read"]
}
# У приложения нет list по чужим путям и нет update/delete.Политика примерная: точные API paths зависят от версии KV и используемого механизма. Установите короткий TTL для выданной сессии, настройте renewal только там, где он нужен, и проверьте поведение при временной недоступности хранилища. Лог не должен печатать полученное значение.
Cutover выполняется маленькими партиями
- Создайте путь, policy и машинную аутентификацию в непроизводственной среде.
- Запишите текущий secret как отдельную версию и проверьте чтение конкретным workload.
- Разверните код, который предпочитает хранилище, но умеет контролируемо вернуться к старому источнику.
- Переключите один instance или canary и наблюдайте ошибки аутентификации, latency и refresh.
- Переключите остальные потребители, включая редкие cron jobs и аварийные workers.
- Создайте новое значение, подтвердите его использование и отзовите прежнее.
- Удалите fallback и старые копии по утверждённому списку мест.
Двойное чтение не означает, что оба секрета нужно отправлять внешнему сервису. Приложение сначала читает новый источник, а fallback включается feature flag только во время короткого окна. Любое срабатывание fallback измеряется; иначе забытый consumer годами удерживает старый пароль.
Ротация подтверждает, что миграция закончена
Пока старое значение работает, вы доказали лишь копирование. Сгенерируйте новый credential, обновите секрет-хранилище, дождитесь обновления всех потребителей и отзовите прежний. Для database engine Vault может выдавать динамические credentials или автоматически менять пароль static role; корневые данные не следует смешивать со static role.
- Проверяйте возраст версии секрета и время последнего успешного refresh.
- Оповещайте о чтении из устаревшего пути и о массовых auth failures.
- Храните audit log доступа, но не значение и не чувствительное тело запроса.
- Репетируйте восстановление хранилища и аварийный доступ по отдельной процедуре.
- Не удаляйте старый credential до проверки всех фоновых расписаний.
Откат возвращает маршрут, а не утекший файл
Если canary не может получить secret, откатите release или feature flag к прежнему провайдеру на заранее ограниченное время. Не копируйте значение обратно в чат, shell history или ConfigMap. Причину ищите по identity, policy decision, path, version и network boundary.
Миграция принята, когда новый credential пережил полную ротацию, старый отозван, редкие jobs прошли свой цикл, а сканирование не находит действующих копий в коде и артефактах. С этого момента изменения выполняются через контролируемый pipeline, а не ручную правку production-файла.