How danoszz/penthera works
Penthera is an authorized security scanner for live URLs, source repositories, and macOS machines, exposed through a CLI and guided terminal flow. A scan runs the selected domain checks, combines findings, compares an optional baseline, and emits terminal, Markdown, JSON, and SARIF results. The README also documents compliance readiness, incident drafts, questionnaires, supply-chain checks, and remediation guidance. Some feature modules are unsampled; those branches are included where documented, while uncertain implementation links are omitted.
Main entry points: run-scan.js Scan orchestrator · scan-url.js URL scanner · markdown.js Markdown reports · scan-repo.js Repository scanner
Components 26
CLI and orchestration
- CLI commands
src/cli.js - Guided onboarding
src/cli/onboarding.js - Scan orchestrator
src/cli/run-scan.js
Target scanning
- URL scanner
src/scan-url.js - Repository scanner
src/scan-repo.js - Machine audit
lib/machine.js - Black-box probes
lib/blackbox - Client-auth probe
lib/blackbox/client-auth.js - OAuth probe
lib/blackbox/oauth.js - Injection probes
lib/injections.js - Scan templates
lib/templates.js - Framework discovery
lib/whitebox/frameworks.js - SBOM generation
lib/whitebox/sbom.js
Security analysis
- HTTP utilities
src/utils/http.js - Audit history
lib/audit-loop.js - OWASP mapping
lib/owasp-wstg.js - Probe plugins
lib/plugins.js
Compliance and fixes
- Compliance coverage
lib/compliance/index.js - Self-assessment
lib/compliance/self-assessment.js - Compliance documents
lib/compliance - Remediation plans
lib/remediation/index.js
Findings and reports
- Finding merger
src/cli/merge-results.js - Terminal and exports
src/reporter.js - Markdown reports
src/report/markdown.js - Security findings
Other components
- User or agent
Connections 29
- User or agent → CLI commands: requests scan
README.md - User or agent → Guided onboarding: starts guided scan
README.md - CLI commands → Scan orchestrator: runs scan
src/cli.js - Guided onboarding → Scan orchestrator: runs scan
src/cli/onboarding.js - Scan orchestrator → URL scanner: scans URL
src/cli/run-scan.js - Scan orchestrator → Repository scanner: scans repository
src/cli/run-scan.js - Scan orchestrator → Machine audit: audits machine
src/cli/run-scan.js - URL scanner → Black-box probes: runs probes
src/scan-url.js - URL scanner → Client-auth probe: probes auth
src/scan-url.js - URL scanner → Injection probes: runs probes
src/scan-url.js - URL scanner → Scan templates: uses templates
src/scan-url.js - Client-auth probe → HTTP utilities: fetches scripts
lib/blackbox/client-auth.js - OAuth probe → HTTP utilities: probes endpoints
lib/blackbox/oauth.js - Repository scanner → Framework discovery: discovers frameworks
src/scan-repo.js - Repository scanner → SBOM generation: generates SBOM
- Scan orchestrator → Finding merger: merges results
src/cli/run-scan.js - Finding merger → Security findings: produces findings
- Scan orchestrator → Audit history: compares history
- Scan orchestrator → Probe plugins: loads probes
- Scan orchestrator → Compliance coverage: builds coverage
- Compliance coverage → Self-assessment: uses assessment
lib/compliance/readiness.js - Scan orchestrator → Compliance documents: generates documents
- Scan orchestrator → Remediation plans: builds action plan
src/cli/run-scan.js - Scan orchestrator → Terminal and exports: prints and exports
src/cli/run-scan.js - Scan orchestrator → Markdown reports: writes report
src/cli/run-scan.js - Markdown reports → OWASP mapping: formats coverage
src/report/markdown.js - Markdown reports → Compliance coverage: formats coverage
src/report/markdown.js - Markdown reports → Remediation plans: formats fixes
src/report/markdown.js - Terminal and exports → OWASP mapping: tags findings
src/reporter.js