Перенос секретов — это не копирование строк из `.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 выполняется маленькими партиями

  1. Создайте путь, policy и машинную аутентификацию в непроизводственной среде.
  2. Запишите текущий secret как отдельную версию и проверьте чтение конкретным workload.
  3. Разверните код, который предпочитает хранилище, но умеет контролируемо вернуться к старому источнику.
  4. Переключите один instance или canary и наблюдайте ошибки аутентификации, latency и refresh.
  5. Переключите остальные потребители, включая редкие cron jobs и аварийные workers.
  6. Создайте новое значение, подтвердите его использование и отзовите прежнее.
  7. Удалите 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-файла.

Проверенные источники