How kr1shna35/awsprowl works
awsProwl is an operator-facing AWS security research framework for authorized assessments. Its main workflow starts in the CLI or interactive interface, configures AWS access, runs service scans or security modules, reviews findings, and exports reports. The product also includes analysis for privilege escalation, attack paths, network exposure, CI/CD, and compliance, plus six risk-oriented module categories. The README documents these capabilities; unsampled subsystems are represented at directory paths, and their internal call relationships are not asserted.
Main entry points: handlers.py Module handlers · main.py CLI entry · findings.py Finding models · tui.py Module browser
Components 19
Operator interfaces
- CLI entry
src/awsprowl/cli/main.py - Interactive shell
src/awsprowl/cli/interactive.py - Module browser
src/awsprowl/cli/ui/tui.py - Module handlers
src/awsprowl/cli/ui/handlers.py
Scan runtime
- Configuration
src/awsprowl/core/config.py - AWS credentials
src/awsprowl/core/auth.py - Scan orchestration
src/awsprowl/aws/orchestrator.py - Parallel scanning
src/awsprowl/aws/base.py - Service scanners
src/awsprowl/aws
Security modules
- Enumeration
src/awsprowl/modules/enum/__init__.py - Privilege escalation
src/awsprowl/modules/privesc/__init__.py - Active operations
src/awsprowl/modules/exploit/__init__.py - Persistence and backdoors
src/awsprowl/modules/persist/__init__.py - Data exfiltration
src/awsprowl/modules/exfil/__init__.py
Assessment analysis
- Security analysis
src/awsprowl/analysis
Findings and reports
- Finding models
src/awsprowl/analysis/findings.py - Report formatters
src/awsprowl/reports/formatters.py - Session storage
src/awsprowl/core/session.py
Other components
- Security operator
Connections 22
- Security operator → CLI entry: invokes
src/awsprowl/cli/main.py - CLI entry → Configuration: loads config
src/awsprowl/cli/main.py - CLI entry → Interactive shell: launches shell
src/awsprowl/cli/main.py - CLI entry → Module browser: launches browser
src/awsprowl/cli/main.py - Security operator → Module browser: uses
- Interactive shell → Module browser: uses browser
src/awsprowl/cli/interactive.py - Module browser → Module handlers: dispatches modules
src/awsprowl/cli/ui/tui.py - Module handlers → AWS credentials: uses credentials
src/awsprowl/cli/ui/handlers.py - Module handlers → Service scanners: calls service APIs
src/awsprowl/cli/ui/handlers.py - Security operator → Scan orchestration: requests scan
- Scan orchestration → Parallel scanning: runs scans
src/awsprowl/aws/orchestrator.py - Parallel scanning → Service scanners: dispatches scans
src/awsprowl/aws/base.py - AWS credentials → Service scanners: supplies access
src/awsprowl/aws/base.py - Enumeration → Module handlers: supports modules
- Privilege escalation → Security analysis: analyzes paths
- Active operations → Module handlers: executes actions
- Persistence and backdoors → Module handlers: executes actions
- Data exfiltration → Module handlers: exports data
- Security analysis → Finding models: produces findings
- Service scanners → Finding models: records results
- Finding models → Report formatters: formats output
src/awsprowl/reports/formatters.py - Finding models → Session storage: stores sessions