Общий ключ кажется удобным ровно до первого отзыва. Если один партнёр потерял секрет, отключение затронет всех; если вырос трафик, невозможно уверенно назвать источник; если в журнале виден только один key ID, расследование заканчивается догадками. Первый шаг — не немедленная замена строки, а перечень реальных потребителей и их владельцев.

API key обычно идентифицирует вызывающее приложение. Он не подтверждает, какой человек находится за приложением, и сам по себе не должен заменять пользовательскую аутентификацию и проверку прав. Google отдельно предупреждает, что authorization key скрывает личность конечного пользователя в audit logs, а AWS не рекомендует использовать API keys как механизм authentication или authorization.

Сначала выясните, что сегодня означает общий ключ

ВопросЧто найтиПочему это важно
Кто отправляет запросыСервис, партнёр, мобильное приложение, cronОпределяет границу отдельного credential
Какие права даёт ключScopes, routes, tenant, environmentПозволяет уменьшить blast radius
Где хранится значениеSecret manager, CI, config, клиентский кодПоказывает пути утечки и ротации
Как считаются лимитыНа key, account, IP или endpointОбщий key объединяет квоту клиентов
Есть ли пользователь за запросомToken subject или service identityKey не должен подменять user auth
Как отключить одного клиентаОтдельный статус credentialПроверяет, решена ли исходная проблема

Не делите клиентов только по IP: адреса меняются, NAT объединяет организации, а serverless egress может быть общим. Надёжная единица — выданный сервером credential с неизменяемым внутренним ID. В журнал пишут ID и владельца, но никогда не полное секретное значение.

Реестр credentials нужен раньше массовой выдачи

credential_id: api-client-042
owner: payments-integration
environment: production
permissions:
  - orders.read
quota_plan: partner-standard
created_at: 2026-10-04
expires_at: 2027-01-04
status: active
secret_location: vault/path-redacted
last_used_at: 2026-10-04T19:30:11Z

Это административная карточка, а не конфигурация с секретом. Она отвечает на вопросы «кто владелец», «что разрешено», «когда использовалось» и «как отозвать». Внешнее значение лучше показывать только при выпуске, хранить в secret manager и логировать по безопасному идентификатору.

Миграция проходит с коротким периодом перекрытия

  1. По access logs, конфигурациям и владельцам собрать полный список потребителей общего ключа.
  2. Создать каждому клиенту отдельный credential с минимальными разрешениями и собственной квотой.
  3. Передать секрет через защищённый канал и назначить срок перехода; не отправлять его в обычном тикете.
  4. Временно принимать старый и новый credentials, отмечая долю запросов по каждому client ID.
  5. Связаться с теми, кто продолжает использовать общий ключ, и проверить их успешный переход.
  6. Отозвать общий ключ, убедиться в отказе старого значения и закрыть исключение в конфигурации.

Перекрытие должно иметь точную дату окончания. Бессрочный fallback превращается во второй постоянный ключ. Для критичного API сначала переведите один малорисковый клиент, проверьте метрики ошибок и только затем расширяйте волну.

Квота и авторизация живут на разных уровнях

Usage plan удобно связывает потребителя с лимитом, но лимит не является контролем доступа. AWS указывает, что throttling и quotas применяются best effort и не подходят для жёсткого ограничения затрат. Сначала выполняется authentication и authorization, затем эксплуатационное ограничение частоты; финансовый предел требует отдельного budget control и мониторинга.

  • Service credential идентифицирует приложение или интеграцию.
  • User token, когда он нужен, идентифицирует конечного пользователя.
  • Policy проверяет право выполнить конкретное действие над объектом.
  • Rate limit защищает ресурс и справедливо делит пропускную способность.
  • Audit event сохраняет credential ID, subject, route, результат и correlation ID.
  • Secret rotation заменяет значение без изменения бизнес-идентичности клиента.

Проверка после отзыва доказывает разделение

После отключения общего ключа выполните отрицательный запрос его безопасной тестовой копией и ожидайте 401 или другой документированный отказ. Затем отключите один тестовый credential и подтвердите, что остальные клиенты продолжают работать, а его трафик виден отдельно. Финальная метрика — ноль успешных обращений со старым key ID и отсутствие секрета в URL, исходниках и client-side bundle.

Если ключ уже мог утечь, обычной миграции недостаточно: немедленно отзовите его, просмотрите период экспозиции и только потом восстанавливайте доступ отдельными credentials. Сохраните временную шкалу и key ID, но не размножайте значение в логах и переписке.

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