Infrastructure Checks
Vulnerability scans, network discovery, patching checks, domain OSINT and container images, with the AI Pentest agent as the default.
Scan hosts, networks, domains and container images from the Infrastructure page (Infrastructure Checks in the sidebar). Select Scan Type chooses what the scan does; each type takes its own options. For a new user the page opens on Vulnerability Scan with only Autonomous AI assessment (the AI Pentest agent) switched on; after that it opens with the scan type, scanners, Ping hosts and Scan ports you last submitted.
Before you start
| You need | Where it is set | How to check |
|---|---|---|
| The targets allowed for your team | Teams, Scanning tab, Infrastructure targets card. A new team allows nothing until a team admin adds networks or hosts. In the mode Only the targets listed below, also checked while the scan runs, every infrastructure scan is refused. | Check whether targets are allowed in the same card: each target is reported as allowed. |
| An AI provider, for AI Pentest | Teams, AI tab. See AI providers. | scansuite-ci --scan-type infra --list-scanners: ai_pentest must not say NOT AVAILABLE. |
| OpenVAS, only if you use it | Teams, Scanning tab, Scanner engines card. | The OpenVAS block shows a connected badge. |
| Nessus, only if you use it | Shared by all teams, set up by a system administrator. | The runs left appear next to Nessus on the form. |
| A server account, for Local Patching Checks | Teams, Scanning tab, Server account card, or a discovered credential approved as the server account on the Credentials page. | The card shows the user name. |
| Shodan and Dehashed keys, for Domains OSINT | Teams, Integrations tab, Enrichment services. Optional: without them the scan returns less. | The card shows the keys as saved. |
| A product | Products page. | It is listed under Product / Eng ID. |
Target formats, separators and the refused-target messages are the same as for web scans: see Web App Scanning, Targets. Starting a scan needs the Operator or Team admin role.
Run an infrastructure scan
- 01Open the form
Select Infrastructure Checks in the sidebar. The page title reads Infrastructure Scan.
- 02Choose the scan type
Select Scan Type under Infrastructure Engine Settings: Vulnerability Scan, Network Discovery, Local Patching Checks, Domains OSINT or Docker Image Scan.
- 03Choose the product and enter the targets
Product / Eng ID, then IPs, hosts or domains under Target Scope. Fetch targets (the cloud button) reuses the targets this product was last scanned with.
- 04Set the options of the type
For a Vulnerability Scan: the scanners, Ping hosts and Scan ports. See the sections below.
- 05Select Start Analysis
Scan submitted appears and the scan's page opens; if the scan is waiting in the queue, Scan History opens instead.
Check that it worked: the scan's page shows Queued or Started and the log fills. If the scan does not start, see the messages under Web App Scanning (If the scan does not start); they are the same here, with No valid targets provided for targets that are not accepted.
The form
| Field | What it does | Default | When to change it |
|---|---|---|---|
| Saved Scans, Delete saved scan (bin) | Load or delete a scan you saved or scheduled. Lists only your own. | New | To edit a schedule. |
| IPs, hosts or domains | The targets: 10.20.30.40, 10.20.40.40-45, 10.20.50.0/24, example.com; for a Docker Image Scan, the image. | Empty | Always. |
| Fetch targets (cloud button) | Fills the targets with those this product was last scanned with, or says Targets not found. Run OSINT scan for this product. | – | To rescan the same hosts. |
| Instructions (optional) | Guidance for the AI Pentest agent. Shown only while Autonomous AI assessment is on. | Empty | See AI Pentest. |
| Frequency, Date, Run or save, Time | Run now, or save the scan to run later or repeatedly. | Once, Run now | See Schedule the scan. |
| Product / Eng ID | The product the results are filed under. | The newest product | Always check it. |
| Ping hosts | Yes: only hosts that answer ping are port-scanned. No: every address is scanned. | No | Yes on large internal networks, where it saves a great deal of time. Keep No for hosts behind firewalls that drop ping. |
| Scan ports | All TCP, Top 1000 TCP/UDP, All TCP/UDP (slowest), PCI External Scan, or Custom. | All TCP | Custom to give your own list. |
| Port numbers | Shown for Custom. T: for TCP and U: for UDP, single ports and ranges: T:22-80,443,U:123,161. Commas, semicolons, spaces and | all separate. | Empty | With Custom. |
| Select Scan Type | What the scan does, see below. | Vulnerability Scan | Per task. |
To scan hosts you already have, tick them on the Assets page (up to 50, of one product) and choose Scan: this form opens with them as the targets.
Vulnerability Scan
Identifies open ports, running services and related vulnerabilities across the specified IP addresses or host names. Choose the scanners under Choose scanners:.
| Scanner | What it does | Default |
|---|---|---|
| OpenVAS | Open-source vulnerability scanner. Needs OpenVAS in the team's Scanner engines card. | Off |
| Nessus | Commercial vulnerability scanner on the shared Nessus. The runs left are shown next to its name. | Off |
| Discovery pre-scan | Finds live hosts first; Nessus and OpenVAS then scan only those hosts and the open ports found. No effect without Nessus or OpenVAS. | Off |
| Nuclei | Fast template checks for exposed services. Included in a standard installation. | Off |
| Custom Rules | Your own Nuclei rules from the Rules page. The form says how many will run for the product; with none it says the scanner will be skipped. See Custom rules. | Off |
| Bruteforcer | Checks the services it finds for weak and leaked credentials, using the product's credentials from the Credentials page plus common username and password pairs. Working credentials are saved to Credentials. Can lock accounts. | Off |
| Autonomous AI assessment | The AI Pentest agent, shown only for this scan type. While it is on, the other scanners do not run on their own. | On |
Ping hosts and Scan ports apply to Nessus, OpenVAS, the discovery pre-scan, Nuclei and Bruteforcer, and to Network Discovery. Local Patching Checks always use the SSH and SMB ports; the other scan types ignore both options.

