How maverickaayush/onus works
ONUS is an authorized-target vulnerability assessment tool. The principal workflow takes a domain and authorization from the operator, dispatches parallel scanning modules, handles incomplete runs, then aggregates, passively verifies, deterministically scores, and optionally adds AI explanations before persisting results for a dashboard and PDF report. Hosted deployments add account and domain-ownership verification; these features are configurable and off by default. The README documents product stages not fully represented in sampled excerpts; links based only on that documentation cite README.md.
Main entry points: scan_orchestrator.py Scan orchestrator · scan.py Scan routes · api.ts API client · main.py FastAPI application
Components 30
Operator interface
- Next.js dashboard
frontend/app/page.tsx - New scan
frontend/components/new-scan.tsx - Scan status
frontend/components/scan-status.tsx - Scan history
frontend/components/scans-list.tsx - Report dashboard
frontend/components/report-dashboard.tsx - API client
frontend/lib/api.ts
API and access
- FastAPI application
backend/main.py - Scan routes
backend/routers/scan.py - Domain verification
backend/routers/verify.py - Hosted authentication
backend/routers/auth.py
Scanning and orchestration
- Scan orchestrator
backend/tasks/scan_orchestrator.py - Network reconnaissance
backend/tasks/recon.py - Web application scan
backend/tasks/webscan.py - SSL/TLS scan
backend/tasks/ssl_tls.py - HTTP headers scan
backend/tasks/headers.py - OWASP checks
backend/tasks/owasp.py - Technology fingerprint
backend/tasks/tech_fingerprint.py - CVE scan
backend/tasks/nuclei_scan.py - Directory enumeration
backend/tasks/enumeration.py
Finding analysis
- Findings aggregator
backend/analysis/aggregator.py - Confidence verifier
backend/analysis/verifier.py - CVSS scorer
backend/analysis/cvss_scorer.py - AI descriptions
backend/analysis/ollama_client.py
Results and persistence
- PDF report generator
backend/reports/generator.py - Scan data models
backend/models.py - PostgreSQL
backend/database.py - Redis credentials
backend/tasks/auth_store.py
Other components
- Operator
- Authorized target
- Local LLM service
Connections 41
- Operator → Next.js dashboard: uses
README.md - Next.js dashboard → New scan: presents
README.md - New scan → API client: submits scan
- Scan status → API client: requests status
- Scan history → API client: requests history
- Report dashboard → API client: requests results
- API client → FastAPI application: calls API
README.md - FastAPI application → Scan routes: routes scans
backend/main.py - FastAPI application → Domain verification: routes verification
backend/main.py - FastAPI application → Hosted authentication: routes auth
backend/main.py - Scan routes → Scan orchestrator: dispatches scans
backend/routers/scan.py - Domain verification → Authorized target: checks ownership
README.md - Scan orchestrator → Network reconnaissance: dispatches module
README.md - Scan orchestrator → Web application scan: dispatches module
README.md - Scan orchestrator → SSL/TLS scan: dispatches module
README.md - Scan orchestrator → HTTP headers scan: dispatches module
README.md - Scan orchestrator → OWASP checks: dispatches module
README.md - Scan orchestrator → Technology fingerprint: dispatches module
README.md - Scan orchestrator → CVE scan: dispatches module
README.md - Scan orchestrator → Directory enumeration: dispatches module
README.md - Network reconnaissance → Authorized target: scans target
README.md - Web application scan → Authorized target: scans target
README.md - SSL/TLS scan → Authorized target: scans target
README.md - HTTP headers scan → Authorized target: scans target
README.md - OWASP checks → Authorized target: scans target
README.md - Technology fingerprint → Authorized target: scans target
README.md - CVE scan → Authorized target: scans target
README.md - Directory enumeration → Authorized target: scans target
README.md - Scan orchestrator → Findings aggregator: aggregates findings
backend/tasks/scan_orchestrator.py - Scan orchestrator → Confidence verifier: verifies findings
backend/tasks/scan_orchestrator.py - Scan orchestrator → CVSS scorer: scores findings
backend/tasks/scan_orchestrator.py - Scan orchestrator → AI descriptions: describes findings
backend/tasks/scan_orchestrator.py - AI descriptions → Local LLM service: requests analysis
README.md - Scan orchestrator → Scan data models: stores results
backend/tasks/scan_orchestrator.py - Scan data models → PostgreSQL: persists records
backend/models.py - Scan routes → Redis credentials: stores credentials
backend/tasks/auth_store.py - Scan orchestrator → PDF report generator: enables report
README.md - PDF report generator → Scan data models: reads scan data
backend/reports/generator.py - Scan routes → Scan data models: reads and writes scans
backend/routers/scan.py - Scan routes → PostgreSQL: queries records
backend/routers/scan.py - Report dashboard → PDF report generator: downloads report
README.md