Проверка роли в Query.document не защищает Document.ownerEmail, если тот же объект возвращается через search, user.documents, mutation payload или node(id). GraphQL собирает ответ из полей, поэтому authorization должна следовать за объектом и данными, а не за одной точкой входа.
Сначала закройте уязвимое поле или resolver feature flag, затем протестируйте две реальные учётные записи разных tenants. Не ограничивайтесь скрытием поля из UI: клиент может запросить любой элемент опубликованной schema.
Обход появляется там, где путь кажется вторичным
| Путь | Типичный пропуск | Контроль |
|---|---|---|
| document(id) | Проверили login, но не ownership | Policy actor + object |
| search → edges → node | Фильтр списка есть, field resolver открыт | Edge и node authorization |
| node(globalId) | Общий loader отдаёт любой тип | Tenant-aware load и policy |
| mutation payload | Write разрешён, response слишком полный | Проверять возвращаемые fields |
| subscription event | Права проверены только при connect | Policy на event payload |
Одна operation проходит по трём entry points
query PermissionProbe($id: ID!) {
direct: document(id: $id) { id ownerEmail }
me { documents { nodes { id ownerEmail } } }
node(id: $id) {
... on Document { id ownerEmail }
}
}Запрос запускают только в test/staging против специально созданных объектов Alice и Bob. Ожидаемый результат фиксируют заранее: null поля, null объекта или typed error в зависимости от контракта. Production IDs и email в отчёт не переносят.
Authentication создаёт identity, authorization принимает решение
Middleware подтверждает credentials и помещает fully hydrated user/actor в request context. Дальше policy получает actor, action и конкретный resource. Наличие context.user доказывает только личность; роль admin, tenant membership, ownership и состояние объекта проверяются отдельно.
GraphQL Foundation рекомендует делегировать authorization в business logic layer, чтобы одинаковые правила использовали GraphQL, REST, background jobs и другие entry points. Resolver вызывает эту policy и решает, как представить отказ в GraphQL response.
Field resolver нужен даже после фильтра списка
- Object-level policy разрешает видеть сам Document.
- Field-level policy отдельно закрывает ownerEmail или cost.
- Mutation проверяет право на action и допустимые поля input.
- Response resolver не возвращает больше, чем actor может читать.
- Subscriptions переоценивают право при каждом событии, если оно меняется.
Default field resolver часто просто читает одноимённое свойство объекта. Если data layer загрузил чувствительное поле заранее, отсутствие явного resolver может незаметно открыть его. Возвращайте из repository минимальную проекцию или добавляйте явную policy для чувствительных fields.
Loaders и cache обязаны учитывать security scope
DataLoader cache живёт только в пределах одного request, если содержит actor-specific results. Shared cache key должен включать tenant и другие security dimensions либо хранить только нейтральный объект, поверх которого policy выполняется заново. Ключ document:42 без tenant создаёт cross-tenant утечку даже при правильном resolver.
Null и error выбирают осознанно
Возврат null может скрыть существование объекта, но nullable field должен поддерживать такой контракт. Typed forbidden error удобен доверенному клиенту, однако не должен раскрывать чужой ID. Для non-null поля ошибка поднимает null до ближайшего nullable parent — этот эффект проверяют, чтобы одно закрытое поле не уничтожало весь полезный ответ.
Тесты строятся как матрица actor × path × field
- Создать owner, участника другого tenant и администратора.
- Проверить direct lookup, list edge, node и mutation payload.
- Повторить поля через aliases и fragments.
- Запросить разрешённое и запрещённое поле вместе.
- Проверить loader/cache после запроса другого actor.
- Повторить subscription после отзыва права.
- Убедиться, что audit фиксирует policy decision без PII.
Артефакты для security review
Нужны SDL затронутых типов, список entry points, policy matrix ролей и tenants, resolver/data-loader схема, обезличенные test operations и ожидаемые errors. Tokens, реальные IDs и содержимое закрытых fields не нужны.