Интерактивная IDE в production увеличивает доступность служебных функций, но её отключение закрывает только HTML landing page. Сам /graphql может продолжать принимать POST, возвращать schema через introspection и выполнять любые разрешённые операции. Поэтому исправление проверяют по слоям, а не по исчезнувшей кнопке Run.

Сначала ограничьте доступ к IDE штатной конфигурацией приложения или gateway. Не блокируйте все GET/POST по слову graphql и не полагайтесь на robots.txt: реальные clients используют тот же endpoint и должны пройти контролируемую приёмку.

Пять поверхностей требуют пяти проверок

ПоверхностьБезопасный тестЖелаемый production результат
Landing pageGET с Accept: text/htmlНет интерактивной IDE
IntrospectionМинимальный __schema queryРешение соответствует политике доступа
Operation endpointБезвредный query без authТолько явно публичные поля
AuthorizationЧужой object ID тестовой учётной записиОтказ на серверной стороне
Errors и limitsНевалидная/дорогая тестовая operationНет stack trace, есть контролируемый лимит

Проверяем отдельно HTML и GraphQL protocol

curl -i -H 'Accept: text/html' \
  https://api.example.test/graphql

curl -sS -H 'Content-Type: application/json' \
  --data '{"query":"query SchemaProbe { __schema { queryType { name } } }"}' \
  https://api.example.test/graphql

Команды предназначены только для endpoint, которым вы владеете или который уполномочены тестировать. example.test нужно заменить на утверждённый адрес. Не добавляйте production token в историю shell; авторизованные проверки выполняйте через безопасный test client.

В Apollo landing page отключается plugin

import { ApolloServer } from "@apollo/server";
import { ApolloServerPluginLandingPageDisabled }
  from "@apollo/server/plugin/disabled";

const isProd = process.env.NODE_ENV === "production";
const server = new ApolloServer({
  typeDefs,
  resolvers,
  introspection: !isProd,
  plugins: isProd ? [ApolloServerPluginLandingPageDisabled()] : [],
});

Пример относится к Apollo Server 4/5 и показывает осознанное разделение environments. Официальная документация также предупреждает, что legacy GraphQL Playground plugin не получает поддержки документации и security updates; для development используют поддерживаемый инструмент в ограниченной среде.

Introspection — решение политики, а не единственный замок

GraphQL Foundation отмечает, что introspection часто отключают для внутренних production APIs, чтобы уменьшить поверхность атаки. Но __typename и известные заранее operations всё равно могут работать, а скрытая schema не исправляет отсутствующую authorization. Для публичной GraphQL platform introspection может быть осознанно нужна; тогда её защищают вместе с остальным endpoint.

  • Требовать authentication там, где нет публичных данных.
  • Проверять права внутри resolver для объекта и поля.
  • Ограничивать depth, breadth, aliases, cost и execution time.
  • Настроить rate limits по caller и operation.
  • Убирать stack traces и внутренние service names из errors.
  • Вести audit по operation name/hash, не сохраняя secrets и PII.

CORS не заменяет серверную авторизацию

CORS ограничивает чтение ответов браузерным JavaScript, но curl, backend client и прямой HTTP-запрос ему не подчиняются. Аналогично скрытие IDE за basic auth не защищает соседний POST route, если proxy rules различаются. Проверьте один и тот же публичный hostname снаружи доверенной сети.

Приёмка после изменения

  1. GET с Accept text/html больше не показывает IDE.
  2. Production schema policy для introspection выполняется.
  3. Известная разрешённая client operation продолжает работать.
  4. Запрос без auth не получает закрытые поля.
  5. Тестовая дорогая operation ограничивается до нагрузки.
  6. Ошибки не раскрывают stack и конфигурацию.
  7. Development IDE остаётся доступна только в изолированной среде.

Материалы для security review

Нужны framework и version, production config без secrets, ответы двух безопасных проб, схема authentication/authorization, правила limits, пример обезличенной ошибки и proxy route. По ним видно, закрыта ли только страница или действительно уменьшена поверхность endpoint.

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