Если неавторизованный запрос к __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 trafficTrusted 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, отказ доступа и внутренний сбой по безопасному контракту.

Приёмка проходит из двух сетевых точек

  1. Из внешнего anonymous контекста выполнить __schema и получить контролируемый отказ без schema fragments.
  2. Тем же клиентом выполнить разрешённый trusted document и получить обычный ответ.
  3. Проверить __typename в operation с interface или union, который использует приложение.
  4. Из identity schema registry получить schema, но убедиться, что business mutation не разрешена автоматически.
  5. Отправить запрос с опечаткой и проверить отсутствие внутренних suggestions и stack trace.
  6. Повторить cross-tenant запрос и получить отказ независимо от настройки introspection.

Для разбора подготовьте GraphQL implementation и версию, схему сетевых контуров, примеры трёх operations без variables, список client identities и текущий error formatter. Успех — schema discovery соответствует роли клиента, приложение не сломано, а доступ к данным остаётся запрещённым даже тому, кто уже знает точное имя поля.

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