Plugin Information |
---|
View Acunetix on the plugin site for more information. |
Older versions of this plugin may not be safe to use. Please review the following warnings before using an older version:
Plugin Information
This plugin allows you to trigger automated Acunetix scans as part of your web application's build process inside of Jenkins.
Description
Acunetix is an automated web application security testing and
vulnerability management platform. Acunetix automatically crawls and
scans off-the-shelf and custom-built websites and web applications for
over 3000 web vulnerabilities to help organizations shore up their web
security.
The Acunetix Jenkins
Plugin
enables you to:
-
Trigger Acunetix scans from within Jenkins upon each build
-
Trigger Acunetix scans with built-in or custom Scan Types to only scan for specific vulnerabilities
-
Configure Jenkins to fail a build (and optionally abort the scan) as soon as a specific threat-level (high, medium or low severity) is reached
-
Automatically generate reports
After setting up the Acunetix Jenkins Plugin, you can configure any Jenkins job with a build step action to trigger an Acunetix scan. When an Acunetix scan is triggered, Jenkins will launch a scan against a Target you specify and is scanned with settings configured in Acunetix. Jenkins will pass or fail the build based on criteria you provided.
Note – The Acunetix Jenkins Plugin requires an Acunetix API key, which is only available in Acunetix Enterprise. |
Installation
To install the Acunetix Jenkins Plugin:
- In Jenkins, navigate to Manage Jenkins > Manage Plugins and select the Available tab
- Search the Jenkins Plugin Index for Acunetix
- Select Install without restart or Download and install after restart. Jenkins will install the plugin based on your preference
Configuration
To configure the Acunetix Jenkins Plugin:
- Make Acunetix reachable from hosts other than localhost
- Add the Acunetix Root CA Certificate to Jenkins
- Obtain an Acunetix API key
- Modify the Jenkins Content Security Policy (optional)
Usage
- In Jenkins, navigate to the job you wish to run an Acunetix scan in, and select Configure in the sidebar
- In the Build section, select Acunetix from the Add build step drop-down menu
- You will then be presented with the options outlined below.
- Scan Type – Choose a Scan Type with which you want the scan to run. Scan Types are used to reduce the scope of the tests the scanner runs during the scan.
- Scan Target – Choose a Scan Target you wish to scan. Scan Targets are obtained from Acunetix, with the exception of Targets requiring Manual Intervention. Targets contain part of the Target description for distinguishability between Targets that have the same URL.
- Fail build if threat level is – Choose at which threat level to fail the Jenkins build based upon the scan's threat level (High severity, Medium severity or Low Severity).
- Stop the scan when build fails – Check this checkbox if you would like to abort the scan when the fail condition in Fail build if threat level is is met. This is setting is enabled by default.
- Generate Report – Choose to a report to generate upon completion of the scan. The report will be saved in project workspace
- Click Save
FAQs
- Which edition of Acunetix do I need to use the Acunetix Jenkins Plugin?
The Acunetix Jenkins Plugin requires access to the Acunetix API and API key, which is only available in Acunetix Enterprise.
- The Target I have set-up in Acunetix is not showing in drop-down list inside Jenkins.
The Acunetix Jenkins Plugin will display all Targets in an Acunetix installation, with the exception of Targets requiring Manual Intervention as part of their Login Sequence. Please make sure that the Target you wish to select does not make use of Manual Intervention.
- How can I differentiate between multiple Targets with the same URL?
If you have multiple Targets with the same URL, it is advised that you enter a description in the Target's settings to be able to differentiate between them. The Target's description will show up in Jenkins if one is available.
- Why does a scan take long for to start?
When Jenkins attempts to start a scan, the scan is placed in a scan queue. If the scan queue is empty, then the scan will start immediately. However, if the maximum number of scans (including scheduled scans) in the scan queue is reached, the scan will wait in the queue until other scans finish processing. This also means that the Jenkins build will not finish processing until the scan is complete.
- What happens to the scan if I abort the Jenkins build?
Aborting the Jenkins build will also abort the scan. You may still view partial results inside of Acunetix. Reports will not be automatically generated if the Jenkins build is aborted (you can manually generate reports from within the Acunetix UI).
- What happens if I stop an Acunetix scan from outside Jenkins?
If a scan that was started by Jenkins is stopped from the Acunetix UI or via the Acunetix API, the Jenkins build will also be aborted. Reports will not be automatically generated if the scan is stopped (you can manually generate reports from within the Acunetix UI)
- What kind of reports can be generated from Jenkins?
All Standard reports can be generated from Jenkins (Affected Items, Developer, Executive Summary and Quick reports). Compliance reports (PCI DSS, OWASP Top 10, ISO 27001…) for the scans run by Jenkins may be generated from within the Acunetix UI.
- What happens to reports generated from Jenkins?
Reports generated from Jenkins are generated on the main application and then downloaded in project workspace. The report can be archived within job folder with post-build action "Archive the artifacts" and deleted from workspace
- How do I disable or remove the Acunetix Jenkins Plugin
Please refer to this Jenkins article on disabling and removing Jenkins plugins and associated plugin data
Changelog
Please refer to this