SUPPORT

Contact Support

OPEN A TICKET

Agents in Netsparker Enterprise On-Premises

An Agent is a Docker, Linux and Windows service application that executes scans and informs the Netsparker Enterprise application.

It is available in both the Netsparker Enterprise On-Premises and On-Demand editions.

  • At least one agent must be configured for each account
  • Users with Administrator permission can configure this setting

Filter the list of agents by clicking on the search icon () next to a column title and entering search criteria, as displayed in the screenshot.

For further information on Agents, Installing and Configuring Netsparker Enterprise On-Premises, Installing a Scan Agent via Dockerization, and Installing a Scan Agent on Linux (Debian Distribution)

Managing Agents

In the Manage Agents window, you can view the details and current state of all Agents. You can also disable them and add new Agents to the list.

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 is the operating system architecture on which the Agent is installed.

Process Architecture

This is 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. From the main menu, click Agents, then Manage Agents. The Agents window is displayed.
  2. From the Agents window, click Configure New Agent.

  1. Copy the Access Token to the config file of the other Agent that you manually installed.

How to Disable an Agent

  1. From the main menu, click Agents, then Manage Agents. The Agents window is displayed.
  2. From the Agents window, select the Agent you want to disable, and click Disable in their field. The Disable Agent dialog is displayed.

  1. Click Yes, Disable.

How to View Commands for an Agent

  1. From the main menu, click Agents, then Manage Agents. The Agents window is displayed.
  2. Select the relevant agent.

  1. From the Commands dropdown, click View Agent Commands.

Managing Groups

In the Manage Groups window, you can search for and view the names of the different agent groups. You can also edit or delete their details, and add a new agent group.

How to Add a New Agent Group

  1. From the main menu, click Agents, then Manage Groups. The Agent Groups window is displayed.

  1. From the Agent Groups window, click New Agent Group. The New Agent Group window is displayed.
  2. Complete the Name and Agents fields.
  3. Click Save.

How to Edit Agent Groups

  1. From the main menu, click Agents, then Manage Groups. The Agent Groups window is displayed.
  2. From the Agent Groups window, click Edit on the field of the group you want to edit. The New Agent Group window is displayed.
  3. In the New Agent Group window, make your edits.
  4. Click Save.

How to Delete Agent Groups

  1. From the main menu, click Agents, then Manage Groups. The Agent Groups window is displayed.

  1. From the Agent Groups window, click Delete. The Delete Agent dialog is displayed.
  2. Click Yes, Delete.

Accessing Agent Logs

The Netsparker Enterprise Scanning Agent stores 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 Request Agent Logs

  1. From the main menu, click Agents, then Manage Agents.

  1. Next to the relevant Agent, click the Command dropdown and select 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. Click Download Logs. The download will start.
Netsparker

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

GET A DEMO