Deep Eye — Pentest Skill
Authorized offensive testing only. Work inside this repository’s tool surface.
Preconditions
- Written RoE / scope (hosts, paths, time, credentials).
- Config present:
config/config.yaml (from example or wizard).
- No secrets committed; use local
config/config.yaml only.
Quick start
pip install -r requirements.txt
cp config/config.example.yaml config/config.yaml # or:
python deep_eye.py --setup
python deep_eye.py -u https://TARGET -v --formats html,json
python deep_eye.py -u https://TARGET --scope-nl "only /api/* no /logout"
python deep_eye.py -u https://TARGET --retest-new reports/baseline.json
Workflow
1. Scope
- CLI:
--scope-nl "..." → utils/nl_scope.py → scope config.
- YAML:
scope.enabled, allowed_hosts, excluded_paths.
2. Recon
scanner.enable_recon: true
- Modules:
modules/reconnaissance/, optional OSINT (osint config).
- OpenAPI seed:
openapi.enabled + openapi.source.
3. Authenticated scan
| Need |
Config |
| Login macro |
login_replay.enabled, macro_path |
| Multi-role |
auth_session.enabled, roles |
| CAPTCHA skip |
captcha.enabled, skip_protected |
| Challenge (CF) |
challenge_solver.enabled |
4. Checks to enable
Edit vulnerability_scanner.enabled_checks (not CLI). High-value packs:
| Goal |
Checks |
| Core inject |
sql_injection, xss, ssrf, lfi, rfi, ssti, command_injection |
| Authz |
idor, api_bola_deep, jwt_deep, oauth_testing |
| API |
api_security, graphql_deep, openapi seed |
| Cloud |
ssrf_cloud, cloud_misconfig |
| Client/WS |
cors_csp, websocket_deep, sse_injection, supply_chain_js |
| Deep inject |
host_header_deep, crlf_header_inject_deep, hpp_pollution, ssti_engines |
| Mobile |
mobile.enabled + frida_mobile, android_static, ios_plist, mobile_ssl_pinning, mobile_ai_chain |
Payloads: payload_generation.use_ai, cve_database, OAST via scanner.oast_callback_url.
5. Post-process
Order in engine: dedupe → FP replay → evidence → RAG → compliance → AI triage → bounty → report.
| Feature |
Config |
| Dedupe |
reporting.dedupe |
| CVE enrich |
experimental.enable_cve_matching (+ optional cve_live_lookup) |
| Triage |
ai_triage.enabled |
| Bounty MD |
bug_bounty.enabled |
| Templates |
templates.enabled |
6. Manual verify + report
- Reproduce High/Critical with minimal request.
- Report formats:
reporting.formats / --formats html,json,sarif,junit,csv,xlsx.
- Diff:
python deep_eye.py --diff baseline.json current.json.
Code map
| Task |
Location |
| CLI |
deep_eye.py |
| Lifecycle |
core/scanner_engine.py |
| Checks |
core/vulnerability_scanner.py + modules/* |
| Multi-surface inject |
core/injection_surfaces.py |
| AI |
ai_providers/, tool calling on OpenAI/Claude |
| Config truth |
config/config.example.yaml |
Rules
- No unauthorized targets.
- No destructive DoS unless RoE allows.
- Redact secrets/PII in reports.
Output
## Pentest (Deep Eye)
- Target / scope:
- Config highlights:
- Commands run:
- Severity counts:
- Top findings (type → url → impact):
- Retest command:
1---2name: pentest3description: Authorized penetration testing with Deep Eye (this repo). Use for pentest, penetration test, vulnerability assessment, web/API/mobile scan, OWASP testing, /pentest. Requires written authorization. Never scan unauthorized targets.4---56# Deep Eye — Pentest Skill78Authorized offensive testing only. Work inside this repository’s tool surface.910## Preconditions11121. Written RoE / scope (hosts, paths, time, credentials).132. Config present: `config/config.yaml` (from example or wizard).143. No secrets committed; use local `config/config.yaml` only.1516## Quick start1718```bash19pip install -r requirements.txt20cp config/config.example.yaml config/config.yaml # or:21python deep_eye.py --setup2223python deep_eye.py -u https://TARGET -v --formats html,json24python deep_eye.py -u https://TARGET --scope-nl "only /api/* no /logout"25python deep_eye.py -u https://TARGET --retest-new reports/baseline.json26```2728## Workflow2930### 1. Scope3132- CLI: `--scope-nl "..."` → `utils/nl_scope.py` → `scope` config.33- YAML: `scope.enabled`, `allowed_hosts`, `excluded_paths`.3435### 2. Recon3637- `scanner.enable_recon: true`38- Modules: `modules/reconnaissance/`, optional OSINT (`osint` config).39- OpenAPI seed: `openapi.enabled` + `openapi.source`.4041### 3. Authenticated scan4243| Need | Config |44|------|--------|45| Login macro | `login_replay.enabled`, `macro_path` |46| Multi-role | `auth_session.enabled`, `roles` |47| CAPTCHA skip | `captcha.enabled`, `skip_protected` |48| Challenge (CF) | `challenge_solver.enabled` |4950### 4. Checks to enable5152Edit `vulnerability_scanner.enabled_checks` (not CLI). High-value packs:5354| Goal | Checks |55|------|--------|56| Core inject | `sql_injection`, `xss`, `ssrf`, `lfi`, `rfi`, `ssti`, `command_injection` |57| Authz | `idor`, `api_bola_deep`, `jwt_deep`, `oauth_testing` |58| API | `api_security`, `graphql_deep`, `openapi` seed |59| Cloud | `ssrf_cloud`, `cloud_misconfig` |60| Client/WS | `cors_csp`, `websocket_deep`, `sse_injection`, `supply_chain_js` |61| Deep inject | `host_header_deep`, `crlf_header_inject_deep`, `hpp_pollution`, `ssti_engines` |62| Mobile | `mobile.enabled` + `frida_mobile`, `android_static`, `ios_plist`, `mobile_ssl_pinning`, `mobile_ai_chain` |6364Payloads: `payload_generation.use_ai`, `cve_database`, OAST via `scanner.oast_callback_url`.6566### 5. Post-process6768Order in engine: dedupe → FP replay → evidence → RAG → compliance → AI triage → bounty → report.6970| Feature | Config |71|---------|--------|72| Dedupe | `reporting.dedupe` |73| CVE enrich | `experimental.enable_cve_matching` (+ optional `cve_live_lookup`) |74| Triage | `ai_triage.enabled` |75| Bounty MD | `bug_bounty.enabled` |76| Templates | `templates.enabled` |7778### 6. Manual verify + report7980- Reproduce High/Critical with minimal request.81- Report formats: `reporting.formats` / `--formats html,json,sarif,junit,csv,xlsx`.82- Diff: `python deep_eye.py --diff baseline.json current.json`.8384## Code map8586| Task | Location |87|------|----------|88| CLI | `deep_eye.py` |89| Lifecycle | `core/scanner_engine.py` |90| Checks | `core/vulnerability_scanner.py` + `modules/*` |91| Multi-surface inject | `core/injection_surfaces.py` |92| AI | `ai_providers/`, tool calling on OpenAI/Claude |93| Config truth | `config/config.example.yaml` |9495## Rules9697- No unauthorized targets.98- No destructive DoS unless RoE allows.99- Redact secrets/PII in reports.100101## Output102103```markdown104## Pentest (Deep Eye)105- Target / scope:106- Config highlights:107- Commands run:108- Severity counts:109- Top findings (type → url → impact):110- Retest command:111```