Web App Scanning: Add Web Applications
Tenable has added a new Web App Scanning endpoint that enables you to manually create web application assets without initiating a scan.
This endpoint enables you to define applications with greater precision using a combination of FQDN, port, protocol, and path. Manually defining applications ensures cumulative scan results are accurately attributed to the correct application, improving reporting accuracy and supporting a more application-focused scanning model. This enhancement enables more granular target definition and represents a shift from a scan-centric to an application-centric approach in Web App Scanning.
For more information, see the Targets section of the Basic Settings page in the Tenable Web App Scanning User Guide.
This following endpoint has been added:
| API Endpoint | Name | Update |
|---|---|---|
| POST /api/v2/was/applications | Add web application | Creates a web application asset with user-defined scope and optional tags. |
The endpoint accepts the following body parameters:
| Parameter | Data Type | Description |
|---|---|---|
user_defined_name | String | A unique, user-defined name for the web application asset (for example, Marketing Site). |
url | String | The primary URL of the application. This can include the protocol, FQDN, port, and specific path to define the target's scope, (for example, https://my-site.com:8443/marketing). |
tags | Array (UUID) | A list of unique tag identifiers (UUIDs) to associate with the application. Tagging an application enables you to target it specifically when launching or scheduling scans. |
Example: Add an application and assign two tags
For example, to add an application and assign two tags, you could use the following cURL request:
curl --request POST \
--url https://cloud.tenable.com/api/v2/was/applications \
--header 'X-ApiKeys: accessKey=<YOURKEY>;secretKey=<YOURKEY>' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '
{
"user_defined_name": "Developer Portal",
"url": "https://developer.tenable.com",
"tags": [
"37c1e7d7-9e74-4c66-8b5e-79fcc4e725dc",
"041f044a-e22e-4bce-a5b3-069d1c5ffabf"
]
}
'
