Skip to content

feat: framework-exposure pentesting checks from BootUI 2.5.0 - #279

Merged
ffroliva merged 20 commits into
release/0.8.0from
feat/0.8.0-a13
Nov 22, 2026
Merged

ffroliva merged 20 commits into
release/0.8.0from
feat/0.8.0-a13

Conversation

@ffroliva

Copy link
Copy Markdown
Owner

Summary

Ports BootUI 2.5.0's framework-exposure pentesting checks (lane A13 of the 0.8.0 plan) onto the pentesting scan. The
checks read the application's own route table and middleware configuration; no request is sent for them.

  • PT-A05-041: API documentation served by FastAPI's own handlers (Swagger UI, ReDoc, the OpenAPI schema) is
    reported, with BootUI's title, severity and recommendation.
  • PT-A05-044: uvicorn's ProxyHeadersMiddleware on the application or a mounted application is reported, matched by
    class and module.
  • The other BootUI framework-metadata checks are recorded by id as not applicable (Spring-only), adapted elsewhere or
    owned by another lane, in docs/reference/matrix-updates/0.8.0-a13.tsv.
  • The evidence is read once per scan, after the scan's single-flight is acquired and the probe returns; report reads,
    MCP and CLI reads, and a busy or refused scan read nothing. Malformed introspection (a route table that raises, a
    malformed route or middleware entry) degrades to unavailable evidence: the scan is PARTIAL with BootUI's
    endpoint-metadata gap, never an error.
  • Documentation and mount paths in evidence pass through the same masking as the other checks: only host fragments
    are masked, before the 240-character cut. Text that can carry mount paths is never copied into the report.

Tests

Every test commit was red at its named assertions before the change (scripts/dev/red_check.py); planted mutants (a
copied limitation text, masking skipped, evidence read before the probe, facts limitations ignored) are each killed
by a named test. A planted secret in a documentation path and a mount path is masked on every output surface under
MASKED and METADATA_ONLY. The worst-case limitation list is measured on the real report and every promised
statement survives the 20-entry cut. Ruff, format, pyright and the code-shape, import-boundary and citation checks
pass.

Signed-off-by: Flavio Oliva <ffroliva@gmail.com>
Explicit ids for the 38 framework-evidence checks, the coverage precedence ported from BootUI, one shared security-facts read per scan, A11's masker wiring reused with planted-secret proof on every surface, and wrong-value stubs for every test commit.

Signed-off-by: Flavio Oliva <ffroliva@gmail.com>
… A13 plan

Signed-off-by: Flavio Oliva <ffroliva@gmail.com>
The shared echo module and read_security_facts are created by A12; A13 imports
the module, extends the exposure adapter, and no longer claims A12 copies the
facts limitation text.

Signed-off-by: Flavio Oliva <ffroliva@gmail.com>
Fail closed on unavailable security facts and wrapped mounts with BootUI's configuration gap, count the limitation cap per lane, read evidence only after the single-flight, pin the PT-A05-044 and PT-A05-041 text, and cover the A02 found-first precedence.

Signed-off-by: Flavio Oliva <ffroliva@gmail.com>
evaluate takes a parameter named echo, so the sanitiser is imported by name from the shared echo module. The worst-case limitation test measures the real pre-cut list (15 entries) and asserts every promised statement and each lane's gap survives.

Signed-off-by: Flavio Oliva <ffroliva@gmail.com>
Signed-off-by: Flavio Oliva <ffroliva@gmail.com>
Signed-off-by: Flavio Oliva <ffroliva@gmail.com>
Signed-off-by: Flavio Oliva <ffroliva@gmail.com>
The tests drive the scan action over real FastAPI applications. The framework_exposure engine module, the adapter function and the report wiring are wrong-value stubs that the next commits replace.

Signed-off-by: Flavio Oliva <ffroliva@gmail.com>
PT-A05-041 and PT-A05-044 with the sorted, echoed and sanitised evidence of BootUI's checks, and BootUI's endpoint and configuration gaps.

Signed-off-by: Flavio Oliva <ffroliva@gmail.com>
One route read and the shared security facts give the documentation routes, the proxy middleware placement and the completeness of the evidence.

Signed-off-by: Flavio Oliva <ffroliva@gmail.com>
The scan reports the gaps of the route and configuration evidence, marks the scan partial when it is incomplete and states the static-evidence limits in the third standing sentence. The control tests of the FULL exposure now compare against the sanitised sentence, and the advisor ownership pins are added.

Signed-off-by: Flavio Oliva <ffroliva@gmail.com>
The deviation rows are in 0.8.0-a13.tsv and spec section 14, every other BootUI framework-metadata check is recorded by id as not applicable, adapted elsewhere or owned by another lane, and the user skill states what the two checks observe. Lane gate: parity, docs, manifest, pentesting engine and FastAPI tests, Security panel rules and advisor registry green; ruff check, ruff format --check and pyright clean.

Signed-off-by: Flavio Oliva <ffroliva@gmail.com>
Signed-off-by: Flavio Oliva <ffroliva@gmail.com>
Signed-off-by: Flavio Oliva <ffroliva@gmail.com>
Signed-off-by: Flavio Oliva <ffroliva@gmail.com>
Signed-off-by: Flavio Oliva <ffroliva@gmail.com>
Signed-off-by: Flavio Oliva <ffroliva@gmail.com>

# Conflicts:
#	plugins/sharpit/skills/sharpit/SKILL.md
Signed-off-by: Flavio Oliva <ffroliva@gmail.com>
@ffroliva
ffroliva marked this pull request as ready for review November 22, 2026 04:14
@ffroliva
ffroliva merged commit 8ebdbfe into release/0.8.0 Nov 22, 2026
45 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant