Если токен меняется только после `docker build`, он стал частью артефакта, хотя должен быть runtime-конфигурацией. Первый безопасный шаг — не выпускать новый токен, а выяснить, где старое значение запекается: в Dockerfile, сгенерированном config, frontend bundle, слое image или CI-артефакте. Пока список потребителей не готов, отзыв старого значения может остановить часть системы.

Цель — один и тот же неизменяемый image запускать с разными секретами. Значение хранит secret manager или защищённый механизм платформы, workload получает его при запуске либо через файл/локальный агент, а приложение умеет перечитать credential или корректно перезапуститься. В репозитории остаются имя параметра и схема доступа, но не сам пароль.

Сначала находим точку сцепления с образом

Где найдено значениеПочему мешает ротацииЧто изменить
Dockerfile ENV или ARGСекрет может попасть в metadata/historyПередавать только в runtime; build secret — лишь для шага сборки
Файл, скопированный через COPYЗначение остаётся в слое imageМонтировать отдельный read-only файл
Frontend JavaScriptПользователь получает секрет в браузереПеренести привилегированный вызов на backend
CI variable записана в configАртефакт связан с одним окружениемПубликовать ссылку на secret, разрешать её при запуске
Переменная окружения PodОбновление Secret не меняет env работающего процессаКонтролируемый rollout или чтение файла

Docker прямо предупреждает, что `ARG` и `ENV` не подходят для передачи секретов сборки: значения могут остаться в итоговом образе, истории или attestations. BuildKit secret mount решает доступ к приватному ресурсу во время сборки, но не превращает build-time секрет в безопасный способ снабжения работающего контейнера.

Контракт приложения важнее выбранного хранилища

IMAGE_DIGEST=sha256:immutable-application
SECRET_REF=secret/app-api-token@version-42
DELIVERY=/run/secrets/app_api_token
RELOAD=signal-or-controlled-rollout
HEALTH_PROOF=outbound-auth-check-without-token-logging

Это не готовый config конкретного продукта, а контракт развёртывания. Он отделяет версию кода от версии credential и заранее отвечает на два вопроса: когда процесс увидит обновление и каким безопасным запросом это проверить. Логировать нужно версию или fingerprint секрета, но не его значение и не полный Authorization header.

В Kubernetes Secret, переданный через environment variable, не обновится внутри уже работающего контейнера: потребуется перезапуск. Файл из Secret volume обновляется с задержкой, но приложение само должно перечитать его; mount через `subPath` автоматического обновления не получает. Поэтому «мы обновили объект Secret» ещё не означает «все процессы используют новую версию».

Ротация проходит с двумя действующими версиями

  1. Создать новое credential с теми же минимальными правами, не отзывая старое.
  2. Доставить новую версию всем экземплярам и подтвердить, какой version ID прочитан.
  3. Провести один реальный безопасный запрос от каждого типа потребителя.
  4. Наблюдать ошибки аутентификации в течение согласованного окна и найти отставшие job/worker.
  5. Отозвать старое credential, затем доказать, что оно действительно перестало работать.

Перекрытие возможно не у каждого провайдера. Если допустим только один пароль, заранее подготовьте короткое окно, порядок переключения, rollback и владельца решения. Не делайте ротацию «на месте» без наблюдаемости: при частичном rollout часть реплик продолжит посылать старое значение, а общая метрика 401 не покажет виновника.

Secret manager не исправляет чтение один раз

Центральное хранилище улучшает выдачу, аудит и отзыв, но приложение может загрузить значение при старте и держать его в памяти бесконечно. Выберите явную модель: короткоживущие динамические credentials с renewal, перечитывание файла по событию или управляемый rolling restart. Для каждого варианта задайте срок жизни, поведение при недоступности хранилища и предел использования кешированной версии.

  • Не печатайте секрет в CI-команде, process list, exception или diff.
  • Не делите одно credential между несвязанными сервисами: отзыв становится неуправляемым.
  • Не удаляйте старую версию до проверки фоновых задач и редко запускаемых job.
  • Не считайте Base64 шифрованием и не храните расшифровочный ключ рядом с данными.
  • При компрометации сокращайте окно перекрытия и расследуйте доступ отдельно от плановой ротации.

Приёмка не требует раскрывать значение

Успешная ротация подтверждается четырьмя фактами: image digest не изменился из-за секрета, все экземпляры сообщили новую версию, контрольный вызов прошёл, старое credential отозвано и отклоняется. Затем повторите процедуру в тестовом окружении по runbook: разовая ручная удача не доказывает, что следующий аварийный отзыв будет безопасным.

Для разбора подготовьте Dockerfile без значений, схему доставки, список consumers, способ reload, TTL и временную шкалу прошлой ротации. Токены, пароли, содержимое Secret, CI variables и полные логи запросов передавать не нужно.

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