inspectra-cli 2.0.0__tar.gz → 2.1.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- inspectra_cli-2.1.0/.github/ISSUE_TEMPLATE/bug_report.yml +55 -0
- inspectra_cli-2.1.0/.github/ISSUE_TEMPLATE/feature_request.yml +39 -0
- inspectra_cli-2.1.0/.github/PULL_REQUEST_TEMPLATE.md +23 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/CHANGELOG.md +39 -19
- inspectra_cli-2.1.0/PKG-INFO +201 -0
- inspectra_cli-2.1.0/README.md +161 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/RELEASE_NOTES.md +1 -1
- inspectra_cli-2.1.0/THREAT_MODEL.md +223 -0
- inspectra_cli-2.1.0/assets/architecture.svg +68 -0
- inspectra_cli-2.1.0/assets/banner-dark.svg +22 -0
- inspectra_cli-2.1.0/assets/banner-light.svg +22 -0
- inspectra_cli-2.1.0/assets/favicon.svg +7 -0
- inspectra_cli-2.1.0/assets/logo-mark.svg +11 -0
- inspectra_cli-2.1.0/assets/palette.md +47 -0
- inspectra_cli-2.1.0/assets/social-preview.png +0 -0
- inspectra_cli-2.1.0/assets/social-preview.svg +23 -0
- inspectra_cli-2.1.0/assets/terminal-demo.svg +53 -0
- inspectra_cli-2.1.0/assets/wordmark.svg +21 -0
- inspectra_cli-2.1.0/docs/assets/make_social_png.py +43 -0
- inspectra_cli-2.1.0/docs/assets/make_terminal_svg.py +103 -0
- inspectra_cli-2.1.0/docs/benchmark.md +48 -0
- inspectra_cli-2.1.0/docs/reports/README.md +19 -0
- inspectra_cli-2.1.0/docs/reports/target1.html +159 -0
- inspectra_cli-2.1.0/docs/reports/target1.json +69 -0
- inspectra_cli-2.1.0/docs/reports/target1.sarif +172 -0
- inspectra_cli-2.1.0/docs/reports/target2.html +159 -0
- inspectra_cli-2.1.0/docs/reports/target2.json +69 -0
- inspectra_cli-2.1.0/docs/reports/target2.sarif +172 -0
- inspectra_cli-2.1.0/docs/reports/target3.html +159 -0
- inspectra_cli-2.1.0/docs/reports/target3.json +69 -0
- inspectra_cli-2.1.0/docs/reports/target3.sarif +172 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/docs/roadmap.md +3 -1
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/docs/usage.md +3 -1
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/pyproject.toml +12 -1
- inspectra_cli-2.1.0/run_benchmark.py +145 -0
- inspectra_cli-2.1.0/site/banner.svg +22 -0
- inspectra_cli-2.1.0/site/favicon.svg +7 -0
- inspectra_cli-2.1.0/site/logo-mark.svg +11 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/__init__.py +1 -1
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/baseline.py +16 -15
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/checks/context.py +9 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/checks/dns.py +32 -11
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/checks/http.py +3 -4
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/checks/tls.py +30 -1
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/cli.py +41 -6
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/models.py +6 -3
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/network.py +71 -0
- inspectra_cli-2.1.0/src/inspectra/orchestrator.py +281 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/replay.py +13 -3
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/report/json_report.py +6 -4
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/report/sarif_report.py +8 -8
- inspectra_cli-2.1.0/tests/test_concurrency.py +388 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_replay.py +11 -2
- inspectra_cli-2.0.0/PKG-INFO +0 -468
- inspectra_cli-2.0.0/README.md +0 -433
- inspectra_cli-2.0.0/docs/benchmark.md +0 -95
- inspectra_cli-2.0.0/run_benchmark.py +0 -126
- inspectra_cli-2.0.0/src/inspectra/orchestrator.py +0 -145
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/.dockerignore +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/.github/ISSUE_TEMPLATE/bug_report.md +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/.github/ISSUE_TEMPLATE/feature_request.md +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/.github/ISSUE_TEMPLATE/new_check.md +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/.github/workflows/ci.yml +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/.github/workflows/docker.yml +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/.github/workflows/pages.yml +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/.github/workflows/release.yml +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/.gitignore +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/CODE_OF_CONDUCT.md +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/CONTRIBUTING.md +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/Dockerfile +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/LICENSE +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/PUBLISH-TESTPYPI.bat +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/SECURITY.md +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/action.yml +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/demo/index.html +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/demo/server.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/docs/architecture.md +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/docs/assets/architecture.png +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/docs/assets/banner.png +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/docs/assets/cli-demo.png +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/docs/assets/dashboard-demo.png +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/docs/assets/findings.png +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/docs/assets/html-report.png +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/docs/assets/logo.png +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/docs/assets/logo.svg +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/docs/assets/report-summary.png +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/docs/assets/workflow.png +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/docs/safety.md +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/examples/sample-report/report.html +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/examples/sample-report/report.json +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/examples/sample-report/report.md +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/docker-compose.yml +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/expected.json +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/results/benchmark_results.json +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/results/target1.json +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/results/target10.json +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/results/target11.json +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/results/target12.json +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/results/target2.json +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/results/target3.json +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/results/target4.json +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/results/target5.json +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/results/target6.json +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/results/target7.json +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/results/target8.json +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/results/target9.json +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/targets/target1/server.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/targets/target10/server.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/targets/target11/server.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/targets/target12/server.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/targets/target2/server.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/targets/target3/server.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/targets/target4/server.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/targets/target5/server.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/targets/target6/server.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/targets/target7/server.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/targets/target8/server.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/lab/targets/target9/server.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/scripts/benchmark.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/scripts/generate_sample_report.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/scripts/publish-testpypi.ps1 +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/site/.nojekyll +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/site/index.html +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/site/report.html +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/site/report.json +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/site/report.md +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/__main__.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/analysis/__init__.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/analysis/recommendations.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/analysis/risk.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/checks/__init__.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/checks/directories.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/checks/fingerprint.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/checks/headers.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/checks/ports.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/checks/robots.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/data/directory_wordlist.txt +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/data/fingerprints.json +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/data/header_rules.json +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/py.typed +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/redact.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/report/__init__.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/report/html_report.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/report/markdown_report.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/report/templates/report.html.j2 +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/safety.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/src/inspectra/utils.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/conftest.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/fixtures/replay/107b5723ce35838ea43887ffc9376a0ec84f2fe57bdd5f9a7f125061ccf63ecc.json +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/fixtures/replay/60e8ee63d1b6b15b2ae35f9f6f5bd15eebbede57e329131f98d28edae4dfd34d.json +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/fixtures/replay/index.json +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_benchmark_spec.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_cli.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_directories.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_dns.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_fingerprint.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_headers.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_http.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_models.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_orchestrator.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_ports.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_redact.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_reports.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_risk.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_robots.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_safety.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_sarif.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_tls.py +0 -0
- {inspectra_cli-2.0.0 → inspectra_cli-2.1.0}/tests/test_utils.py +0 -0
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
name: Bug Report
|
|
2
|
+
description: File a bug report for Inspectra
|
|
3
|
+
title: "[Bug] "
|
|
4
|
+
labels: ["bug", "triage"]
|
|
5
|
+
body:
|
|
6
|
+
- type: markdown
|
|
7
|
+
attributes:
|
|
8
|
+
value: |
|
|
9
|
+
Thanks for reporting! Please confirm you are scanning targets you own or are
|
|
10
|
+
explicitly authorized to test.
|
|
11
|
+
- type: input
|
|
12
|
+
id: version
|
|
13
|
+
attributes:
|
|
14
|
+
label: Inspectra version
|
|
15
|
+
description: Run `inspectra --version` and paste the output.
|
|
16
|
+
placeholder: "2.1.0"
|
|
17
|
+
validations:
|
|
18
|
+
required: true
|
|
19
|
+
- type: input
|
|
20
|
+
id: target
|
|
21
|
+
attributes:
|
|
22
|
+
label: Target (only targets you own/authorize)
|
|
23
|
+
description: Hostname, IP, or URL you scanned.
|
|
24
|
+
placeholder: "http://127.0.0.1:9999"
|
|
25
|
+
validations:
|
|
26
|
+
required: true
|
|
27
|
+
- type: textarea
|
|
28
|
+
id: steps
|
|
29
|
+
attributes:
|
|
30
|
+
label: Steps to reproduce
|
|
31
|
+
description: Exact commands and flags used.
|
|
32
|
+
placeholder: |
|
|
33
|
+
inspectra scan http://127.0.0.1:9999 --yes --skip-ports --allow-private --authorized --format json
|
|
34
|
+
validations:
|
|
35
|
+
required: true
|
|
36
|
+
- type: textarea
|
|
37
|
+
id: expected
|
|
38
|
+
attributes:
|
|
39
|
+
label: Expected behavior
|
|
40
|
+
validations:
|
|
41
|
+
required: true
|
|
42
|
+
- type: textarea
|
|
43
|
+
id: actual
|
|
44
|
+
attributes:
|
|
45
|
+
label: Actual behavior
|
|
46
|
+
description: Include any error output or report excerpts.
|
|
47
|
+
validations:
|
|
48
|
+
required: true
|
|
49
|
+
- type: checkboxes
|
|
50
|
+
id: authorization
|
|
51
|
+
attributes:
|
|
52
|
+
label: Authorization
|
|
53
|
+
options:
|
|
54
|
+
- label: "I confirm I scanned only targets I own or am authorized to test."
|
|
55
|
+
required: true
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
name: Feature Request
|
|
2
|
+
description: Suggest a new check or improvement for Inspectra
|
|
3
|
+
title: "[Feature] "
|
|
4
|
+
labels: ["enhancement", "triage"]
|
|
5
|
+
body:
|
|
6
|
+
- type: markdown
|
|
7
|
+
attributes:
|
|
8
|
+
value: |
|
|
9
|
+
Feature requests must align with Inspectra's founding promise:
|
|
10
|
+
**observe, assess, explain, report — never exploit.** Exploitation,
|
|
11
|
+
brute-forcing, or payload-delivery features will be declined.
|
|
12
|
+
- type: textarea
|
|
13
|
+
id: problem
|
|
14
|
+
attributes:
|
|
15
|
+
label: Problem or gap
|
|
16
|
+
description: What limitation are you hitting?
|
|
17
|
+
placeholder: "I'd like Inspectra to also check ..."
|
|
18
|
+
validations:
|
|
19
|
+
required: true
|
|
20
|
+
- type: textarea
|
|
21
|
+
id: proposal
|
|
22
|
+
attributes:
|
|
23
|
+
label: Proposed solution
|
|
24
|
+
description: How should it work, and what output should it produce?
|
|
25
|
+
validations:
|
|
26
|
+
required: true
|
|
27
|
+
- type: input
|
|
28
|
+
id: target-example
|
|
29
|
+
attributes:
|
|
30
|
+
label: Example target (authorized only)
|
|
31
|
+
description: A target you own where this check would apply.
|
|
32
|
+
placeholder: "http://127.0.0.1:9999"
|
|
33
|
+
- type: checkboxes
|
|
34
|
+
id: authorization
|
|
35
|
+
attributes:
|
|
36
|
+
label: Authorization
|
|
37
|
+
options:
|
|
38
|
+
- label: "I confirm any example target is one I own or am authorized to test."
|
|
39
|
+
required: true
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
## Description
|
|
2
|
+
Briefly describe the change.
|
|
3
|
+
|
|
4
|
+
## Related issue
|
|
5
|
+
Link to the issue this addresses (if any).
|
|
6
|
+
|
|
7
|
+
## Type of change
|
|
8
|
+
- [ ] Bug fix
|
|
9
|
+
- [ ] New check
|
|
10
|
+
- [ ] Documentation
|
|
11
|
+
- [ ] Refactor / cleanup
|
|
12
|
+
|
|
13
|
+
## Authorization reminder
|
|
14
|
+
Inspectra is a passive assessment tool. Confirm:
|
|
15
|
+
- [ ] Any target used for testing is owned by me or explicitly authorized
|
|
16
|
+
- [ ] No exploitation, brute-forcing, or payload delivery is added
|
|
17
|
+
|
|
18
|
+
## Checklist
|
|
19
|
+
- [ ] `ruff check .` passes
|
|
20
|
+
- [ ] `ruff format --check .` passes
|
|
21
|
+
- [ ] `mypy src --strict` passes
|
|
22
|
+
- [ ] `pytest` passes
|
|
23
|
+
- [ ] Docs updated (README / docs / CHANGELOG as needed)
|
|
@@ -4,40 +4,60 @@ All notable changes to Inspectra are documented here. The format follows
|
|
|
4
4
|
[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and versions
|
|
5
5
|
follow [Semantic Versioning](https://semver.org/).
|
|
6
6
|
|
|
7
|
-
## [
|
|
7
|
+
## [2.1.0] - 2026-11-16
|
|
8
|
+
|
|
9
|
+
### Added
|
|
10
|
+
|
|
11
|
+
- **Bounded concurrency:** `--concurrency` (default 4) runs checks
|
|
12
|
+
concurrently with a bounded thread pool; `--delay` (default 0.2s)
|
|
13
|
+
applies per-host spacing between requests so sleeping never holds
|
|
14
|
+
another host's slot.
|
|
15
|
+
- **Per-host politeness:** max 2 in-flight requests per host regardless
|
|
16
|
+
of global concurrency, enforced with a per-host semaphore keyed by
|
|
17
|
+
hostname.
|
|
18
|
+
- **Per-run DNS/TLS caches:** DNS resolution and TLS handshake results
|
|
19
|
+
are cached per run keyed by host (and host+port), so each host is
|
|
20
|
+
resolved/hand-shaken at most once per scan.
|
|
21
|
+
- **Replay `skipped` reporting:** replayed scans now emit a `skipped`
|
|
22
|
+
array (`dns`, `ports`, `tls` with reason "requires live network; not
|
|
23
|
+
available in replay") and the CLI prints one line listing them,
|
|
24
|
+
instead of silently omitting raw-socket checks.
|
|
25
|
+
|
|
26
|
+
## [2.0.0] - 2026-11-14
|
|
8
27
|
|
|
9
28
|
### Added
|
|
10
29
|
|
|
11
30
|
- **Deterministic replay (M4):** `--save-fixtures DIR` records every HTTP
|
|
12
|
-
request/response to disk; `--replay DIR` replays scans entirely from
|
|
13
|
-
with zero network I/O. Two runs against the same fixtures produce
|
|
31
|
+
request/response to disk; `--replay DIR` replays scans entirely from
|
|
32
|
+
disk with zero network I/O. Two runs against the same fixtures produce
|
|
14
33
|
byte-identical JSON reports (modulo timestamps).
|
|
15
34
|
- **`evidence_hash` on findings:** `sha256` of canonical JSON evidence
|
|
16
35
|
(truncated to 16 chars), stored on every `Finding` and emitted in JSON
|
|
17
36
|
reports and SARIF `properties.evidenceHash`.
|
|
18
|
-
- **SARIF output:** `--format sarif` produces SARIF 2.1.0 compatible
|
|
19
|
-
consumable by GitHub Code Scanning.
|
|
20
|
-
- **Baseline diff:** `--save-baseline` / `--baseline` compare scans
|
|
21
|
-
a previous run; `--fail-on` applies only to new findings.
|
|
37
|
+
- **SARIF output:** `--format sarif` produces SARIF 2.1.0 compatible
|
|
38
|
+
output consumable by GitHub Code Scanning.
|
|
39
|
+
- **Baseline diff:** `--save-baseline` / `--baseline` compare scans
|
|
40
|
+
against a previous run; `--fail-on` applies only to new findings.
|
|
22
41
|
- **SSRF hardening:** validated IP pinning (DNS rebinding protection),
|
|
23
42
|
explicit blocked-network list including CGNAT (100.64/10), HTTPS→HTTP
|
|
24
43
|
downgrade rejection, per-redirect-hop re-validation.
|
|
25
|
-
- **Evidence redaction:** header lines, URL userinfo/query tokens, and
|
|
26
|
-
are redacted before any reporter serializes them.
|
|
27
|
-
with a stderr warning.
|
|
28
|
-
- **Hosted sample report:** a static report and supporting files are
|
|
29
|
-
GitHub Pages at
|
|
30
|
-
review without
|
|
44
|
+
- **Evidence redaction:** header lines, URL userinfo/query tokens, and
|
|
45
|
+
JWTs are redacted before any reporter serializes them.
|
|
46
|
+
`--no-redact` disables with a stderr warning.
|
|
47
|
+
- **Hosted sample report:** a static report and supporting files are
|
|
48
|
+
hosted on GitHub Pages at
|
|
49
|
+
https://shashu123456.github.io/Inspectra/ for recruiter review without
|
|
50
|
+
installing anything.
|
|
31
51
|
|
|
32
52
|
### Changed
|
|
33
53
|
|
|
34
54
|
- **CLI:** `--format` now accepts `sarif` and comma-separated lists
|
|
35
|
-
(`sarif,json,markdown`); `-o/--output` writes a single-format report
|
|
36
|
-
an exact path; `--fail-on` accepts `none|low|medium|high` and
|
|
37
|
-
without a baseline.
|
|
38
|
-
- **Reports:** JSON includes `evidence_hash` per finding plus `scope`
|
|
39
|
-
`redaction` metadata; SARIF includes `evidenceHash` in result
|
|
40
|
-
and scope/redaction in run properties.
|
|
55
|
+
(`sarif,json,markdown`); `-o/--output` writes a single-format report
|
|
56
|
+
to an exact path; `--fail-on` accepts `none|low|medium|high` and
|
|
57
|
+
works without a baseline.
|
|
58
|
+
- **Reports:** JSON includes `evidence_hash` per finding plus `scope`
|
|
59
|
+
and `redaction` metadata; SARIF includes `evidenceHash` in result
|
|
60
|
+
properties and scope/redaction in run properties.
|
|
41
61
|
|
|
42
62
|
## [1.0.0] — 2026-09-08
|
|
43
63
|
|
|
@@ -0,0 +1,201 @@
|
|
|
1
|
+
Metadata-Version: 2.5
|
|
2
|
+
Name: inspectra-cli
|
|
3
|
+
Version: 2.1.0
|
|
4
|
+
Summary: An open-source, explainable security assessment framework for safe and authorized security analysis.
|
|
5
|
+
Project-URL: Homepage, https://github.com/shashu123456/Inspectra
|
|
6
|
+
Project-URL: Repository, https://github.com/shashu123456/Inspectra
|
|
7
|
+
Project-URL: Changelog, https://github.com/shashu123456/Inspectra/blob/main/CHANGELOG.md
|
|
8
|
+
Project-URL: Documentation, https://shashu123456.github.io/Inspectra/
|
|
9
|
+
Project-URL: Issues, https://github.com/shashu123456/Inspectra/issues
|
|
10
|
+
Author: Inspectra contributors
|
|
11
|
+
License: MIT
|
|
12
|
+
License-File: LICENSE
|
|
13
|
+
Keywords: cli,python,security,security-audit,vulnerability-assessment
|
|
14
|
+
Classifier: Development Status :: 5 - Production/Stable
|
|
15
|
+
Classifier: Environment :: Console
|
|
16
|
+
Classifier: Intended Audience :: Developers
|
|
17
|
+
Classifier: Intended Audience :: Information Technology
|
|
18
|
+
Classifier: Intended Audience :: System Administrators
|
|
19
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
20
|
+
Classifier: Operating System :: OS Independent
|
|
21
|
+
Classifier: Programming Language :: Python :: 3
|
|
22
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
23
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
24
|
+
Classifier: Topic :: Security
|
|
25
|
+
Classifier: Topic :: System :: Networking :: Monitoring
|
|
26
|
+
Requires-Python: >=3.10
|
|
27
|
+
Requires-Dist: cryptography>=42.0
|
|
28
|
+
Requires-Dist: dnspython>=2.4.0
|
|
29
|
+
Requires-Dist: httpx>=0.27.0
|
|
30
|
+
Requires-Dist: jinja2>=3.1.0
|
|
31
|
+
Requires-Dist: python-nmap>=0.7.1
|
|
32
|
+
Requires-Dist: rich>=13.7.0
|
|
33
|
+
Provides-Extra: dev
|
|
34
|
+
Requires-Dist: mypy>=1.8.0; extra == 'dev'
|
|
35
|
+
Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
|
|
36
|
+
Requires-Dist: pytest-httpserver>=1.0.0; extra == 'dev'
|
|
37
|
+
Requires-Dist: pytest>=8.0.0; extra == 'dev'
|
|
38
|
+
Requires-Dist: ruff>=0.2.0; extra == 'dev'
|
|
39
|
+
Description-Content-Type: text/markdown
|
|
40
|
+
|
|
41
|
+
<div align="center">
|
|
42
|
+
|
|
43
|
+
<img src="https://raw.githubusercontent.com/shashu123456/Inspectra/main/assets/wordmark.svg" alt="Inspectra wordmark" width="560"/>
|
|
44
|
+
|
|
45
|
+
</div>
|
|
46
|
+
|
|
47
|
+
One command, passive security assessment for authorized targets — and nothing more.
|
|
48
|
+
|
|
49
|
+
**What it does:** scans a target you own or are authorized to test; runs DNS, TLS, HTTP, headers, robots, directories, ports, and fingerprint checks; scores posture and emits JSON/Markdown/HTML/SARIF reports.
|
|
50
|
+
|
|
51
|
+
**What it does NOT do:** it is not an offensive tool, brute-forcer, or vulnerability database. It assesses what a target willingly exposes and explains what that means. No exploitation code anywhere in the codebase.
|
|
52
|
+
|
|
53
|
+
**Safe by design:** GET-only requests, timeouts everywhere, rate-limited opt-in directory checks, first-run authorization gate (`--authorized`), and private-IP blocking unless explicitly allowed (`--allow-private`).
|
|
54
|
+
|
|
55
|
+
---
|
|
56
|
+
|
|
57
|
+
[](.github/workflows/ci.yml)
|
|
58
|
+
[](pyproject.toml)
|
|
59
|
+
[](LICENSE)
|
|
60
|
+
[](pyproject.toml)
|
|
61
|
+
[](pyproject.toml)
|
|
62
|
+
[](pyproject.toml)
|
|
63
|
+
[](https://shashu123456.github.io/Inspectra/)
|
|
64
|
+
|
|
65
|
+
---
|
|
66
|
+
|
|
67
|
+
## Terminal demo
|
|
68
|
+
|
|
69
|
+
<img src="https://raw.githubusercontent.com/shashu123456/Inspectra/main/assets/terminal-demo.svg" alt="Inspectra CLI terminal demo" width="100%"/>
|
|
70
|
+
|
|
71
|
+
*Real output from `inspectra scan` against the committed replay fixtures — not a mockup.*
|
|
72
|
+
|
|
73
|
+
---
|
|
74
|
+
|
|
75
|
+
## Quick start
|
|
76
|
+
|
|
77
|
+
```bash
|
|
78
|
+
# 1. Install
|
|
79
|
+
pip install -e ".[dev]"
|
|
80
|
+
|
|
81
|
+
# 2. Scan an authorized target (first run shows the authorization agreement)
|
|
82
|
+
inspectra scan http://127.0.0.1:9999 --yes --skip-ports --allow-private --authorized --format html
|
|
83
|
+
|
|
84
|
+
# 3. Open the self-contained HTML report
|
|
85
|
+
start inspectra-report/report.html # Windows
|
|
86
|
+
# open inspectra-report/report.html # macOS/Linux
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
Reports land in `./inspectra-report/` (`report.json` always, plus your chosen format).
|
|
90
|
+
|
|
91
|
+
---
|
|
92
|
+
|
|
93
|
+
## Output formats
|
|
94
|
+
|
|
95
|
+
| Format | Description |
|
|
96
|
+
|--------|-------------|
|
|
97
|
+
| **JSON** | Always written. Machine-readable, stable schema, timezone-safe timestamps. |
|
|
98
|
+
| **Markdown** | Default human-readable format: severity headers, summary table, posture score. |
|
|
99
|
+
| **HTML** | Self-contained, polished report with inline CSS — no external assets. |
|
|
100
|
+
| **SARIF** | SARIF 2.1.0 for CI pipelines (GitHub Code Scanning compatible). |
|
|
101
|
+
|
|
102
|
+
```bash
|
|
103
|
+
inspectra scan http://127.0.0.1:9999 --yes --skip-ports --allow-private --authorized --format sarif -o report.sarif
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
---
|
|
107
|
+
|
|
108
|
+
## GitHub Action
|
|
109
|
+
|
|
110
|
+
Run Inspectra in CI and fail on new findings:
|
|
111
|
+
|
|
112
|
+
```yaml
|
|
113
|
+
name: inspectra
|
|
114
|
+
on: [push, pull_request]
|
|
115
|
+
jobs:
|
|
116
|
+
scan:
|
|
117
|
+
runs-on: ubuntu-latest
|
|
118
|
+
steps:
|
|
119
|
+
- uses: actions/checkout@v4
|
|
120
|
+
- uses: actions/setup-python@v5
|
|
121
|
+
with: { python-version: "3.11" }
|
|
122
|
+
- run: pip install -e ".[dev]"
|
|
123
|
+
- run: |
|
|
124
|
+
inspectra scan http://127.0.0.1:9999 --yes --skip-ports --allow-private --authorized \
|
|
125
|
+
--format sarif -o inspectra.sarif
|
|
126
|
+
- uses: github/codeql-action/upload-sarif@v3
|
|
127
|
+
with: { sarif_file: inspectra.sarif }
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
---
|
|
131
|
+
|
|
132
|
+
## Baseline diff (fail on new)
|
|
133
|
+
|
|
134
|
+
Save a baseline, then compare future scans against it — `--fail-on` exits non-zero only when new findings appear:
|
|
135
|
+
|
|
136
|
+
```bash
|
|
137
|
+
inspectra scan http://127.0.0.1:9999 --yes --skip-ports --allow-private --authorized \
|
|
138
|
+
--save-baseline baseline.json
|
|
139
|
+
inspectra scan http://127.0.0.1:9999 --yes --skip-ports --allow-private --authorized \
|
|
140
|
+
--baseline baseline.json --fail-on new
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
---
|
|
144
|
+
|
|
145
|
+
## Safety model
|
|
146
|
+
|
|
147
|
+
- Private-IP blocking: private/loopback/link-local/CGNAT addresses are rejected unless `--allow-private --authorized` is both present.
|
|
148
|
+
- SSRF safety: DNS resolved once, IP pinned per connection, per-redirect-hop re-validation, HTTPS→HTTP downgrade rejected, metadata endpoints blocked (`src/inspectra/safety.py`).
|
|
149
|
+
- Redaction: secrets, JWTs, and header values redacted before any report serializes (`--no-redact` to disable, with a warning).
|
|
150
|
+
- Evidence integrity: every finding carries an `evidence_hash`; replayed scans are deterministic and report skipped raw-socket checks (`dns`, `ports`, `tls`).
|
|
151
|
+
|
|
152
|
+
See [docs/safety.md](docs/safety.md) and [THREAT_MODEL.md](THREAT_MODEL.md).
|
|
153
|
+
|
|
154
|
+
---
|
|
155
|
+
|
|
156
|
+
## Benchmark
|
|
157
|
+
|
|
158
|
+
Measured on committed replay fixtures (no network — report assembly only, not network politeness or real-target wall time):
|
|
159
|
+
|
|
160
|
+
| Mode | Runs | Avg wall (s) | Findings | Identical? | False positives |
|
|
161
|
+
|------|------|--------------|----------|------------|-----------------|
|
|
162
|
+
| Serial (`--concurrency 1 --delay 0`) | 5 | 0.103 | 9 | yes | 0 |
|
|
163
|
+
| Concurrent (`--concurrency 8 --delay 0`) | 5 | 0.023 | 9 | yes | 0 |
|
|
164
|
+
|
|
165
|
+
Concurrency changes timing, not findings — the same rule-ID set is produced at `--concurrency 1` and `--concurrency 8`. See [docs/benchmark.md](docs/benchmark.md).
|
|
166
|
+
|
|
167
|
+
---
|
|
168
|
+
|
|
169
|
+
## What it does not do
|
|
170
|
+
|
|
171
|
+
- No exploitation, payload delivery, or post-exploitation.
|
|
172
|
+
- No authentication bypass, credential cracking, or fuzzing.
|
|
173
|
+
- No vulnerability chaining or active attack simulation.
|
|
174
|
+
- No scanning of targets you do not own or are not authorized to test.
|
|
175
|
+
|
|
176
|
+
---
|
|
177
|
+
|
|
178
|
+
## Contributing
|
|
179
|
+
|
|
180
|
+
Contributions are welcome. The founding rule: **inspect, observe, assess, explain, report — never exploit.** Any contribution adding exploitation, brute-forcing, or payload delivery is declined.
|
|
181
|
+
|
|
182
|
+
See [CONTRIBUTING.md](CONTRIBUTING.md) for how to add a check.
|
|
183
|
+
|
|
184
|
+
---
|
|
185
|
+
|
|
186
|
+
## License
|
|
187
|
+
|
|
188
|
+
[MIT](LICENSE) — © 2026 Inspectra contributors.
|
|
189
|
+
|
|
190
|
+
---
|
|
191
|
+
|
|
192
|
+
## Docs & footer
|
|
193
|
+
|
|
194
|
+
- [Usage](docs/usage.md) — CLI reference, options, examples
|
|
195
|
+
- [Safety](docs/safety.md) — ethics, legal guidance, authorized-use checklist
|
|
196
|
+
- [Roadmap](docs/roadmap.md) — release history and future direction
|
|
197
|
+
- [Benchmark](docs/benchmark.md) — serial vs concurrent measurement
|
|
198
|
+
- [Threat Model](THREAT_MODEL.md) — SSRF, rebinding, authorization, redaction, evidence integrity
|
|
199
|
+
- [CHANGELOG.md](CHANGELOG.md) — notable changes per release
|
|
200
|
+
|
|
201
|
+
Replay covers HTTP-based checks. Raw-socket checks (DNS, ports, TLS handshake) are skipped because they cannot be served from fixtures.
|
|
@@ -0,0 +1,161 @@
|
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
3
|
+
<img src="https://raw.githubusercontent.com/shashu123456/Inspectra/main/assets/wordmark.svg" alt="Inspectra wordmark" width="560"/>
|
|
4
|
+
|
|
5
|
+
</div>
|
|
6
|
+
|
|
7
|
+
One command, passive security assessment for authorized targets — and nothing more.
|
|
8
|
+
|
|
9
|
+
**What it does:** scans a target you own or are authorized to test; runs DNS, TLS, HTTP, headers, robots, directories, ports, and fingerprint checks; scores posture and emits JSON/Markdown/HTML/SARIF reports.
|
|
10
|
+
|
|
11
|
+
**What it does NOT do:** it is not an offensive tool, brute-forcer, or vulnerability database. It assesses what a target willingly exposes and explains what that means. No exploitation code anywhere in the codebase.
|
|
12
|
+
|
|
13
|
+
**Safe by design:** GET-only requests, timeouts everywhere, rate-limited opt-in directory checks, first-run authorization gate (`--authorized`), and private-IP blocking unless explicitly allowed (`--allow-private`).
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
[](.github/workflows/ci.yml)
|
|
18
|
+
[](pyproject.toml)
|
|
19
|
+
[](LICENSE)
|
|
20
|
+
[](pyproject.toml)
|
|
21
|
+
[](pyproject.toml)
|
|
22
|
+
[](pyproject.toml)
|
|
23
|
+
[](https://shashu123456.github.io/Inspectra/)
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
## Terminal demo
|
|
28
|
+
|
|
29
|
+
<img src="https://raw.githubusercontent.com/shashu123456/Inspectra/main/assets/terminal-demo.svg" alt="Inspectra CLI terminal demo" width="100%"/>
|
|
30
|
+
|
|
31
|
+
*Real output from `inspectra scan` against the committed replay fixtures — not a mockup.*
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
## Quick start
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
# 1. Install
|
|
39
|
+
pip install -e ".[dev]"
|
|
40
|
+
|
|
41
|
+
# 2. Scan an authorized target (first run shows the authorization agreement)
|
|
42
|
+
inspectra scan http://127.0.0.1:9999 --yes --skip-ports --allow-private --authorized --format html
|
|
43
|
+
|
|
44
|
+
# 3. Open the self-contained HTML report
|
|
45
|
+
start inspectra-report/report.html # Windows
|
|
46
|
+
# open inspectra-report/report.html # macOS/Linux
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
Reports land in `./inspectra-report/` (`report.json` always, plus your chosen format).
|
|
50
|
+
|
|
51
|
+
---
|
|
52
|
+
|
|
53
|
+
## Output formats
|
|
54
|
+
|
|
55
|
+
| Format | Description |
|
|
56
|
+
|--------|-------------|
|
|
57
|
+
| **JSON** | Always written. Machine-readable, stable schema, timezone-safe timestamps. |
|
|
58
|
+
| **Markdown** | Default human-readable format: severity headers, summary table, posture score. |
|
|
59
|
+
| **HTML** | Self-contained, polished report with inline CSS — no external assets. |
|
|
60
|
+
| **SARIF** | SARIF 2.1.0 for CI pipelines (GitHub Code Scanning compatible). |
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
inspectra scan http://127.0.0.1:9999 --yes --skip-ports --allow-private --authorized --format sarif -o report.sarif
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
---
|
|
67
|
+
|
|
68
|
+
## GitHub Action
|
|
69
|
+
|
|
70
|
+
Run Inspectra in CI and fail on new findings:
|
|
71
|
+
|
|
72
|
+
```yaml
|
|
73
|
+
name: inspectra
|
|
74
|
+
on: [push, pull_request]
|
|
75
|
+
jobs:
|
|
76
|
+
scan:
|
|
77
|
+
runs-on: ubuntu-latest
|
|
78
|
+
steps:
|
|
79
|
+
- uses: actions/checkout@v4
|
|
80
|
+
- uses: actions/setup-python@v5
|
|
81
|
+
with: { python-version: "3.11" }
|
|
82
|
+
- run: pip install -e ".[dev]"
|
|
83
|
+
- run: |
|
|
84
|
+
inspectra scan http://127.0.0.1:9999 --yes --skip-ports --allow-private --authorized \
|
|
85
|
+
--format sarif -o inspectra.sarif
|
|
86
|
+
- uses: github/codeql-action/upload-sarif@v3
|
|
87
|
+
with: { sarif_file: inspectra.sarif }
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
---
|
|
91
|
+
|
|
92
|
+
## Baseline diff (fail on new)
|
|
93
|
+
|
|
94
|
+
Save a baseline, then compare future scans against it — `--fail-on` exits non-zero only when new findings appear:
|
|
95
|
+
|
|
96
|
+
```bash
|
|
97
|
+
inspectra scan http://127.0.0.1:9999 --yes --skip-ports --allow-private --authorized \
|
|
98
|
+
--save-baseline baseline.json
|
|
99
|
+
inspectra scan http://127.0.0.1:9999 --yes --skip-ports --allow-private --authorized \
|
|
100
|
+
--baseline baseline.json --fail-on new
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
---
|
|
104
|
+
|
|
105
|
+
## Safety model
|
|
106
|
+
|
|
107
|
+
- Private-IP blocking: private/loopback/link-local/CGNAT addresses are rejected unless `--allow-private --authorized` is both present.
|
|
108
|
+
- SSRF safety: DNS resolved once, IP pinned per connection, per-redirect-hop re-validation, HTTPS→HTTP downgrade rejected, metadata endpoints blocked (`src/inspectra/safety.py`).
|
|
109
|
+
- Redaction: secrets, JWTs, and header values redacted before any report serializes (`--no-redact` to disable, with a warning).
|
|
110
|
+
- Evidence integrity: every finding carries an `evidence_hash`; replayed scans are deterministic and report skipped raw-socket checks (`dns`, `ports`, `tls`).
|
|
111
|
+
|
|
112
|
+
See [docs/safety.md](docs/safety.md) and [THREAT_MODEL.md](THREAT_MODEL.md).
|
|
113
|
+
|
|
114
|
+
---
|
|
115
|
+
|
|
116
|
+
## Benchmark
|
|
117
|
+
|
|
118
|
+
Measured on committed replay fixtures (no network — report assembly only, not network politeness or real-target wall time):
|
|
119
|
+
|
|
120
|
+
| Mode | Runs | Avg wall (s) | Findings | Identical? | False positives |
|
|
121
|
+
|------|------|--------------|----------|------------|-----------------|
|
|
122
|
+
| Serial (`--concurrency 1 --delay 0`) | 5 | 0.103 | 9 | yes | 0 |
|
|
123
|
+
| Concurrent (`--concurrency 8 --delay 0`) | 5 | 0.023 | 9 | yes | 0 |
|
|
124
|
+
|
|
125
|
+
Concurrency changes timing, not findings — the same rule-ID set is produced at `--concurrency 1` and `--concurrency 8`. See [docs/benchmark.md](docs/benchmark.md).
|
|
126
|
+
|
|
127
|
+
---
|
|
128
|
+
|
|
129
|
+
## What it does not do
|
|
130
|
+
|
|
131
|
+
- No exploitation, payload delivery, or post-exploitation.
|
|
132
|
+
- No authentication bypass, credential cracking, or fuzzing.
|
|
133
|
+
- No vulnerability chaining or active attack simulation.
|
|
134
|
+
- No scanning of targets you do not own or are not authorized to test.
|
|
135
|
+
|
|
136
|
+
---
|
|
137
|
+
|
|
138
|
+
## Contributing
|
|
139
|
+
|
|
140
|
+
Contributions are welcome. The founding rule: **inspect, observe, assess, explain, report — never exploit.** Any contribution adding exploitation, brute-forcing, or payload delivery is declined.
|
|
141
|
+
|
|
142
|
+
See [CONTRIBUTING.md](CONTRIBUTING.md) for how to add a check.
|
|
143
|
+
|
|
144
|
+
---
|
|
145
|
+
|
|
146
|
+
## License
|
|
147
|
+
|
|
148
|
+
[MIT](LICENSE) — © 2026 Inspectra contributors.
|
|
149
|
+
|
|
150
|
+
---
|
|
151
|
+
|
|
152
|
+
## Docs & footer
|
|
153
|
+
|
|
154
|
+
- [Usage](docs/usage.md) — CLI reference, options, examples
|
|
155
|
+
- [Safety](docs/safety.md) — ethics, legal guidance, authorized-use checklist
|
|
156
|
+
- [Roadmap](docs/roadmap.md) — release history and future direction
|
|
157
|
+
- [Benchmark](docs/benchmark.md) — serial vs concurrent measurement
|
|
158
|
+
- [Threat Model](THREAT_MODEL.md) — SSRF, rebinding, authorization, redaction, evidence integrity
|
|
159
|
+
- [CHANGELOG.md](CHANGELOG.md) — notable changes per release
|
|
160
|
+
|
|
161
|
+
Replay covers HTTP-based checks. Raw-socket checks (DNS, ports, TLS handshake) are skipped because they cannot be served from fixtures.
|