How aaa1234fdja/candix works
Candix is an authorization-first web security testing harness. Operators invoke scans through the CLI or API; the engine performs scope-aware preflight and reconnaissance, runs detectors over discovered endpoints, and optionally attempts gated proofs of impact. Findings feed a shared report model for multiple formats and delivery integrations. The README also documents fuzzing, scan comparison, playbooks, interactive interfaces, and a vulnerable lab. Relationships reflect excerpts, SOURCE INDEX references, and README claims; unsampled subsystem links are omitted where wiring is not shown.
Main entry points: commands.py CLI commands · engine.py Scan engine · context.py Scan context · http.py HTTP client
Components 24
Operator interfaces
- CLI commands
candix/cli/commands.py - HTTP API
candix/api/server.py
Scan runtime
- Scan context
candix/core/context.py - Authorization scope
candix/core/scope.py - Scan engine
candix/engine.py - HTTP client
candix/net/http.py - Reconnaissance
candix/recon/crawler.py - Endpoint model
candix/core/endpoint.py
Assessment capabilities
- Detector framework
candix/detectors/base.py - Findings
candix/core/finding.py - Exploit verification
candix/exploit/engine.py - Mutation fuzzing
candix/fuzz/runner.py - Verification playbooks
candix/playbooks/engine.py
Results and delivery
- Report model
candix/report/model.py - Report rendering
candix/report/builder.py - Result integrations
candix/integrations/base.py
Auxiliary workflows
- Scan comparison
candix/analysis/diff.py - Interactive shell
candix/cli/repl.py - Terminal dashboard
candix/tui/app.py - Vulnerable lab
candix/lab/app.py
Other components
- Operator
- Authorized target
- Report consumers
- Notification services
Connections 29
- Operator → CLI commands: invokes
- CLI commands → Scan engine: starts scans
candix/cli/commands.py - Operator → HTTP API: submits jobs
- HTTP API → Scan engine: runs scans
candix/api/server.py - CLI commands → Scan context: builds context
candix/cli/commands.py - HTTP API → Scan context: builds context
candix/api/server.py - Scan context → Authorization scope: provides scope
candix/core/context.py - Scan context → HTTP client: creates client
candix/core/context.py - Scan engine → HTTP client: preflights targets
candix/engine.py - Scan engine → Reconnaissance: runs recon
candix/engine.py - Reconnaissance → HTTP client: fetches pages
candix/recon/crawler.py - Reconnaissance → Endpoint model: emits endpoints
candix/recon/crawler.py - Scan engine → Detector framework: runs detectors
candix/engine.py - Detector framework → Findings: yields findings
candix/detectors/base.py - Scan engine → Exploit verification: runs gated proofs
candix/engine.py - Exploit verification → Findings: updates proofs
candix/exploit/engine.py - Scan engine → Scan context: uses shared state
candix/engine.py - Findings → Report model: populates report
candix/report/model.py - Report model → Report rendering: renders formats
- Report rendering → Report consumers: exports reports
- CLI commands → Mutation fuzzing: runs fuzzing
candix/cli/commands.py - CLI commands → Scan comparison: compares scans
- CLI commands → Verification playbooks: lists playbooks
candix/cli/commands.py - CLI commands → Result integrations: sends notifications
candix/cli/commands.py - Result integrations → Notification services: delivers results
- Operator → Interactive shell: uses shell
- Operator → Terminal dashboard: uses dashboard
- CLI commands → Vulnerable lab: starts lab
- HTTP client → Authorized target: sends requests