GraphQL Introspection — AI가 만든 API 스키마가 통째로 새는 이유 [2026]

GraphQL Introspection 노출은 운영 환경에서 누구나 __schema 쿼리 한 번으로 전체 타입·필드·인자 목록을 받아갈 수 있는 결함이다.
REST 의 OPTIONS 응답이 "엔드포인트 몇 개"를 알려 준다면, GraphQL introspection 은 API 전체 지도, 숨겨진 admin 필드, 인자 형식까지 자동으로 알려 준다.
AI 도구가 짜 준 Apollo Server·Yoga·Hasura 코드는 기본값이 introspection ON 이라, 검토 없이 배포되면 그대로 새는 상태가 된다(출처: PortSwigger Web Security Academy "GraphQL", OWASP GraphQL Cheat Sheet).

한눈에 보는 GraphQL Introspection 노출

실제 공격 흐름 — 4단계

1. 스키마 덤프: POST /graphql 에 { __schema { types { name fields { name args { name type { name } } } } } } 전송
2. 숨은 필드 식별: adminUser·internalSettings·secretToken 같은 필드 발견
3. 권한 우회 시도: 일반 사용자 토큰으로 mutation 호출 → BFLA 결함 있으면 통과
4. 2차 자원 고갈: alias 100개·depth 20 깊이 쿼리 1발로 DB 다운 유도

핵심: introspection 노출은 단독 결함이라기보다 "다른 결함 찾는 시간을 1시간에서 1분으로 줄여 주는 가속기" 다.

AI 가 만든 GraphQL 코드의 위험 패턴

30초 자가 점검

# 1. introspection 살아 있는지 (3초)
curl -s -X POST https://your.app/graphql \
  -H "Content-Type: application/json" \
  -d '{"query":"{ __schema { types { name } } }"}' | head -c 400

# 2. GraphiQL/Playground UI 노출
curl -I https://your.app/graphql
curl -I https://your.app/playground

# 3. 인증 없이 mutation 가능한지
curl -s -X POST https://your.app/graphql \
  -H "Content-Type: application/json" \
  -d '{"query":"mutation { __typename }"}'

위 1번에 타입 목록이 보이면 노출. 외부 노출 자산(.env·관리자 페이지·민감 파일·헤더 17종)은 CodeScan 30초 무료 스캔으로 동시에 점검.

서버 별 차단 코드 — 복사용

Apollo Server v4

import { ApolloServer } from "@apollo/server";

const server = new ApolloServer({
  schema,
  introspection: process.env.NODE_ENV !== "production",
  // 운영에서는 landingPage 도 끔
  plugins: process.env.NODE_ENV === "production"
    ? [require("@apollo/server/plugin/disabled").ApolloServerPluginLandingPageDisabled()]
    : [],
});

GraphQL Yoga

import { createYoga } from "graphql-yoga";

const yoga = createYoga({
  schema,
  graphiql: process.env.NODE_ENV !== "production",  // UI 차단
  // 운영 환경에서 introspection 차단
  plugins: [
    {
      onValidate({ params, setValidationFn, validateFn }) {
        if (process.env.NODE_ENV === "production") {
          // NoSchemaIntrospectionCustomRule 같은 룰 추가
        }
      },
    },
  ],
});

Hasura

# config.yaml 또는 환경변수
HASURA_GRAPHQL_ENABLE_CONSOLE: "false"     # 운영
HASURA_GRAPHQL_DEV_MODE: "false"
HASURA_GRAPHQL_ENABLED_APIS: "graphql"      # metadata 등 차단
# 역할별 introspection 차단은 permissions 에서 명시

공통 — NoSchemaIntrospectionCustomRule

import { NoSchemaIntrospectionCustomRule } from "graphql";
// validationRules 옵션에 추가하면 운영에서 __schema 쿼리 거부
validationRules: process.env.NODE_ENV === "production"
  ? [NoSchemaIntrospectionCustomRule]
  : [],

같이 막아야 할 GraphQL 자원 고갈 3종

실제 사고·참고

• PortSwigger Web Security Academy "GraphQL" — introspection 노출에서 시작해 BOLA/BFLA 로 이어지는 표준 실험 코스(출처: portswigger.net/web-security/graphql).
• OWASP GraphQL Cheat Sheet — 운영 introspection 차단·depth/alias/batch 제한·인증 결합 권고.
• 2026 다수 HackerOne 디스클로저 — Apollo/Yoga 기본 설정 그대로 배포한 SaaS 에서 스키마 덤프 → BOLA·BFLA 로 이어진 보고가 매월 누적.

오늘 시작할 5가지 액션

1. 위 자가 점검 1번 명령 1회 실행 → 타입 목록 보이면 즉시 차단 코드 적용
2. 본인 스택 차단 코드 복사·배포 (운영 분기에서 introspection·UI·landingPage off)
3. NoSchemaIntrospectionCustomRule + graphql-depth-limit + alias 제한 도입
4. 관련 글: Mass Assignment 차단, CORS 사례, API 키 유출 점검
5. 외부 노출은 CodeScan 30초 무료 스캔

CodeScan 이 잡아 주는 것

CodeScan 은 해킹대회 수상·레드팀 운영 경력의 보안 전문 기업 SENTRIX 가 운영하는 보안 점검 SaaS 다. GraphQL 엔드포인트의 introspection·UI 노출과 함께 .env·관리자 페이지·민감 파일·헤더 17종을 URL 한 줄로 자동 점검한다.

다음에 해야 할 한 가지

GraphQL 노출은 다른 결함을 빠르게 찾게 해 주는 가속기다. 운영에서 introspection 을 끄는 한 줄이 가장 빠른 1수다.

👉 실무자라면 본인 스택 차단 코드 1줄을 오늘 배포하고 CodeScan 30초 무료 스캔으로 외부 노출을 함께 끊어라.

👉 임원/CISO 라면 SENTRIX 30분 1:1 GraphQL 보안 진단으로 introspection·BOLA·BFLA·자원 고갈 4축 1회 점검을 권장한다.