Если токен меняется только после `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» ещё не означает «все процессы используют новую версию».
Ротация проходит с двумя действующими версиями
- Создать новое credential с теми же минимальными правами, не отзывая старое.
- Доставить новую версию всем экземплярам и подтвердить, какой version ID прочитан.
- Провести один реальный безопасный запрос от каждого типа потребителя.
- Наблюдать ошибки аутентификации в течение согласованного окна и найти отставшие job/worker.
- Отозвать старое 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 и полные логи запросов передавать не нужно.