Если неавторизованный запрос к __schema возвращает список типов и полей, это подтверждает доступность schema introspection, но ещё не доказывает утечку пользовательских данных. Сначала определите модель API: публичным интеграторам discovery может быть нужен, а first-party приложению обычно достаточно заранее собранных operations. После этого ограничьте именно __schema и __type на внешнем контуре, не ломая __typename, который клиенты используют для interface и union.
Отключение introspection уменьшает discoverability, но не исправляет отсутствие authorization. Поля можно угадывать по документации, bundle клиента и подробным validation errors. Поэтому безопасный результат состоит из трёх частей: доступ к данным проверяется в resolvers или policy layer, неизвестные operations ограничиваются, а production errors не подсказывают внутренние названия сверх необходимого.
Политика зависит от того, кто является клиентом
| Контур | Introspection | Что оставить обязательным |
|---|---|---|
| Публичная GraphQL-платформа | Разрешить по документированному контракту либо по отдельной роли | Field-level authorization, limits, audit |
| First-party web и mobile | Запретить для недоверенного production traffic | Trusted documents и безопасные ошибки |
| Внутренняя developer-сеть | Разрешить после authentication | Короткоживущий доступ и журналирование |
| CI schema registry | Отдельный machine identity | Минимальное право только на schema fetch |
Не применяйте правило только по имени окружения в заголовке, который присылает сам клиент. Решение принимает gateway или GraphQL server по проверенной identity, network boundary и operation type. Если схема нужна CI, выделите отдельный credential и endpoint policy вместо общего исключения для любого запроса из корпоративного IP.
Проверка должна отделять __schema от __typename
# schema discovery: ожидаем запрет для внешнего anonymous клиента
query SchemaProbe {
__schema { queryType { name } }
}
# type discrimination: часто нужен обычному приложению
query SearchProbe {
search(text: "demo") { __typename }
}GraphQL specification определяет __schema и __type как meta-fields introspection system, а __typename доступен на Object, Interface и Union. Фильтр по любому имени с двумя подчёркиваниями слишком груб: он способен сломать нормальные fragments клиента. Проверяйте parsed operation и выбранные meta-fields, а не ищите строку __schema регулярным выражением в сыром JSON.
Собираем доказательства до переключения
- Посчитать операции с __schema и __type за репрезентативный период по operation hash, не сохраняя variables с персональными данными.
- Определить владельца каждого клиента: IDE разработчика, CI, schema registry, внешний интегратор или неизвестный источник.
- Проверить, не загружает ли мобильное приложение схему при старте из-за настройки библиотеки.
- Сравнить production и staging policy на gateway и в самом GraphQL server.
- Ввести метрику rejected introspection отдельно от общих GraphQL validation errors.
Сначала включите режим наблюдения: правило отмечает запрос, но не отклоняет его. После классификации разрешите известные технические identities и включите запрет для остального трафика. Так внезапный рост ошибок покажет конкретного клиента, а откат будет сводиться к policy change, а не к срочному возвращению всей developer IDE в production.
Запрет discovery не закрывает доступ к полям
Негативный тест должен использовать известное имя закрытого поля. Анонимный клиент не получает его даже при корректном query; пользователь одного tenant не читает объект другого; технический schema-reader видит типы, но не выполняет business mutation без отдельного scope. Если эти проверки падают, спор об introspection нужно отложить и исправить authorization boundary.
Подробные suggestions вида «Did you mean internalCustomerLedger» тоже раскрывают форму API. На внешнем контуре оставьте стабильный error code и request ID, а полную validation detail направляйте в защищённый log. При этом не превращайте все ошибки в HTTP 500: клиент должен отличать malformed operation, отказ доступа и внутренний сбой по безопасному контракту.
Приёмка проходит из двух сетевых точек
- Из внешнего anonymous контекста выполнить __schema и получить контролируемый отказ без schema fragments.
- Тем же клиентом выполнить разрешённый trusted document и получить обычный ответ.
- Проверить __typename в operation с interface или union, который использует приложение.
- Из identity schema registry получить schema, но убедиться, что business mutation не разрешена автоматически.
- Отправить запрос с опечаткой и проверить отсутствие внутренних suggestions и stack trace.
- Повторить cross-tenant запрос и получить отказ независимо от настройки introspection.
Для разбора подготовьте GraphQL implementation и версию, схему сетевых контуров, примеры трёх operations без variables, список client identities и текущий error formatter. Успех — schema discovery соответствует роли клиента, приложение не сломано, а доступ к данным остаётся запрещённым даже тому, кто уже знает точное имя поля.