skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
hardw00t/ai-security-arsenal54 installs

api-security

Router skill for API penetration testing across REST, GraphQL, gRPC, and WebSocket. Covers OWASP API Top 10 (2023) including BOLA/BFLA/BOPLA, JWT attack chains, GraphQL introspection abuse, and mass assignment. Invoke when the user asks to pentest an API, analyze OpenAPI/Swagger, test auth/authorization, fuzz endpoints, or find API vulnerabilities.

How do I install this agent skill?

npx skills add https://github.com/hardw00t/ai-security-arsenal --skill api-security
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The analyzed skill contains standard penetration testing guides, methodology documents, and common vulnerability checklists for API security auditing. No malicious behavior, prompt injection, or hidden execution channels were detected.

  • Socketwarn

    3 alerts: gptSecurity

  • Snykpass

    Risk: LOW · No issues

  • Runlayerpass

    1/1 file flagged

What does this agent skill do?

API Security Testing

Thin router for API penetration testing. Use the index sections to load the specific workflow, payload file, or methodology doc for the phase you're in. Do not pre-load everything.

When to Use

  • Pentesting a REST, GraphQL, gRPC, or WebSocket API.
  • OWASP API Top 10 (2023) coverage assessment.
  • BOLA / BFLA / BOPLA authorization matrix analysis.
  • JWT / OAuth / API-key auth testing.
  • Fuzzing endpoints, parameters, or schemas.
  • Parsing and attacking OpenAPI / Swagger / GraphQL schemas.
  • Rate-limit / resource-consumption testing.

Trigger Phrases

"pentest this API", "test the REST API", "test GraphQL security", "check for BOLA/IDOR", "analyze OpenAPI spec", "test API authentication", "JWT attacks", "fuzz API endpoints", "GraphQL introspection".

When NOT to Use This Skill

  • Browser / DOM-based testing (XSS, CSP, clickjacking, client-side auth flows rendered in a browser) -> use dast-automation.
  • Reviewing API source code for injection/authz bugs at the code level -> use sast-orchestration.
  • Mobile client reversing to recover API endpoints from an APK/IPA -> use mobile-security first, then return here with the recovered spec.
  • Cloud-provider IAM / API-gateway config auditing (not the API itself) -> use cloud-security.

Decision Tree

Is there a schema (OpenAPI / GraphQL SDL / .proto)?
  yes -> parse it first, feed endpoints.txt to fuzzers
  no  -> methodology/api_recon.md

What protocol?
  REST / JSON over HTTP -> workflows/rest_testing.md
  GraphQL               -> workflows/graphql_introspection_triage.md
                           then workflows/graphql_testing.md
  gRPC                  -> workflows/grpc_testing.md
  WebSocket             -> workflows/websocket_testing.md

Is a JWT in use?
  yes -> workflows/jwt_attack_chooser.md  (alg-none -> key-conf -> kid -> brute)

Primary finding target?
  Authorization bugs  -> methodology/bola_bfla_matrix.md  (HIGHEST yield)
  Misconfig / inventory -> nuclei + references/owasp_api_top10_2023.md (API8/API9)
  Injection / SSRF    -> payloads/injection.txt

Parallelism Hints

Run concurrently (independent I/O):

  • Spec discovery: swagger.json, openapi.json, .well-known/openapi.json, v1/api-docs, v2/api-docs.
  • Endpoint discovery: ffuf + kiterunner + katana can run on the same host.
  • Auth enumeration: collect a token per role (unauth / user / admin / service) in parallel — each is a separate login flow.
  • Nuclei exposures/, vulnerabilities/, misconfiguration/ template packs.

Keep sequential (state-dependent):

  • Spec parse must finish before endpoint-driven fuzzers can consume it.
  • Authorization matrix diffing must wait for all per-role scans to complete.
  • JWT attack chain steps are ordered (see workflows/jwt_attack_chooser.md).

Sub-Agent Delegation

Spawn one sub-agent per auth context when building the BOLA/BFLA matrix:

  • Agent U — unauthenticated
  • Agent A — user-role (account A)
  • Agent B — user-role (account B, cross-user)
  • Agent X — admin-role (if available)
  • Agent S — service / machine account (if applicable)

