Run scans

Infrastructure Checks

Vulnerability scans, network discovery, patching checks, domain OSINT and container images, with the AI Pentest agent as the default.

View as Markdown

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 needWhere it is setHow to check
The targets allowed for your teamTeams, 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 PentestTeams, AI tab. See AI providers.scansuite-ci --scan-type infra --list-scanners: ai_pentest must not say NOT AVAILABLE.
OpenVAS, only if you use itTeams, Scanning tab, Scanner engines card.The OpenVAS block shows a connected badge.
Nessus, only if you use itShared 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 ChecksTeams, 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 OSINTTeams, Integrations tab, Enrichment services. Optional: without them the scan returns less.The card shows the keys as saved.
A productProducts 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

  1. 01
    Open the form

    Select Infrastructure Checks in the sidebar. The page title reads Infrastructure Scan.

  2. 02
    Choose the scan type

    Select Scan Type under Infrastructure Engine Settings: Vulnerability Scan, Network Discovery, Local Patching Checks, Domains OSINT or Docker Image Scan.

  3. 03
    Choose 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.

  4. 04
    Set the options of the type

    For a Vulnerability Scan: the scanners, Ping hosts and Scan ports. See the sections below.

  5. 05
    Select 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

FieldWhat it doesDefaultWhen to change it
Saved Scans, Delete saved scan (bin)Load or delete a scan you saved or scheduled. Lists only your own.NewTo edit a schedule.
IPs, hosts or domainsThe targets: 10.20.30.40, 10.20.40.40-45, 10.20.50.0/24, example.com; for a Docker Image Scan, the image.EmptyAlways.
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.EmptySee AI Pentest.
Frequency, Date, Run or save, TimeRun now, or save the scan to run later or repeatedly.Once, Run nowSee Schedule the scan.
Product / Eng IDThe product the results are filed under.The newest productAlways check it.
Ping hostsYes: only hosts that answer ping are port-scanned. No: every address is scanned.NoYes on large internal networks, where it saves a great deal of time. Keep No for hosts behind firewalls that drop ping.
Scan portsAll TCP, Top 1000 TCP/UDP, All TCP/UDP (slowest), PCI External Scan, or Custom.All TCPCustom to give your own list.
Port numbersShown 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.EmptyWith Custom.
Select Scan TypeWhat the scan does, see below.Vulnerability ScanPer 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:.

ScannerWhat it doesDefault
OpenVASOpen-source vulnerability scanner. Needs OpenVAS in the team's Scanner engines card.Off
NessusCommercial vulnerability scanner on the shared Nessus. The runs left are shown next to its name.Off
Discovery pre-scanFinds live hosts first; Nessus and OpenVAS then scan only those hosts and the open ports found. No effect without Nessus or OpenVAS.Off
NucleiFast template checks for exposed services. Included in a standard installation.Off
Custom RulesYour 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
BruteforcerChecks 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 assessmentThe 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.

Infrastructure vulnerability scan options
Vulnerability scan configuration

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.

Network discovery options
Network discovery configuration

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.

TargetsHost names, IP addresses, networks and ranges.
Ubuntu16.04 to 24.04
Red Hat7 to 9
Debian9 to 12
OpenVASSigns in with a user name and password or a user name and SSH key. Results go to DefectDojo when the team has it connected.
VulsSigns 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:

Target
public.ecr.aws/portswigger/dastardly:latest

The 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

bash
# 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-ping

Infrastructure 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