Skip to content

All versions since 1.8.0

1.8.0

Upgrading

After upgrading an existing installation, run cxg pentest install --force. The embedded Python pentest pipeline changes in this release, and replacing the binary alone does not replace the files under ~/.cert-x-gen/pentest/. The pinned h2 dependency moves to 4.4.1, which drops Python 3.9.

Plain cxg scan now runs supplied JS probes. A directory or file that holds JS probe contracts is run through the pentest engine with zero model calls, alongside scanner templates. The combined JSON report keeps a template’s own verdict apart from the engine’s adjudicated verdict. --no-author is accepted on plain scan. It requires supplied probes, skips ranking and generation, and records zero model calls. Missing, empty or wholly invalid inputs are refused instead of generated.

Report consumers:

  • Scanner summaries split declared and inferred verdicts; engine-adjudicated rows keep their own count.
  • When subprocess traffic makes the total unknown, network_requests_measured carries the observed part and network_requests is null.
  • Discovery outcomes (skipped helpers, YAML load errors) are kept, and an all-invalid directory still writes a report.

Templates without a capability header are no longer rejected. The required capabilities are derived from the namespaces a template uses, with a warning. Unsupported capabilities are still skipped, and raw fetch and ipcRenderer bypasses are still rejected.

Added

  • cxg scan --pentest is a front door to the pentest engine. It accepts every pentest run option through shared argument definitions, and refuses scan options that don’t apply.
  • Opt-in scan CI gates: --fail-on confirmed,errored,timed-out (repeatable or comma-separated) exits 2 when a run reaches a listed status. The default exit behaviour is unchanged.
  • Engine proof for unauthenticated protected reads. A declared protected GET reads as:
    • confirmed when guest and authenticated responses match;
    • refuted when the authenticated read returns content and the guest gets 401, 403 or a login redirect;
    • inconclusive otherwise. This covers auth_api, missing_authentication (alias missing-authn) and protected metrics reads. The guest is a fresh context with no credentials.
  • Engine refutation for authorization regressions. In the same dispatch, an entitled 2xx plus a distinct attacker denial for the same method-qualified endpoint (such as GET /tasks) can be refuted. Missing, redirected or interfering controls read as inconclusive_refusal.
  • Fired-oracle routing. When a finding’s declared class can’t prove it, the engine routes through exactly one proven, request-bound oracle and keeps the original claim as provenance. Injection and file-inclusion aliases resolve before proof lookup. Forged stamps and ambiguous sibling matches can’t promote a finding.
  • --auth-dir for auth capture and listing, as well as import and verify. CERT_X_GEN_HOME is honoured for Python state.

Changed

  • Every engine HTTP request is audited: landing, inspection, health, reauthentication and identity checks, including redirects. Each audit row records the actor and purpose.
  • A reserved anonymous role binds to a separate clean guest. A credentialed saved profile named anonymous never stands in for it.
  • Python helper bytecode writes are disabled during scans.
  • Pull-request CI is two jobs: Rust (fmt, clippy, tests) and Python (pytest). Windows, Python 3.12, macOS and build jobs run on main and tags.

Fixed

  • Malformed HTTP probe calls, such as cxg.fetch({method, path}), are rejected as authoring errors. Load-time checks catch literal mistakes; runtime checks reject computed arguments before scope accounting or network dispatch and record the template as rejected. The loopback regression tests now declare their pinned aiohttp dependency.
  • HTTP argument and scope checks preserve empty paths, target URL prefixes, initial in-scope URL authentication, and ordinary JavaScript writers and aliases of engine primitives. URL credentials are removed on cross-origin raw redirects, alongside identity headers and cookies.
  • Pentest raw HTTP redirects now pass scope checks, request budgets, pacing, and auditing at every hop, including redirected methods. Out-of-scope hops stop before dispatch. Cross-origin hops discard identity headers and use a fresh cookie jar; maxRedirects: 0 still returns the original redirect response.
  • An explicit pentest method_allowlist now refuses every method outside the list, including POST and arbitrary extension methods. --destructive-ok no longer overrides an explicit list. Destructive path consent and the built-in defaults when no method list is declared retain their existing behavior.
  • cxg.fetch and cxg.fetchAs check the resolved destination host before sending requests. Probe validation rejects native network API references, aliases, dynamic imports, and script injection, directing authors to engine primitives. Source validation remains a backstop rather than a JavaScript sandbox; see the browser traffic limitations.
  • Captured auth storage-state files are written with mode 0600, and existing ones are tightened before re-capture.
  • Raw HTTP redirects pass every scope check at every hop: budget, pacing, method and canonical path. An out-of-scope hop stops before dispatch.
  • Directory scans don’t execute helpers, and don’t infer a refutation after a native transport failure. The shipped {{BaseURL}} request form executes.
  • The crate compiles again after duplicate CLI and template declarations were removed.

1.9.0

Upgrading

After upgrading an existing installation, run cxg pentest install --force. The embedded Python pentest pipeline changes in this release, and replacing the binary alone does not replace the files under ~/.cert-x-gen/pentest/.

Session liveness is now an authenticated API check, not a landing page. Capture, cxg pentest auth verify, scan pre-flight and runtime health all call one API endpoint on each profile’s own service. It defaults to /api/me and expects a 2xx; 401 and 403 always mean dead. If your application has no /api/me, its sessions now read as unverified: configure a real authenticated endpoint with --me-path, or per profile with auth import --liveness-path. --skip-health-check now skips only periodic health checks and re-authentication. It no longer bypasses the startup API check. See API session liveness and multiple services.

