Advanced Settings in WAS Scans

Advanced settings specify additional controls you want to implement in a web application scan.

You can configure Advanced settings when you create a scan or user-defined scan template using any Tenable-provided scan template. However, the Overview and Scan template types have more configurable Advanced settings than the Config Audit and SSL TLS template types. For more information, see Scan Templates.

The Advanced Settings options allow you to control the efficiency and performance of the scan.

General

You can configure General options in scans and user-defined scan templates based on the Overview and Scan templates only.

Setting Default Description
Overall Scan Max Time (HH:MM:SS) 08:00:00

Specifies the maximum duration the scanner runs a scan job runs before stopping, displayed in hours, minutes, and seconds.

Note: The maximum duration you can set for your overall scan max time is 99:59:59 (hours: minutes: seconds).

Enable Debug logging for this scan

disabled Specifies whether the scanner attaches available debug logs from plugins to the vulnerability output of this scan.

HTTP Settings

These settings specify the user-agent you want the scanner to identify and the HTTP response headers you want the scanner to include in requests to the web application.

You can configure Crawl Settings options in scans and user-defined scan templates based on any Tenable-provided scan template.

Setting Default Description
Use a different User Agent to identify scanner disabled

Specifies whether you want the scanner to use a user-agent header other than Chrome when sending an HTTP request.

User Agent Chrome's user-agent

Specifies the name of the user-agent header you want the scanner to use when sending an HTTP request.

By default, Tenable.io Web Application Scanning uses the user-agent that Chrome uses for the operating system and platform that corresponds to your machine's operating system and platform. For more information about Chrome's user-agents, see the Google Chrome Documentation.

You can configure this option only after you select the Use a different User Agent to identify scanner check box.

Add Scan ID HTTP Header disabled

Specifies whether the scanner adds an additional X-Tenable-Was-Scan-Id header (set with the scan ID) to all HTTP requests sent to the target, which allows you to easily identify scan jobs in web server logs and modify your scan configurations to better secure your sites.

Custom Headers none

Specifies the custom headers you want to inject into each HTTP request, in request and response format.

You can add additional custom headers by clicking the add button and typing the values for each additional header.

Note: If you enter a custom User-Agent header, that value will override the value entered in the User Agent setting box.

Screen Settings

You can configure Screen Settings options in scans and user-defined scan templates based on the Overview and Scan templates only.

Setting Default Description

Screen Width

1600

Specifies the screen width, in pixels, of the browser embedded in the scanner.

Screen Height

1200

Specifies the screen height, in pixels, of the browser embedded in the scanner.

Ignore Images

disabled

Specifies if the browser embedded in the scanner crawls or ignores images on your target web pages.

Limits

You can configure Limits options in scans and user-defined scan templates based on the Overview and Scan templates only.

Setting Default Description
Number of URLS to Crawl and Browse 10000 Specifies the maximum number of URLs the scanner attempts to crawl.
Path Directory Depth 10

Specifies the maximum number of sub-directories the scanner crawls.

For example, if your target is www.example.com, and you want the scanner to crawl www.example.com/users/myname, type 2 in the text box.

Page DOM Element Depth 5 Specifies the maximum number of HTML nested element levels the scanner crawls.
Max Response Size 500000 Specifies the maximum load size of a page, in bytes, the scanner analyzes.

If the scanner crawls a URL and the response exceeds the limit, the scanner does not analyze the page for vulnerabilities.

Request Direct Limit 1 Specifies the number of redirects the scanner follows before it stops trying to crawl the page.

Selenium Settings

These settings specify how the scanner behaves when it attempts to authenticate to a web application using your recorded Selenium credentials.

Configure these options if you configured your scan to authenticate to the web application with Selenium credentials. For more information see Credentials in WAS Scans.

You can configure Selenium Settings options in scans and user-defined scan templates based on the Overview and Scan templates only.

Setting Default Description
Page Rendering Delay 30000 Specifies the time, in milliseconds, the scanner waits for the page to render.
Command Execution Delay 500

Specifies the time, in milliseconds, the scanner waits after processing a command before proceeding to the next command.

Script Completion Delay 5000 Specifies the time, in milliseconds, the scanner waits for all commands to render new content to finish processing.

Performance Settings

Setting Default Description
Max Number of Concurrent HTTP Connections 10 Specifies the maximum number of established HTTP sessions allowed for a single host.
Max Number of HTTP Requests Per Second 25 Specifies the maximum number of HTTP requests allowed for a single host for the duration of the scan.
Slow down the scan when network congestion is detected disabled Specifies whether the scanner throttles the scan in the event of network congestion.
Network Timeout (In Seconds) 5

Specifies the time, in seconds, the scanner waits for a response from a host before aborting the scan, unless otherwise specified in a plugin.

If your internet connection is slow, Tenable recommends that you specify a longer wait time.

Browser Timeout (In Seconds) 30

Specifies the time, in seconds, the scanner waits for a response from a browser before aborting the scan, unless otherwise specified in a plugin.

If your internet connection is slow, Tenable recommends that you specify a longer wait time.

Timeout Threshold 100 Specifies the number of consecutive timeouts allowed before the scanner aborts the scan.