Each agent iterates the full endpoint list with its own token and returns {endpoint, method, status, body_hash, leaks_cross_user}. Main agent diffs the five result sets. This is the single biggest parallelism win in API pentesting.

For GraphQL, also delegate: one sub-agent enumerates all Query fields, another all Mutation fields, another maps ID-bearing types for BOLA targeting.

Reasoning Budget

  • Extended thinking — authorization matrix analysis, JWT attack-path selection, GraphQL schema-driven attack planning, business-logic flow modeling (API6).
  • Minimal / execute directly — payload fuzzing, nuclei runs, ffuf brute force, grpcurl calls, JWT decoding, spec parsing.

Multimodal Hooks

  • Screenshots of Swagger / GraphiQL / Postman UIs can accelerate spec recovery when text scraping fails.
  • For JWT and GraphQL evidence, prefer text blobs (evidence.jwt_header, evidence.graphql_query) over screenshots.

Structured Output

Every finding: schemas/finding.json. Required API-specific fields: endpoint, http_method, api_type (rest/graphql/grpc/websocket), auth_context, owasp_api_id (e.g. API1:2023).

Workflow Index

WorkflowWhen to load
workflows/rest_testing.mdREST/JSON APIs, full 7-phase runbook
workflows/graphql_testing.mdGraphQL testing, post-introspection triage
workflows/graphql_introspection_triage.mdDeciding how to get the GraphQL schema
workflows/grpc_testing.mdgRPC services (reflection or .proto-driven)
workflows/websocket_testing.mdWebSocket / socket.io / GraphQL subscriptions
workflows/jwt_attack_chooser.mdJWTs present — ordered attack chain

Methodology Index

DocWhen to load
methodology/api_recon.mdBefore attack: building endpoint + auth inventory
methodology/bola_bfla_matrix.mdAuthorization testing — highest-value phase
methodology/bounty_patterns_2024_2026.mdPost-2023 public bug-bounty TTPs (OAuth ATO, JWT request_uri, refresh-token persistence, mass-assignment, ORM leakage)

Payloads Index

FileUse
payloads/bola_idor.txtObject-ID substitution values for BOLA/IDOR
payloads/bfla_privilege.txtAdmin paths, method overrides, role-spoof headers
payloads/graphql_queries.txtIntrospection, batching, alias DoS, mutation BOLA
payloads/jwt_attacks.txtHeader / claim tampering recipes
payloads/mass_assignment.txtOver-posting keys for POST/PUT/PATCH
payloads/injection.txtSQLi, NoSQLi, cmdi, SSRF, XXE, SSTI, proto pollution

References Index

FileContent
references/owasp_api_top10_2023.mdOWASP API Top 10 (2023) table + pointers
references/tools.mdTool install / version reference

Examples Index

FileContent
examples/bola_finding.mdREST BOLA — filled-in finding JSON
examples/jwt_none_finding.mdJWT alg=none — filled-in finding JSON
examples/graphql_bola_finding.mdGraphQL mutation BOLA — finding JSON

Tools

ToolPurposeInstall
Burp SuiteHTTP intercepthttps://portswigger.net/burp
ffufHTTP fuzzergo install github.com/ffuf/ffuf/v2@latest
nucleiTemplate scannergo install github.com/projectdiscovery/nuclei/v3/cmd/nuclei@latest
jwt_toolJWT attack CLIpip install jwt_tool
graphql-copGraphQL misconfig scanpip install graphql-cop
grpcurlgRPC CLIgo install github.com/fullstorydev/grpcurl/cmd/grpcurl@latest
arjunParameter discoverypip install arjun
kiterunnerAPI route discoveryhttps://github.com/assetnote/kiterunner/releases

Full list: references/tools.md.

Last Validated

2026-04. Minimum tool versions: nuclei >= 3.3, ffuf >= 2.1, grpcurl >= 1.9, jwt_tool >= 2.2, graphql-cop >= 1.13.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/hardw00t/ai-security-arsenal/api-security">View api-security on skillZs</a>