api-recon-and-docs について
REST、モバイル、GraphQL APIのセキュリティテスト向け偵察スキルです。入口、ドキュメント、バージョン、未記載パラメーターを調べ、発見内容に応じた次のテストへ案内します。
主な機能
- 01API入口の発見
- 02ドキュメントとスキーマの探索
- 03旧版およびモバイル向けパスの特定
- 04任意フィールドとロール差の抽出
- 05発見内容に応じた後続テストの選定
活用シーン
- 01テスト前のAPI範囲の把握
- 02クライアントスクリプトからのエンドポイント探索
- 03管理用エンドポイントやフィールドの確認
- 04旧版または未記載APIの特定
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/api-recon-and-docsを入力して読み込まれたか確認します。
詳細
スキル：API の調査とドキュメント — エンドポイント、スキーマ、バージョンの範囲
AI LOAD INSTRUCTION：対象が REST、モバイル、または GraphQL API であり、悪用の前にエンドポイント、ドキュメント、バージョン、隠れた攻撃対象領域を列挙する必要がある場合は、最初にこのスキルを使用してください。
1. 主な目標
- 到達可能な API エントリーポイントをすべて特定します。
- スキーマ、任意のフィールド、ロールごとの差異を抽出します。
- 古いバージョン、モバイル用パス、GraphQL エンドポイント、ドキュメントに記載されていないパラメーターを特定します。
2. 調査チェックリスト
JavaScript とクライアントの調査
curl https://target/app.js | grep -oE '(/api|/rest|/graphql)[^"'\'' ]+' | sort -u
一般的なドキュメントおよびスキーマのパス
/swagger.json
/openapi.json
/api-docs
/docs
/.well-known/
/graphql
/gql
バージョンおよび製品の変遷
/api/v1/
/api/v2/
/api/mobile/v1/
/legacy/
3. ドキュメントから抽出する内容
- 任意およびドキュメントに記載されていないフィールド
- 管理者専用のリクエスト例
- 廃止予定だが、まだ有効な可能性があるエンドポイント
additionalProperties: trueのようなスキーマのヒント- フィルタリング、ソート、ID、ロール、テナントに関連するパラメーター名
4. 次の振り分け先
| 発見事項 | 次のスキル |
|---|---|
| あらゆる場所にオブジェクト ID がある | api authorization and bola |
| JWT、OAuth、ロールクレーム | api auth and jwt abuse |
| GraphQL または隠しフィールド | graphql and hidden parameters |
| 強固な認証境界があるが、ビジネスフローに疑わしい点がある | business logic vulnerabilities |
コメント
Markdown 対応