SUPPORT

Contact Support

OPEN A TICKET

Internal Agents in Netsparker Enterprise

In some organizations, some websites will only be available in the local network (and not on the internet). You can use our Internal Agent feature to scan your internal websites while the results remain on our Netsparker Enterprise servers.

You can install an internal agent in Windows, Linux, and Docker. For further information, see Installing Internal Agents.

The Internal Agents feature is available in both Netsparker Enterprise (On-Demand) and On-Premises.

Manage Agents Fields

This table lists and explains the fields in the Agents window.

Field

Description

Name

This is the name of the agent.

State

This is whether the agent is online and waiting for a scan assignment.

  • Available
  • Launching
  • Waiting
  • Scanning
  • Terminated
  • NotAvailable

Launch Date

This is the date when the agent was first available.

Last Heartbeat

This is the last time the agent communicated with the web application.

Version

This is the version number of the scan agent.

This table lists the fields displayed when you click Expand for each listed Agent.

Field

Description

Is Up To Date

This is whether the Agent is up-to-date.

Operating System

This is the operating system on which the Agent is installed.

Installed Framework

This is the .NET environment on which the Agent is running.

Operating System Architecture

This represents the operating system architecture on which the Agent is installed.

Target URL

This is the target URL of the website, including the path.

Process Architecture

This represents the process architecture on which the Agent is installed.

IP Address

This is the IPv4 version of the Agent.

How to Configure an Agent for a Website
  1. Log in to Netsparker Enterprise.
  2. From the main menu, select Websites > New Website.
  3. On the New Website page, complete the fields, as described in How to Add a Website in Netsparker Enterprise.
  4. In the Agent Mode field, select an option.

  1. Select Save.
How to Scan an Internal Website
  1. From the main menu, select Scans > New Scan.
  2. In the Target URL field, enter the URL of the internal website.

  1. From the Preferred Agent drop-down, select an internal agent to use it during the scan if there is more than one. Alternatively, you can retain the default setting (Any of the available agents), so that Netsparker Enterprise will automatically select one of them.
  2. Complete the remaining fields, and select Launch.
How to View Commands for an Agent
  1. From the main menu, select Agents > Manage Agents.
  2. On the Agents' page, select the relevant agent.
  3. From the Commands drop-down, select View Agent Commands.

The Commands window is displayed.

Accessing Agent Logs

The Netsparker Enterprise Scanning Agent stores the application logs in the Logs folder in the installation path.

With the latest version of the Agent, the last three days’ logs can be downloaded from the Manage Agents page. These logs are especially useful for troubleshooting.

How to Access Agent Logs

  1. From the main menu, select Agents Manage Agents.

  1. Next to the relevant Agent, select the Command drop-down, then Request Agent Logs.

  1. Once you confirm, the logs will be requested from the target agent and can be downloaded from the UI.

  1. Alternatively, when target logs are ready, you will receive a notification. Click the bell, then select the relevant notification.

  1. Select Download Logs. The download will start.
Netsparker

Highly accurate, fast & easy-to-use Web Application Security Scanner

Get a demo