Decoupled Engine Architecture

VScanX achieves mathematically zero false positives using a decoupled, event-driven verification architecture. Trace target scanning domains below.

Step 1 of 5

VScanX probe modules execute high-speed concurrent fuzzer routines to isolate suspicious endpoints, flagging anomalies without initiating costly exploit payload execution.

vscanx/modules/web/ssrf_detector.pyActive Logic
class SSRFDetector(BaseModule):
    def inspect_target(self, target_url: str):
        # Scan redirect query params and flag anomalies
        for param in REDIRECT_PARAMS:
            if target_url.has_param(param):
                self.emit_anomaly(
                    type="SSRF_ANOMALY_FOUND",
                    payload={"url": target_url, "param": param}
                )
PIPELINE TELEMETRY STATUSWEB SSRF PIPELINE ACTIVE
[Telemetry] modules/web/ssrf_detector.py scanning queries for IDOR/SSRF patterns...

Decoupled Verification Benefit

VScanX decouples this validation block cleanly, ensuring zero state corruption in surrounding workflows. If shell triggers fail or contract checks return safe state variations, the engine automatically discards anomalies without emitting noisy false logs.

Instead of immediately executing local payload checks, the scanner emits a typed state anomaly contract to the Event Bus. This completely isolates fuzzer discovery from exploit validation.

vscanx/core/event_bus.pyActive Logic
class EventBus:
    def publish(self, event: AnomalyEvent):
        # Decoupled publish of typed security event contracts
        topic = f"anomaly.{event.type}"
        self.broker.publish(
            topic=topic,
            payload=event.serialize(),
            headers={"trace_id": event.trace_id}
        )
PIPELINE TELEMETRY STATUSWEB SSRF PIPELINE ACTIVE
[Telemetry] core/event_bus.py: Anomaly captured. Publishing 'SSRF_ANOMALY_FOUND' to Decoupled Channel...

Decoupled Verification Benefit

VScanX decouples this validation block cleanly, ensuring zero state corruption in surrounding workflows. If shell triggers fail or contract checks return safe state variations, the engine automatically discards anomalies without emitting noisy false logs.

The central Orchestrator subscribes to event pools and dynamic container configurations, spawning isolated execution sandboxes. This prevents local process contamination and maintains absolute clean run states.

vscanx/core/orchestrator.pyActive Logic
class ContainerOrchestrator:
    def handle_ssrf_anomaly(self, event: AnomalyEvent):
        # Dynamically spin up isolated sandbox validation container
        container = self.docker_client.containers.run(
            image="vscanx/val-web:latest",
            environment={"TARGET": event.payload["url"]},
            network_mode="sandbox_isolated",
            detach=True
        )
        return self.wait_for_validation(container)
PIPELINE TELEMETRY STATUSWEB SSRF PIPELINE ACTIVE
[Telemetry] core/orchestrator.py: Triggered isolated execution sandbox environment container...

Decoupled Verification Benefit

VScanX decouples this validation block cleanly, ensuring zero state corruption in surrounding workflows. If shell triggers fail or contract checks return safe state variations, the engine automatically discards anomalies without emitting noisy false logs.

The sandboxed validator probes standard Cloud Metadata APIs (AWS/GCP). This stage achieves 100% confidence verification: a vulnerability is only reported if structural cloud headers return successfully.

vscanx/plugins/web/metadata_validator.pyActive Logic
class CloudMetadataValidator:
    def run_validation(self, target: str):
        # Attempt verified connection to standard metadata API
        payload_url = f"{target}?next=http://169.254.169.254/latest/meta-data/"
        response = session.get(payload_url, timeout=3.0)
        
        # 100% confidence check: look for AWS structural keys
        if "ami-id" in response.text or "iam/security-credentials" in response.text:
            return VerificationResult(verified=True, confidence=1.0)
        return VerificationResult(verified=False)
PIPELINE TELEMETRY STATUSWEB SSRF PIPELINE ACTIVE
[Telemetry] plugins/web/metadata_validator.py: Issuing HTTP payload verify target 169.254.169.254...

Decoupled Verification Benefit

VScanX decouples this validation block cleanly, ensuring zero state corruption in surrounding workflows. If shell triggers fail or contract checks return safe state variations, the engine automatically discards anomalies without emitting noisy false logs.

The validated vulnerability is exported as a standardized, signature-verified finding. Because verification succeeds only on reproducible state returns, false positives are completely mathematically eliminated.

vscanx/core/reporter.pyActive Logic
class CanonicalReporter:
    def compile_finding(self, trace_id: str, result: VerificationResult):
        # Serialize highly structured, low-noise finding JSON schema
        finding = CanonicalFinding(
            trace_id=trace_id,
            plugin="web.ssrf",
            is_reproducible=result.verified,
            confidence=result.confidence,
            severity="CRITICAL"
        )
        return finding.export_json()
PIPELINE TELEMETRY STATUSWEB SSRF PIPELINE ACTIVE
[Telemetry] core/reporter.py: SUCCESS - SSRF Verified. Serializing trace logs into canonical JSON findings...

Decoupled Verification Benefit

VScanX decouples this validation block cleanly, ensuring zero state corruption in surrounding workflows. If shell triggers fail or contract checks return safe state variations, the engine automatically discards anomalies without emitting noisy false logs.

Subsystem Interaction & Execution

VScanX guarantees completely reproducible security state validation through absolute separation of discovery and proof execution.

Event Broker Decoupling

Scan stages communicate strictly by dispatching event models containing clean parameters. Because passive detectors never execute exploit algorithms directly on the target network, thread execution cycles remain highly performant and target systems are never overwhelmed with hostile anomalies.

Sandboxed Verifications

When orchestrators schedule audits, they spawn ephemeral local execution containers (e.g. gVisor sandbox pods or RPC forks). This ensures validation plugins run exploitation validation checks in completely isolated local network loops, verifying reproducibility before writing standard reports.