glossary
pg_graphql Extension Exposure
pg_graphql Extension Exposure appears when GraphQL remains enabled on schemas or objects that should not be reachable from client credentials. This page explains it in plain English, then goes deeper into how it works in Supabase/Postgres, what commonly goes wrong, and how to fix it without relying on fragile client-side rules.
What “pg_graphql Extension Exposure” means (plain English)
pg_graphql Extension Exposure means your GraphQL endpoint can reveal or query objects you did not plan to expose. Teams often harden REST paths but forget GraphQL is another door into the same data model. If schema exposure and grants are broad, attackers can still enumerate data through GraphQL queries.
How pg_graphql Extension Exposure works in Supabase/Postgres (technical)
When pg_graphql is enabled, GraphQL schema generation follows exposed database objects and role privileges. If sensitive relations remain in exposed schemas or if grants are permissive, GraphQL queries can bypass assumptions made in app-specific endpoints. Mitigation includes disabling pg_graphql when unused, restricting exposed schema scope, auditing grants, and testing GraphQL introspection/query behavior under anon/authenticated contexts.
Attack paths & failure modes for pg_graphql Extension Exposure
- pg_graphql Extension Exposure: direct API bypass: A team validates behavior only through UI flows, but an attacker calls the underlying Supabase endpoint directly with client credentials. Because pg_graphql extension exposure is present, the attacker can read or trigger operations outside intended authorization boundaries.
- pg_graphql Extension Exposure: migration drift regression: The team previously hardened this area, but a later migration adds objects, privileges, or settings without full security review. The rollout reopens pg_graphql extension exposure and restores an exploitable path in production.
- pg_graphql Extension Exposure: direct API bypass: Security controls depended on frontend behavior and partial configuration checks. The underlying grants, schema exposure, or policy predicates still allowed direct access patterns that untrusted clients could reproduce.
- pg_graphql Extension Exposure: migration drift regression: Migrations were treated as schema-only changes without mandatory security gates. No automated checks validated grants, exposed schema settings, or authorization behavior before deployment.
- The configuration doesn’t match what the UI implies (direct API access bypasses the app).
- Policies/grants drift over time and widen access without anyone noticing.
- Fixes are applied without verification, leading to false confidence.
Why pg_graphql Extension Exposure matters for Supabase security
GraphQL adds convenience but can multiply accidental exposure paths when not governed with least privilege. A single overlooked object can reveal high-value metadata or rows. Explicitly controlling GraphQL exposure keeps API boundaries predictable and prevents hidden data discovery channels.
Common pg_graphql Extension Exposure mistakes that lead to leaks
- Assuming GraphQL is safe because REST routes were hardened, without endpoint-level verification.
- Leaving pg_graphql enabled during migration to custom schemas and never re-auditing schema output.
- Ignoring introspection/testing under real client roles, so leaked fields are discovered too late.
- pg_graphql Extension Exposure: direct API bypass: Security controls depended on frontend behavior and partial configuration checks. The underlying grants, schema exposure, or policy predicates still allowed direct access patterns that untrusted clients could reproduce.
- pg_graphql Extension Exposure: migration drift regression: Migrations were treated as schema-only changes without mandatory security gates. No automated checks validated grants, exposed schema settings, or authorization behavior before deployment.
Where to look for pg_graphql Extension Exposure in Supabase
- Your grants, policies, and any direct client access paths.
- Storage and RPC settings (common blind spots).
How to detect pg_graphql Extension Exposure issues (signals + checks)
Use this as a quick checklist to validate your current state:
- Try the same queries your frontend can run (anon/authenticated). If sensitive rows come back, you have exposure.
- Verify RLS is enabled and (for sensitive tables) forced.
- List policies and look for conditions that don’t bind rows to a user or tenant.
- Audit grants to
anon/authenticatedon sensitive tables and functions. - pg_graphql Extension Exposure: direct API bypass: Frontend checks are UX, not authorization.
- pg_graphql Extension Exposure: direct API bypass: Test direct endpoint access with anon/authenticated credentials.
- pg_graphql Extension Exposure: direct API bypass: Restrict exposed schemas, grants, and callable routines deliberately.
- Re-test after every migration that touches security-critical tables or functions.
How to fix pg_graphql Extension Exposure (backend-only + zero-policy posture)
Mockly’s safest default is backend-only access: the browser should not query tables, call RPC, or access Storage directly.
- Decide which operations must remain client-side (often: none for sensitive resources).
- Create server endpoints (API routes or server actions) for required reads/writes.
- Apply hardening SQL: enable+force RLS where relevant, remove broad policies, and revoke grants from client roles.
- Generate signed URLs for private Storage downloads on the server only.
- Re-run a scan and confirm the issue disappears.
- Add a regression check to your release process so drift doesn’t reintroduce exposure. Fixes that worked in linked incidents:
- pg_graphql Extension Exposure: direct API bypass: The team removed direct sensitive paths from client reach, tightened role grants and policy predicates, and added endpoint-level verification tests that run in CI after each migration.
- pg_graphql Extension Exposure: migration drift regression: The team added migration-time policy/grant diff checks, blocked deploys on drift findings, and required post-deploy direct-access verification for each changed surface.
Verification checklist for pg_graphql Extension Exposure
- Attempt direct access using client credentials and confirm it fails.
- Apply a backend-only fix pattern and verify end-to-end behavior.
- Re-run a scan after changes and after the next migration.
- pg_graphql Extension Exposure: direct API bypass: Frontend checks are UX, not authorization.
- pg_graphql Extension Exposure: direct API bypass: Test direct endpoint access with anon/authenticated credentials.
- pg_graphql Extension Exposure: direct API bypass: Restrict exposed schemas, grants, and callable routines deliberately.
- pg_graphql Extension Exposure: direct API bypass: Keep one repeatable verification check per risk class in CI.
- pg_graphql Extension Exposure: migration drift regression: Most recurring exposure comes from migration drift, not one-time coding mistakes.
SQL sanity checks for pg_graphql Extension Exposure (optional, but high signal)
If you prefer evidence over intuition, run a small set of SQL checks after each fix.
The goal is not to memorize catalog tables — it’s to make sure the access boundary you intended is the one Postgres actually enforces:
- Confirm RLS is enabled (and forced where appropriate) for tables tied to this term.
- List policies and read them as plain language: who can do what, under what condition?
- Audit grants for anon/authenticated and PUBLIC on the tables, views, and functions involved.
- If Storage is involved: review bucket privacy and policies for listing/reads.
- If RPC is involved: review EXECUTE grants for functions and whether privileged functions are server-only.
Pair these checks with a direct API access test using client credentials. When both agree, you can ship the fix with confidence.
Over time, keep a small “query pack” for the checks you trust and run it after every migration. That’s how you prevent quiet regressions.
Prevent pg_graphql Extension Exposure drift (so it doesn’t come back)
- Add a repeatable checklist and re-run it after schema changes.
- Prefer backend-only access for sensitive resources.
- Keep one reusable verification test for “pg_graphql Extension Exposure: direct API bypass” and rerun it after every migration that touches this surface.
- Keep one reusable verification test for “pg_graphql Extension Exposure: migration drift regression” and rerun it after every migration that touches this surface.
Rollout plan for pg_graphql Extension Exposure fixes (without breaking production)
Many hardening changes fail because teams revoke direct access first and only later discover missing backend paths.
Use this sequence to reduce both risk and outage pressure:
- Implement and verify the backend endpoint or server action before permission changes.
- Switch clients to that backend path behind a feature flag when possible.
- Then revoke direct client access (broad grants, permissive policies, public bucket reads, or broad EXECUTE).
- Run direct-access denial tests and confirm authorized backend flows still succeed.
- Re-scan after deployment and again after the next migration.
This turns security fixes into repeatable rollout mechanics instead of one-off emergency changes.
Incident breakdowns for pg_graphql Extension Exposure (real scenarios)
pg_graphql Extension Exposure: direct API bypass
Scenario: A team validates behavior only through UI flows, but an attacker calls the underlying Supabase endpoint directly with client credentials. Because pg_graphql extension exposure is present, the attacker can read or trigger operations outside intended authorization boundaries.
What failed: Security controls depended on frontend behavior and partial configuration checks. The underlying grants, schema exposure, or policy predicates still allowed direct access patterns that untrusted clients could reproduce.
What fixed it: The team removed direct sensitive paths from client reach, tightened role grants and policy predicates, and added endpoint-level verification tests that run in CI after each migration.
Why the fix worked: The fix enforces least privilege at the data boundary and validates attacker-like request paths instead of trusting UI constraints. This closes the bypass route and keeps behavior stable across refactors.
Key takeaways:
- Frontend checks are UX, not authorization.
- Test direct endpoint access with anon/authenticated credentials.
- Restrict exposed schemas, grants, and callable routines deliberately.
- Keep one repeatable verification check per risk class in CI.
Read full example: pg_graphql Extension Exposure: direct API bypass
pg_graphql Extension Exposure: migration drift regression
Scenario: The team previously hardened this area, but a later migration adds objects, privileges, or settings without full security review. The rollout reopens pg_graphql extension exposure and restores an exploitable path in production.
What failed: Migrations were treated as schema-only changes without mandatory security gates. No automated checks validated grants, exposed schema settings, or authorization behavior before deployment.
What fixed it: The team added migration-time policy/grant diff checks, blocked deploys on drift findings, and required post-deploy direct-access verification for each changed surface.
Why the fix worked: Security posture becomes part of delivery quality controls, so regressions are caught before users are exposed. Drift no longer accumulates silently between releases.
Key takeaways:
- Most recurring exposure comes from migration drift, not one-time coding mistakes.
- Automate grant and policy checks in CI/CD.
- Treat API surface changes as security-sensitive deploy events.
- Re-run scans immediately after schema or auth changes.
Read full example: pg_graphql Extension Exposure: migration drift regression
Real-world examples of pg_graphql Extension Exposure (and why they work)
- pg_graphql Extension Exposure: direct API bypass — A production-like scenario where pg_graphql Extension Exposure is exploited through direct requests that bypass frontend assumptions.
- pg_graphql Extension Exposure: migration drift regression — A release regression where migration drift silently reintroduces pg_graphql extension exposure after an earlier fix.
Related terms
- Data API Public Schema Exposure →
/glossary/data-api-public-schema-exposure - Exposed Materialized Views →
/glossary/exposed-materialized-views
FAQ
Is pg_graphql Extension Exposure enough to secure my Supabase app?
It’s necessary, but not sufficient. You also need correct grants, secure Storage/RPC settings, and a backend-only access model for sensitive operations.
What’s the quickest way to reduce risk with pg_graphql Extension Exposure?
Remove direct client access to sensitive resources, enable/force RLS where appropriate, and verify via a repeatable checklist that anon/authenticated cannot query what they shouldn’t.
How do I verify the fix is real (not just a UI change)?
Attempt direct API queries using the same client credentials your app ships. If the database denies access (401/403) and your backend endpoints still work, your fix is effective.
Next step
Want a quick exposure report for your own project? Run a scan in Mockly to find public tables, storage buckets, and RPC functions — then apply fixes with verification steps.