Skip to content

Add Prowler and ScoutSuite importers to scanimport plugin - #674

Merged
MWedl merged 1 commit into
Syslifters:mainfrom
cvanes:feat/scanimport-prowler-scoutsuite
Jul 24, 2026
Merged

Add Prowler and ScoutSuite importers to scanimport plugin#674
MWedl merged 1 commit into
Syslifters:mainfrom
cvanes:feat/scanimport-prowler-scoutsuite

Conversation

@cvanes

@cvanes cvanes commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Adds native import support for AWS cloud scan output to the scanimport plugin, alongside the existing tools:

  • Prowler: parses both the CSV report and the JSON-OCSF report (the two formats Prowler v4/v5 emit by default). CSV handles v3/v4 exports (';' or ',' delimited, column-name aliases handled); OCSF is read from the array of detection findings (check id from metadata.event_code, resources from resources[].uid, remediation references carried through). Only FAIL findings are imported; PASS/MANUAL are dropped. Findings are merged by CHECK_ID so one check across many resources becomes a single finding listing every affected resource.
  • ScoutSuite: parses the default scoutsuite_results_*.js report (the scoutsuite_results = {...}; wrapper is stripped) or a plain .json export. Findings are merged per (service, finding_id); ScoutSuite's danger/warning/good_practice levels map onto the info..critical scale.

Both importers follow the existing importer conventions: auto-detection via is_format(), notes and findings output, and customisation through scanimport:prowler:<check_id> / scanimport:scoutsuite:<finding_id> finding-template tags with a built-in fallback template.

Adds tests and sample fixtures (Prowler CSV v3/v4 and JSON-OCSF, ScoutSuite .js and .json) for both tools. Fixtures are picked up by the parametrised tests in test_importers.py (format detection, notes, findings) in addition to dedicated test_prowler.py / test_scoutsuite.py unit tests.

Adds native import support for AWS cloud scan output to the scanimport
plugin, alongside the existing tools:

- Prowler: parses both the CSV report and the JSON-OCSF report (the two
  formats Prowler v4/v5 emit by default). CSV handles v3/v4 exports (';' or
  ',' delimited, column-name aliases handled); OCSF is read from the array of
  detection findings (check id from metadata.event_code, resources from
  resources[].uid, remediation references carried through). Only FAIL findings
  are imported; PASS/MANUAL are dropped. Findings are merged by CHECK_ID so one
  check across many resources becomes a single finding listing every affected
  resource.
- ScoutSuite: parses the default `scoutsuite_results_*.js` report (the
  `scoutsuite_results = {...};` wrapper is stripped) or a plain `.json`
  export. Findings are merged per (service, finding_id); ScoutSuite's
  danger/warning/good_practice levels map onto the info..critical scale.

Both importers follow the existing importer conventions: auto-detection via
is_format(), notes and findings output, and customisation through
`scanimport:prowler:<check_id>` / `scanimport:scoutsuite:<finding_id>`
finding-template tags with a built-in fallback template.

Adds tests and sample fixtures (Prowler CSV v3/v4 and JSON-OCSF, ScoutSuite
.js and .json) for both tools. Fixtures are picked up by the parametrised
tests in test_importers.py (format detection, notes, findings) in addition to
dedicated test_prowler.py / test_scoutsuite.py unit tests.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@CLAassistant

CLAassistant commented Jul 22, 2026

Copy link
Copy Markdown

CLA assistant check
All committers have signed the CLA.

@MWedl

MWedl commented Jul 24, 2026

Copy link
Copy Markdown
Collaborator

Looks great. Thank you for your contribution

@MWedl
MWedl merged commit 9deda2a into Syslifters:main Jul 24, 2026
1 check 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.

3 participants