{"uid":"cap_xRGDjvv9oPJaaG_KeUcZ5","slug":"brainiac-federation-subgraph-exposure-audit-8aa66860","name":"BRAINIAC Federation Subgraph Exposure Audit","description":"Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.","url":"https://www.brainiac.software/api/v1/graphql-security/federation-subgraph-exposure-audit?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"router":{"type":"object","properties":{"sandbox":{"type":"boolean"},"introspection":{"type":"boolean"},"authenticationToSubgraphs":{"enum":["required","disabled","per_subgraph","unknown"],"type":"string"}},"additionalProperties":false},"subgraphs":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,79}$"},"ingress":{"type":"object","required":["audience"],"properties":{"audience":{"enum":["public","internal","unknown"],"type":"string"}},"additionalProperties":false},"service":{"type":"object","required":["exposure"],"properties":{"exposure":{"enum":["cluster_local","internal","public","unknown"],"type":"string"}},"additionalProperties":false},"endpoint":{"type":"string","maxLength":500,"minLength":1},"introspection":{"type":"boolean"},"authentication":{"enum":["required","disabled","unknown"],"type":"string"},"developmentMode":{"type":"boolean"},"federationFields":{"type":"object","properties":{"service":{"enum":["router_only","exposed","unknown"],"type":"string"},"entities":{"enum":["router_only","exposed","unknown"],"type":"string"}},"additionalProperties":false},"acceptsDirectClients":{"type":"boolean"}},"additionalProperties":false},"maxItems":32,"minItems":1},"networkRules":{"type":"array","items":{"type":"object","required":["subgraph","source","action"],"properties":{"action":{"enum":["allow","deny"],"type":"string"},"source":{"enum":["router","public","cluster","any"],"type":"string"},"subgraph":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,79}$"}},"additionalProperties":false},"maxItems":128},"publicEndpoints":{"type":"array","items":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,79}$"},"maxItems":32}}},"responseSchema":{"type":"json","example":{"findings":[{"code":"federation_field_exposed","field":"_service","detail":"The supplied policy marks _service as exposed. This was not checked by sending a query.","severity":"high","subgraph":"reviews"},{"code":"federation_field_exposed","field":"_entities","detail":"The supplied policy marks _entities as exposed. This was not checked by sending a query.","severity":"high","subgraph":"reviews"},{"code":"configured_public","detail":"The supplied service exposure is public. This is a configuration label, not a live network observation.","severity":"high","subgraph":"reviews"},{"code":"configured_public","detail":"The supplied ingress audience is public. This is a configuration label, not a live network observation.","severity":"high","subgraph":"reviews"},{"code":"configured_public","detail":"The supplied endpoint host reviews.example.com is not a local, link-local, or private address. The host was not resolved or probed, so this is not evidence that it is reachable from the internet.","severity":"high","subgraph":"reviews"},{"code":"configured_public","detail":"The supplied configuration says this subgraph accepts direct client traffic. This was not checked by opening a connection.","severity":"high","subgraph":"reviews"},{"code":"configured_public","detail":"A supplied network rule allows public or any source. This was not checked against a live firewall.","severity":"high","subgraph":"reviews"},{"code":"trust_boundary_violation","detail":"reviews is not in publicEndpoints. The supplied configuration uses service_public, ingress_public, public_url_host, direct_clients, network_allow. This comparison uses only the request and does not show that the endpoint is reachable.","severity":"high","subgraph":"reviews"},{"code":"authentication_disabled","detail":"The subgraph configuration sets authentication to disabled. The subgraph was not called.","severity":"high","subgraph":"reviews"},{"code":"introspection_enabled","detail":"The supplied configuration enables introspection. This was not checked by sending a query.","severity":"high","subgraph":"reviews"},{"code":"development_mode","detail":"The supplied configuration enables development mode. This was not checked against a running process.","severity":"high","subgraph":"reviews"},{"code":"authentication_inconsistent","detail":"The supplied authentication settings include disabled and required. This is a configuration difference, not a live authentication check.","severity":"high"},{"code":"configuration_only","detail":"This is a static reading of the supplied configuration. No URL was resolved or probed, and a public host name is not evidence of internet reachability.","severity":"low"}],"risk_level":"critical","limitations":["This is a static reading of the supplied configuration. No URL was resolved, probed, or requested.","A public host name or a public exposure label is not evidence that the endpoint is reachable from the internet.","Missing fields are unknown. They are not treated as exposed or as protected.","Service exposure and ingress audience are explicit labels in the request. Kubernetes manifests, cloud security groups, and proxy files are not parsed.","_service and _entities are compared only with the supplied federationFields values.","publicEndpoints is a caller-supplied list of subgraph names. It was not checked against a live edge."],"audit_status":"findings_detected","trust_boundary_violations":[{"detail":"reviews is not in publicEndpoints. The supplied configuration uses service_public, ingress_public, public_url_host, direct_clients, network_allow. This comparison uses only the request and does not show that the endpoint is reachable.","intended":"not_listed","subgraph":"reviews","configured":"service_public, ingress_public, public_url_host, direct_clients, network_allow"}],"internal_authentication_gaps":[{"detail":"The subgraph configuration sets authentication to disabled. The subgraph was not called.","source":"subgraph","subgraph":"reviews"}],"potentially_public_subgraphs":[{"host":"reviews.example.com","detail":"The supplied service exposure is public. This is a configuration label, not a live network observation.","reason":"service_public","subgraph":"reviews"},{"host":"reviews.example.com","detail":"The supplied ingress audience is public. This is a configuration label, not a live network observation.","reason":"ingress_public","subgraph":"reviews"},{"host":"reviews.example.com","detail":"The supplied endpoint host reviews.example.com is not a local, link-local, or private address. The host was not resolved or probed, so this is not evidence that it is reachable from the internet.","reason":"public_url_host","subgraph":"reviews"},{"host":"reviews.example.com","detail":"The supplied configuration says this subgraph accepts direct client traffic. This was not checked by opening a connection.","reason":"direct_clients","subgraph":"reviews"},{"host":"reviews.example.com","detail":"A supplied network rule allows public or any source. This was not checked against a live firewall.","reason":"network_allow","subgraph":"reviews"}],"federation_internal_field_findings":[{"field":"_service","detail":"The supplied policy marks _service as exposed. This was not checked by sending a query.","exposure":"exposed","subgraph":"reviews"},{"field":"_entities","detail":"The supplied policy marks _entities as exposed. This was not checked by sending a query.","exposure":"exposed","subgraph":"reviews"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Cb7T6seknBIYCr_EpEoxS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Audits a GraphQL federation setup for subgraph exposure risks, authentication gaps, introspection leaks, and trust boundary violations based on supplied configuration.","exampleAgentPrompt":"Audit my GraphQL federation setup for security issues — my router has introspection enabled and authentication set to per_subgraph. I have a 'reviews' subgraph with public ingress, its service exposure is 'public', authentication is disabled, and it accepts direct clients. Can you check for trust boundary violations, exposed federation fields, and authentication gaps?","exampleUseCases":[{"title":"Pre-launch federation security review","prompt":"Before we go live, audit our GraphQL federation config: the router has sandbox mode off and authentication set to required for subgraphs. We have two subgraphs — 'orders' (internal ingress, cluster_local service, authentication required) and 'catalog' (public ingress, public service exposure, authentication disabled, accepts direct clients). Flag any security problems."},{"title":"Detecting exposed federation internals","prompt":"Check if our 'payments' subgraph is leaking federation internals — its federationFields have both _service and _entities set to 'exposed', introspection is enabled, and the service exposure is public. What severity findings does that generate?"},{"title":"Network rule permissiveness audit","prompt":"We have a subgraph called 'userprofile' with internal ingress and cluster_local exposure, but someone added a network rule allowing 'any' source. Can you audit whether that creates a trust boundary violation or other security findings?"}],"resultDescription":"A JSON object containing an array of findings, each with a code (e.g. federation_field_exposed, configured_public, trust_boundary_violation, authentication_disabled, introspection_enabled), a severity (high/medium/low), the subgraph name, a field name where relevant, and a human-readable detail string explaining the issue. All analysis is static — based solely on the supplied configuration, not live probing.","failureModes":["Invalid subgraph name pattern causes schema validation error","Subgraph count exceeds maxItems:32 limit — request rejected","Network rule references a subgraph name not in the subgraphs array","Missing required fields (name in subgraph, audience in ingress, exposure in service) cause 400-level errors","Endpoint string exceeds 500 character limit","Payment not settled via x402 — 402 response with payment instructions returned","Empty subgraph array (minItems:1 violated) causes rejection"],"whenToPreferThis":"Use this endpoint when you need a fast, pay-per-call, no-account static security audit of a GraphQL Apollo Federation or similar federated schema configuration. It is best suited for CI/CD pipelines, pre-deployment checks, or agent-driven compliance workflows where you can describe the configuration programmatically but don't need live network probing. Prefer this over manual review or heavier DAST tools when you want structured, machine-readable findings at $0.05/call with no subscription required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-13T18:41:10.851Z","isFirstParty":false,"canonicalSlug":"brainiac-federation-subgraph-exposure-audit-8aa66860"}