Skip to content

v2.4.0: add GraphQL-specific checks (field suggestions + query batching) - #14

Merged
liam-portswigger merged 1 commit into
mainfrom
graphql-checks
Jul 16, 2026
Merged

v2.4.0: add GraphQL-specific checks (field suggestions + query batching)#14
liam-portswigger merged 1 commit into
mainfrom
graphql-checks

Conversation

@liam-portswigger

Copy link
Copy Markdown
Owner

First additive feature since publication — GraphQL coverage native scanning doesn't provide.

New: GraphQlCheck (active, PER_HOST)

Gated by a new HttpUtils.isGraphQlRequest(); deduped per (host, path); both probes read-only (__typename), reusing the original request's auth headers and attaching the probe as evidence.

  • Field-suggestion leakage (API9) — probes the misspelled meta-field __typenaem; fires only when the response carries a Did you mean … hint and reads as a GraphQL error. Lets an attacker recover the schema field-by-field even with introspection off. Deep-links the native GraphQL introspection enabled / endpoint found issues.
  • Array query batching (API4) — sends a two-operation JSON array; fires only when the server returns a 2-element result array (both executed). Array batching isn't the GraphQL default, so it's a real config signal — an amplification / rate-limit-bypass primitive.

Deliberately not duplicated: endpoint discovery and introspection detection are native, so we don't re-raise them (introspection is cross-referenced instead). Query-depth/DoS was scoped out (FP-prone + can stress the live target).

Detection discipline

  • Suggestions: self-proving (Did you mean present) + GraphQL-error shape required → no generic "did you mean" FPs. Low/Firm.
  • Batching: requires a genuine 2-element array of GraphQL result objects → proves both ran. Low/Firm. Aliasing (default-on everywhere) is deliberately not flagged on its own to avoid noise.

Docs

16 checks / 10 active across README, CLAUDE, BURP_DAST_GUIDE, VALIDATION_GUIDE, BAPP_DESCRIPTION; GraphQL noted under API4 + API9. Also fixed a pre-existing duplicated "Parameter Pollution note" in the DAST guide. Version 2.3.2 → 2.4.0.

🤖 Generated with Claude Code

New GraphQlCheck (active, PER_HOST, deduped per host+path) adds two
GraphQL weaknesses Burp's native scanner does not cover:

- Field-suggestion leakage (API9): probes a misspelled meta-field
  (__typenaem); fires only when the response returns a "Did you mean"
  hint AND reads as a GraphQL error. Lets an attacker recover the schema
  even with introspection disabled. Cross-references the native GraphQL
  introspection / endpoint-found issues.
- Array query batching (API4): sends a two-operation JSON array; fires
  only when the server returns a 2-element result array (both executed).
  Array batching is not the GraphQL default, so this is a real config
  signal — an amplification / rate-limit-bypass primitive.

Both probes are read-only (__typename), gated by a new
HttpUtils.isGraphQlRequest(), reuse the original request's auth headers,
and attach the probe as evidence. Endpoint discovery and introspection
detection are left to native (no duplication).

Docs updated (README, CLAUDE, BURP_DAST_GUIDE, VALIDATION_GUIDE,
BAPP_DESCRIPTION): 16 checks / 10 active; GraphQL coverage noted under
API4 and API9; also fixed a duplicated Parameter Pollution note in the
DAST guide. Version 2.3.2 -> 2.4.0.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@liam-portswigger
liam-portswigger merged commit 799bd07 into main Jul 16, 2026
1 check passed
@liam-portswigger
liam-portswigger deleted the graphql-checks branch July 16, 2026 12:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant