api-security

⚠️ AUTHORIZED USE ONLY This skill is for educational purposes or authorized security assessments only. You must have explicit, written permission from the system owner before using this tool. Misuse of this tool is illegal and strictly prohibited.

Mandatory confirmation gate Before running any command that probes, exploits, changes, persists on, extracts data from, or attempts credential access against a target:

Ask the user to state the exact target URL, IP, account, or resource.

Ask the user to confirm written authorization and the permitted scope.

Show the exact command(s) and explain their expected effect.

Wait for explicit confirmation in the current conversation.

Without that confirmation, remain read-only and provide defensive guidance only. Prefer a sandbox, disposable VM, or controlled lab.

API Security Testing

When to Use

An authorized assessment covers API endpoints and you need a structured discovery-to-report workflow.
Testing API authentication, authorization, or rate-limiting behavior within an approved scope.

Applicable Scenarios

REST API security testing (OpenAPI/Swagger-driven or blind testing)
GraphQL security auditing (introspection, batch queries, alias overloading)
WebSocket security testing
JWT / OAuth 2.0 authentication testing
BOLA/IDOR/BFLA authorization vulnerability detection
API rate limit bypass and DoS testing

10-Phase Testing Process

Phase 1: API Discovery and Reconnaissance

主动发现：
□ Vespasian: 无头浏览器爬取 → 自动生成 OpenAPI 3.0 / GraphQL SDL 规范
□ Entropy --discover: 从 robots.txt + JS 文件提取端点
□ Kiterunner / ffuf: 爆破未文档化的端点路径
□ 检查常见路径: /swagger.json, /openapi.json, /graphql, /api-docs

GraphQL 内省（三级尝试）：
  1. 标准内省查询
  2. 精简查询（绕过 WAF 全量封禁）
  3. 仅查 __schema { types { name } }（最小探测）

Phase 2: Authentication Testing

JWT 分析（jwt_tool / Burp）：
□ alg:none 攻击: 修改头部为 "alg":"none"，清空签名
□ 密钥混淆: RS256 公钥 → HS256 对称密钥
□ 弱 HMAC 密钥爆破: jwt_tool -C -d wordlist.txt
□ 过期/声明篡改: 修改 exp/iat/sub/role 声明
□ kid 注入: ../../etc/passwd → HMAC 签名绕过

OAuth 2.0：
□ redirect_uri 操控 → 授权码泄漏
□ CSRF via state 参数缺失
□ Token 在 Referer 头泄漏
□ PKCE 缺失检测

GraphQL 认证：
□ mutation 通过 GET 请求绕过认证（CSRF）
□ 批查询认证绕过

Phase 3: Authorization Testing (BOLA/IDOR/BFLA)

BOLA（对象级授权绕过）：
□ 遍历数字 ID: /user/1 → /user/2 → /user/3
□ 遍历 UUID
□ 遍历用户名/邮箱
□ Burp Autorize: 双会话重放对比

BFLA（功能级授权绕过）：
□ 普通用户执行管理员 API
□ HTTP 方法切换: GET → PUT → PATCH → DELETE
□ API 版本降级: /v2/admin → /v1/admin
□ 批量操作注入: {"users": [1,2,3]} → {"users": [1,2,3,admin_id]}

工具: Burp Autorize, AuthMatrix, Entropy (malicious_insider persona)

Phase 4: GraphQL Specific

内省泄漏 → 信息暴露检测
别名过载 → 100+ 别名 DoS
批查询 → 10+ 同时查询 DoS
字段重复 → __typename × 500
指令过载 → 递归 @skip/@include
循环查询 → 深度嵌套内省递归
字段建议 → 错误消息信息泄漏
GraphiQL/Playground 暴露 → IDE 公开风险
GET 突变 → CSRF 风险
追踪/调试模式 → 元数据泄漏

工具: FireTail, Escape DAST, api.sh (Phases 1-3)

Phase 5: REST Input Validation

□ HTTP 方法切换: GET→POST→PUT→DELETE→OPTIONS→PATCH
□ Content-Type 篡改: JSON→XML→multipart
□ NoSQL 注入: {"username": {"$gt": ""}}
□ SSRF via URL 参数: webhook URL/头像 URL/导入 URL
□ XXE in XML 端点
□ 参数污染: /api?role=user&role=admin
□ 批量赋值: 向请求体添加 is_admin: true

Phase 6: Business Logic and Differential Testing

□ Entropy compare: diff v1 vs v2 API → 状态码变化/字段删除/延迟回归
□ 多角色工作流测试: admin/user/readonly 权限矩阵
□ 优惠券/积分/价格操控
□ 竞态条件: 并发请求测试 TOCTOU

Phase 7: WebSocket Testing

□ 端点发现
□ 消息注入（注入 payload、原型污染）
□ 超大消息处理
□ 类型混淆
□ 跨站点 WebSocket 劫持（CSWH）

Phase 8: Rate Limiting and DoS

□ 限速绕过 via 头部: X-Forwarded-For, X-Real-IP
□ 路径变体: /api/ → /api → /Api/ → /API/
□ Slowloris 低带宽耗尽
□ GraphQL 批查询深度嵌套 DoS
□ IP 轮换测试（ProxyCat 代理池）

Phase 9: Data Exposure

□ 响应过度暴露: 对比 API 返回 vs UI 展示
□ 分页枚举: ?page=1&limit=10000
□ 错误消息信息泄漏: 堆栈跟踪/内部路径/SQL 错误
□ GraphQL 嵌套遍历访问越权数据
□ OpenAPI 规范暴露敏感端点

Phase 10: CI/CD Integration

□ Entropy --ci --watch: spec 变更时自动重跑
□ Escape DAST: 按严重度阈值自动阻断构建
□ 发现持久化为回归测试
□ StackHawk（开发者优先、ZAP 内核）

Toolchain

Tool	Purpose	Acquisition
Vespasian	Traffic → OpenAPI/GraphQL specification	GitHub: praetorian-inc/vespasian
Entropy	LLM-generated attack scenarios, 5 personas	GitHub: arjinexe/entropy-chaos
Escape DAST	Business logic security testing	escape.tech
api.sh	8-phase all-protocol attack pipeline	GitHub: Sharon-Needles/api
FireTail	GraphQL 12 specialized tests	firetail.ai
jwt_tool	Comprehensive JWT testing	GitHub: ticarpi/jwt_tool
Burp Autorize	Dual-session authorization comparison	Burp BApp Store

References

references/rest-graphql-testing.md — REST + GraphQL in-depth testing
references/jwt-oauth-testing.md — JWT + OAuth security testing

Task Completion Self-Check (MUST pass before claiming completion)

Did I execute every step in the workflow (rather than just reading)?
Did I base it on tool-index and use real tool paths?
Did I produce reproducible evidence (commands/scripts/screenshots/reports)?
Did I complete and write back the Checklist items required by RULES?

Limitations

Only run against APIs you are explicitly authorized to test.
Some checks are intrusive; prefer non-production mirrors when available.

Adapted from zhaoxuya520/reverse-skill (MIT).

About this skill

When to Use

Applicable Scenarios

10-Phase Testing Process

Phase 1: API Discovery and Reconnaissance

Phase 2: Authentication Testing

Phase 3: Authorization Testing (BOLA/IDOR/BFLA)

Phase 4: GraphQL Specific

Phase 5: REST Input Validation

Phase 6: Business Logic and Differential Testing

Phase 7: WebSocket Testing

Phase 8: Rate Limiting and DoS

Phase 9: Data Exposure

Phase 10: CI/CD Integration

Toolchain

References

Task Completion Self-Check (MUST pass before claiming completion)

Limitations