Request paths resolve at the service origin. fetch, fetchAs, raw, rawAs and cxg.url no longer inherit a path from a landing --target such as https://app.example/dashboard. The landing URL is still used for browser navigation. Templates that relied on the implicit prefix must name their API prefix explicitly.

Report consumers:

  • report.json and the audit footer carry profile_liveness (profile, service, origin, alive, status code, reason) and services with ready/unavailable status.
  • Exit 5 means a selected profile or service is unavailable or unverified. Probes for ready services still run, but the report is complete: false, status: incomplete.
  • Scope and transport failures are recorded in request_failures and make the run incomplete with exit 4, even when a probe returns no findings.

Added

  • Engine-owned excluded-records oracle (cxg.oracle.excludedRecords). It can refute a correct row-filtering fix. Such a fix keeps answering 200, so the refusal-control rule had nothing to observe and the fixed state stayed inconclusive. The engine issues three read-only GETs, each with its identity’s own credentials: the subject list as the attacker, the attacker’s own scoped list, and a reference list as a different identity. It compares records by key:

    • confirmed when a subject record outside the attacker’s list carries a reference value;
    • refuted (proven) when the subject is non-empty and wholly inside the attacker’s list, the reference is non-empty, and both sessions were proven alive in the same run;
    • inconclusive otherwise, naming the cause.

    The verdict binds to the finding’s endpoint and applies only to cross-identity classes. It never overturns a proven confirmation and cannot be forged from template evidence. Generation prompt v8 documents it.

  • Per-profile service and liveness settings on cxg pentest auth import: --service, --liveness-path and repeatable --liveness-status. Captures and imports save them as liveness_check: {path, expected_status}, and existing liveness_path metadata still loads.

  • Multi-service runs. Each profile opens its own service. Cross-origin cxg.fetchAs uses that identity’s API request context, so a second service no longer fails on CORS. Scope, budgets, redirects and audit still apply at every hop.

Changed

  • A denial verdict needs proof that both sessions were alive. Attacker and control liveness must come from the same run and service. Otherwise the result is inconclusive_refusal, naming the unverified profiles. An expired session can no longer be recorded as a verified mitigation.
  • One unavailable profile no longer cancels the run. Profiles keep their roster indices, only the probes that need an unavailable profile are skipped, and other services continue.
  • When an oracle observation cannot bind to a finding, triage names the measured request and the claimed endpoint. It no longer reports that the oracle saw no signal.

Fixed

  • Oracle proofs bind to findings on dynamic paths such as GET /users/{username}. Every SQLi and class-oracle router keeps the original request URL beside the substituted one. Binding accepts {param}, :param, <param> and <type:param>, but a parameter never spans more than one segment. Method, origin, query and sibling-uniqueness checks are unchanged.
  • A public landing page can no longer make an expired bearer session look alive. Redirects, HTML fallbacks and missing endpoints do not count as liveness.
  • The HTTP/2 race transport keeps reading responses already queued by a closing peer when an acknowledgment write fails. Previously those responses could be lost as all-zero statuses.

1.9.1

Upgrading

After upgrading an existing installation, run cxg pentest install --force. The fix below is in the embedded Python pentest pipeline, and replacing the binary alone does not replace the files under ~/.cert-x-gen/pentest/.

Fixed

  • cxg.oracle.excludedRecords verdicts bind when the scope has a path. With a landing scope such as --scope http://host/dashboard, the oracle measured /api/x at the service origin while the finding claimed /dashboard/api/x, so a correct row-filtering fix came back inconclusive_refusal (unverified) instead of refuted (proven), and a leak was not confirmed by the oracle. The claim is now resolved at the service origin, the way the oracle’s requests are, through both cxg scan and cxg pentest run. The other class oracles build their requests from the full --target, so their claims already bound and are unchanged.
  • cxg pentest run --help described 1.8.0 session behaviour. It said a dead session only warns without --ci and that --skip-health-check force-marks profiles alive. Since 1.9.0 an expired profile exits 5 with or without either flag, and probes for ready services still run. The --ci, --skip-health-check and exit-code 5 help now say so, and --ci reads as what it still does: refuse a world-accessible --auth-dir.

[1.9.2] Latest

Upgrading

After upgrading an existing installation, run cxg pentest install --force. These fixes are in the embedded Python pentest pipeline. cxg scan refreshes it on first use.

Fixed

  • A profile is no longer unverified, and the run no longer exits 5, because the app has no JSON /api/me. When no liveness endpoint is configured and /api/me answers 404, HTML, a redirect or nothing, the 1.8.0 landing test decides; a configured endpoint, or an /api/me answering 401/403, still decides as in 1.9.x. Remaining 1.8.0 hole: an app with no API liveness endpoint, a public landing page and an expired bearer reads as alive.
  • A supplied-probe replay drops --auth names with no loadable profile, as 1.8.0 did, so one missing profile no longer makes every kit, including anonymous ones, exit 5.
  • Identity traffic and liveness go to the --scope target again. A profile’s saved --target origin is used only for a profile imported with --service; 1.9.x sent a stale profile’s requests to another port while the verdict was recorded against the scope.
  • Request helpers keep the --scope path prefix again, so cxg.fetch/raw/url and cxg.page.probeXss agree under a scope such as http://host/app/ and an XSS that 1.8.0 confirmed confirms. cxg.oracle.excludedRecords still resolves at the origin.
  • A complete run reports status: "ok", not "complete", so a consumer that treats any status other than ok as a caveat no longer reports one; incomplete is unchanged.
  • A blocked or failed request no longer changes the exit code to 4. It is still recorded in request_failures and makes the run status: incomplete.