Network Discovery
Discovers live hosts and open ports, and the service and version that answers on each port. It has no scanner switches; it uses Ping hosts and Scan ports. What it finds at an address is saved to every host with that address in Assets; hosts deleted there with Ignore these hosts in future scans are skipped.

Local Patching Checks
Checks for missing operating-system patches over SSH (TCP 22) for Linux and SMB/WMI (TCP 445, 139) for Windows. Hosts with these ports open are checked by both scanners below. It has no scanner switches.
| Targets | Host names, IP addresses, networks and ranges. |
| Ubuntu | 16.04 to 24.04 |
| Red Hat | 7 to 9 |
| Debian | 9 to 12 |
| OpenVAS | Signs in with a user name and password or a user name and SSH key. Results go to DefectDojo when the team has it connected. |
| Vuls | Signs in with a user name and SSH key only. Results are not uploaded to DefectDojo; an XLSX file per host is in the Report. |
Patching checks are credentialed scans. Set the team's server account first, in the Server account card on the Scanning tab of Teams, or approve a discovered credential as the server account on the Credentials page. Otherwise every host fails to authenticate.
Domains OSINT
Works from a domain name rather than a host list, so it finds the exposure you did not know to put in scope. Enter domains such as example.com, another.org. It discovers:
- Subdomains (switch on Bruteforce hostnames under OSINT Options to also guess subdomain names; off by default)
- Active hosts
- Leaked email addresses
- Compromised credentials, with a Dehashed API key
- Host service and vulnerability data, with a Shodan API key
Subdomains, email addresses and Shodan data are in the Report; subdomains are also saved to Assets. Compromised credentials found through Dehashed appear in Credentials. Without the Shodan and Dehashed keys the scan still runs and returns less.
Docker Image Scan
Scans a container image for known vulnerabilities in its packages with Trivy. Enter the full image path in the targets field, for example:
public.ecr.aws/portswigger/dastardly:latestThe image is downloaded and analysed. The team's allowed infrastructure targets are checked against the registry the image comes from, not the image name: allow public.ecr.aws for the example above, or docker.io for Docker Hub images such as nginx:1.25.
Registry authentication is not supported. Only public images can be scanned remotely; a private image must be pre-loaded on the ScanSuite worker node.
When a scan is incomplete
An OpenVAS or Nessus that is not set up is skipped with a Scanner skipped warning in the log instead of failing the scan. A scan type whose scanner images this server lacks is marked Not installed on this server. on the form. All outcomes are listed in Managing scan execution. AI Pentest is the only AI scan of infrastructure.
From a pipeline or a terminal
# Vulnerability scan of two hosts, Top 1000 ports, including hosts that do not answer ping
scansuite-ci --scan-type infra --scanners openvas,nuclei \
--target 10.0.4.10,10.0.4.11 --ports "Top 1000 TCP/UDP" --no-pingInfrastructure scans need --scanners: hosts_scan (Network Discovery), hosts_patching, osint and docker_image_scan run on their own; openvas, nessus, nuclei, nuclei_custom, hosts_bruter and ai_pentest are the Vulnerability Scan choices. Unlike the form, the client pings hosts unless you pass --no-ping. See CI/CD and automation.
Where results go
- AI Pentest, Nessus and Custom Rules always record their findings on the Vulnerabilities page (Nessus at or above the team's Lowest severity to store).
- OpenVAS, Nuclei and Docker Image Scan record theirs there too, at Medium severity and above, while the team's Store scanner findings is On (the default; Teams, Scanning tab, Scanner findings in Vulnerabilities card).
- Everything is in the scan's Report in Scan History and, when the team has DefectDojo connected, in DefectDojo (see Set up DefectDojo).
Last reviewed 2026-10-19