Ротация не равна созданию второго секрета. Пока старый key ID имеет статус active у системы, которая проверяет запрос, он закономерно продолжает работать. Удаление строки из одного .env закрывает только одного consumer и ничего не меняет у issuer, gateway или соседних replicas.

Первый безопасный шаг — составить карту validators и потребителей, не копируя сам secret. Для каждого key ID нужны status, permissions, restrictions, last-used и владелец приложения. После этого старый ключ можно отключать контролируемо, а не надеяться, что он сам истечёт.

Overlap — отдельное состояние, а не финал

СостояниеРазрешеноУсловие перехода
Создан новыйСтарый обслуживает трафикНовый сохранён в secret manager
Развёрнут новыйОба ключа временно activeВсе consumers перечитали secret
Наблюдается новыйСобираются key ID и ошибкиСтарый ID не используется полный цикл
Старый inactiveВозможен ограниченный rollbackКритичные проверки зелёные
Старый удалёнВосстановление невозможноКонтрольное окно завершено

Manifest хранит идентификаторы, но не секреты

rotation_id: billing-api-2026-10
old_key_id: key_17
new_key_id: key_42
owner: payments-platform
consumers:
  - api-gateway
  - invoice-worker
  - reconciliation-job
rollback_deadline: 2026-10-03T18:00:00Z

Такой manifest можно хранить рядом с change record, если IDs не являются секретами у конкретного провайдера. Secret values остаются в secret manager, не попадают в Git, логи, tickets и команды shell. При сомнении идентификатор тоже маскируют.

Ищем, кто всё ещё использует старый ID

  • Проверить last-used и audit log у issuer.
  • Разбить обращения по service, environment и region.
  • Найти cron jobs, CI variables и аварийные scripts.
  • Убедиться, что replicas перечитали secret после deploy.
  • Проверить gateway и локальные caches validators.
  • Отдельно найти внешних партнёров и mobile builds, если ключ попал туда.

Отсутствие событий несколько минут не доказывает, что ключ больше не нужен: monthly job или редкий webhook мог не запускаться. Контрольное окно выбирают по реальному циклу каждого consumer. Для Google Cloud стандартная процедура ротации тоже заканчивается удалением старого ключа после обновления приложений, а не в момент создания нового.

Деактивация даёт проверяемый рубеж

Если платформа поддерживает reversible status, сначала переведите старый ключ в inactive и наблюдайте authorization failures. AWS IAM прямо предлагает этот порядок для access keys: создать второй, обновить приложения, проверить last used, деактивировать старый, подтвердить работу и затем удалить. Это пример provider-specific процесса, а не универсальная команда для любого API.

Не проверяйте старый secret запросом к изменяющему endpoint. Используйте безопасный read-only метод или штатный credential test, ограниченный тестовой учётной записью. Факт ожидаемого отказа нужно увидеть на том же validator path, которым пользуется production.

При компрометации overlap сокращается

Если secret мог утечь, удобство rollback уступает ограничению ущерба. Старый ключ отзывают у authority немедленно, сужают permissions и network restrictions нового, ищут злоупотребление по audit logs и меняют зависимые credentials. Ждать полного цикла редкого consumer в таком сценарии нельзя.

Почему ключ работает после revoke

Проверьте, нет ли нескольких issuers, environment copies или offline validators. Gateway мог закешировать положительный результат, а часть replicas — читать старый список keys. Время жизни такого cache должно быть меньше допустимого времени отзыва; после контрольного revoke запрос со старым ID обязан получать одинаковый отказ во всех regions.

  1. Создать новый ключ с минимальными теми же restrictions.
  2. Обновить consumers по одному и увидеть новый key ID в audit.
  3. Выдержать полный рабочий цикл старого ID без использования.
  4. Деактивировать старый key у authority.
  5. Проверить read-only запросы и authorization failures.
  6. Удалить старый key после контрольного окна.
  7. Закрыть change record со списком проверенных consumers.

Что нужно для разбора ротации

Подготовьте название provider, key IDs в маскированном виде, status, restrictions, last-used, список consumers и validators, TTL caches и timestamps deploy. Сам ключ, screenshots secret manager и полные authorization headers передавать нельзя.

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