Интерактивная IDE в production увеличивает доступность служебных функций, но её отключение закрывает только HTML landing page. Сам /graphql может продолжать принимать POST, возвращать schema через introspection и выполнять любые разрешённые операции. Поэтому исправление проверяют по слоям, а не по исчезнувшей кнопке Run.
Сначала ограничьте доступ к IDE штатной конфигурацией приложения или gateway. Не блокируйте все GET/POST по слову graphql и не полагайтесь на robots.txt: реальные clients используют тот же endpoint и должны пройти контролируемую приёмку.
Пять поверхностей требуют пяти проверок
| Поверхность | Безопасный тест | Желаемый production результат |
|---|---|---|
| Landing page | GET с 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 снаружи доверенной сети.
Приёмка после изменения
- GET с Accept text/html больше не показывает IDE.
- Production schema policy для introspection выполняется.
- Известная разрешённая client operation продолжает работать.
- Запрос без auth не получает закрытые поля.
- Тестовая дорогая operation ограничивается до нагрузки.
- Ошибки не раскрывают stack и конфигурацию.
- Development IDE остаётся доступна только в изолированной среде.
Материалы для security review
Нужны framework и version, production config без secrets, ответы двух безопасных проб, схема authentication/authorization, правила limits, пример обезличенной ошибки и proxy route. По ним видно, закрыта ли только страница или действительно уменьшена поверхность endpoint.