Общий ключ кажется удобным ровно до первого отзыва. Если один партнёр потерял секрет, отключение затронет всех; если вырос трафик, невозможно уверенно назвать источник; если в журнале виден только один 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 identity | Key не должен подменять 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 и логировать по безопасному идентификатору.
Миграция проходит с коротким периодом перекрытия
- По access logs, конфигурациям и владельцам собрать полный список потребителей общего ключа.
- Создать каждому клиенту отдельный credential с минимальными разрешениями и собственной квотой.
- Передать секрет через защищённый канал и назначить срок перехода; не отправлять его в обычном тикете.
- Временно принимать старый и новый credentials, отмечая долю запросов по каждому client ID.
- Связаться с теми, кто продолжает использовать общий ключ, и проверить их успешный переход.
- Отозвать общий ключ, убедиться в отказе старого значения и закрыть исключение в конфигурации.
Перекрытие должно иметь точную дату окончания. Бессрочный 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, но не размножайте значение в логах и переписке.