Scanner Group Form
The Scanner Group form creates a new group or edits an existing one. Scanner groups bundle scanners for multi-vantage-point scanning: a scan targeting a group is dispatched as separate jobs to every member scanner, producing per-scanner result sets tagged with scanner_id for vantage-point analysis.
Inputs
| Name | Description | Allowed values | Default |
|---|---|---|---|
Name | Human-readable label for this group | Non-empty string, must be unique across scanner groups (e.g., "datacenter-scanners") | — |
Description | Optional free-text note | Any text, max 10,000 characters | Empty |
Scanners | Selection of scanners to include in this group. The picker shows each scanner's status (active/pending/offline) and external IP. | At least one selection (empty groups are rejected) | None |
Gotchas
- Scanner groups are NOT load balancers — every scanner in the group runs the same scan independently. The result is N parallel scan result sets, one per scanner, tagged with scanner_id so you can compare findings between vantage points (e.g., is port 22 open from inside the network but closed from outside?).
- **When creating:** Pick group names that describe the vantage point ("aws-us-east", "office-lan"), not the count or rotation. The names appear in scan results.
- **When editing:** Adding a scanner means future scans against this group also dispatch to that scanner; removing a scanner stops new dispatches but doesn't affect in-flight or historical scans.
- Scanner groups referenced by a scan template cannot be deleted from the parent list until the references are removed.
- Scanners that are offline at scan time still receive a job assignment when they reconnect — the scan does not fail just because one group member is down. The result set will be incomplete until that scanner returns its data.
API calls (4)
| Method | Path | Description |
|---|---|---|
| GET | /api/config/scanner-groups/:id | Load an existing scanner group (Edit mode) |
| GET | /api/scanners | List available scanners for selection |
| POST | /api/config/scanner-groups | Create a new scanner group (Create mode) |
| PUT | /api/config/scanner-groups/:id | Update an existing scanner group (Edit mode) |
Related
- Scanner Groups — Parent list page
- Scanners — Members of scanner groups
- Scan Templates — Scan templates can target a scanner group instead of individual scanners