Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

STIG Scanning

The scan command group runs STIG compliance scans using available scanner tools and manages test results.

Check Scanner Availability

pretorin scan doctor

Lists which scanner tools are installed and available on your system:

ScannerDescription
OpenSCAPOpen-source SCAP scanner
InSpecChef InSpec compliance profiles
AWS Cloud ScannerAWS-native compliance scanning
Azure Cloud ScannerAzure-native compliance scanning
ManualManual review checklist

View Test Manifest

# Uses active system context
pretorin scan manifest

# Filter by STIG
pretorin scan manifest --system "My System" --stig <stig_id>

Shows which STIGs and rules are applicable to the system and which scanners can test them.

Run Scans

# Run all applicable scans
pretorin scan run

# Target a specific STIG
pretorin scan run --stig <stig_id>

# Use a specific scanner
pretorin scan run --tool openscap

# Dry run (show what would execute)
pretorin scan run --dry-run

The scan orchestrator automatically detects available scanners, assigns rules to capable tools, and collects results.

Options

OptionDescription
--system / -sTarget system (uses active context if omitted)
--stigRun only rules from this STIG benchmark
--tool / -tForce a specific scanner tool
--dry-runShow the test plan without executing

View Results

# All results for active system
pretorin scan results

# Filter by control
pretorin scan results --system "My System" --control ac-2

Shows CCI-level test results including pass/fail status, scanner used, and timestamp.

Workflow

  1. pretorin scan doctor — Verify scanner tools are installed
  2. pretorin scan manifest — Review what will be tested
  3. pretorin scan run --dry-run — Preview the test plan
  4. pretorin scan run — Execute scans
  5. pretorin scan results — Review results

Results are automatically submitted to the platform when a system context is active.