Create an authenticated web application scan
You can use the basic steps in this use case to perform an authenticated Dynamic Analysis of a single URL. When running an authenticated analysis, you provide login credentials for access to the target URLs. You can also use login scripting or client certificates (recommended) to authenticate with the target URLs.
For information about Veracode API Scanning, see create an API specification scan.
Before you begin:
You have reviewed the prerequisites.
To complete this task:
-
In the Veracode Platform, select Scans & Analysis > Dynamic Analysis.
The All Dynamic Analyses page opens.
-
Select Scan Web Applications.
-
Enter a name for the Dynamic Analysis. Use a name that uniquely identifies the analysis within your organization. For example, use the scan name, the team, or business unit responsible for this application as the name of the Dynamic Analysis.
-
From the URLs/Applications dropdown menu, select Enter URLs.
-
Enter a single URL and select Add.
-
Optionally, configure additional settings for each URL. If your analysis has several URLs, you can use the search field to find a specific URL.
-
In the Visibility Settings section, select who is able to see the results of the Dynamic Analysis. Visibility settings apply to all the URL scans in the analysis.
-
Optionally, in the Organization Information section, select the business unit associated with the applications you are scanning, including the name and email address of the person responsible for the applications.
-
In the Scanning Certification section, select the checkbox to confirm that your organization has the right to scan the URLs you have provided.
-
Select Configure at the bottom of the page.
-
Select the pencil icon at the end of URL row to edit a specific URL configuration.
-
In the URL-Specific Blocklist and Allowlist section, on the Blocklist tab, select Exclude the following URLs to create a blocklist.
If you want to ensure that Veracode does not scan specific URLs, you can add them to the analysis blocklist by selecting the option Exclude the following URLs. Enter the filepath or directory path of the URLs you want to exclude from this analysis. If you enter a directory path, everything in that directory and its subdirectories are excluded. You must include the slash at the end of the URL for the analysis to consider it a directory instead of a file.
-
Add allowed host URLs in the Allowlist tab to ensure Veracode can scan the entire application.
By default, the Dynamic Analysis scans all subdirectories under the top-level domain. Because Veracode does not automatically scan the subdomains, you can include them in the scope of the scan by specifying them in the Allowlist tab. You can also change the scope of the URL scan by excluding the HTTP or HTTPS versions.
You can also change the scope of the scan by adding a subdirectory to a URL. For example, if you add
https://api.example.com/mydir/v1
, the subdirectory/mydir/v1
in the subdomainapi
is now in scope. If you want to scan all subdirectories underapi
, omit the subdirectory and addhttps://api.example.com
. Veracode recommends that you only add the specific subdirectories that you want to scan instead of adding the entire directory. -
In the Authentication section, select the Required option.
-
Select and configure an authentication method for accessing your application.
-
When you are ready to run your analysis, you can start it immediately or schedule it to run at a date up to 90 days in the future. By default, your Dynamic Analysis is not scheduled.
-
Go to the All Dynamic Analyses page, which lists all your scans and their statuses.
-
From the Actions menu at the end of the row, select View Analysis Results.
The results open in the Triage Flaws view of the selected Dynamic Analysis, listing all detected vulnerabilities.
-
You can link results from a Dynamic Analysis to an application profile to evaluate the results against policy, and see the results for all types of scans of the application aggregated in a single report.
-
Select the Dynamic Analysis Results tab of the analysis summary page and select Actions > Link to Application.
The Link to Application window opens.
-
From the list of applications, select the application to which to link results. You cannot select an application that is already linked to a URL configuration.
-
Select Save.
Next steps:
- After you link an application to the scan results, you can review the results in the Dynamic Analysis Coverage Report
- View historical details for a Dynamic Analysis.