Jenkins : Configure the Job

Version 1.1.0 Documentation

To ensure that you are viewing the correct documentation, the title of this Informational box should reflect the most recent version of the ZAP Jenkins Plugin.

Latest Release

Jenkins Configuration

The following steps will assume Jenkins is setup as a Master with a Slave on another machine to execute the job's build and run the ZAP Security Tool.

Create a New Item

Open Jenkins
- http://127.0.0.1:8080/
Click New Item
- http://127.0.0.1:8080/view/All/newJob
  - Name: ZAP_EXAMPLE_JOB
  - Type: Freestyle project
Click OK

Create the Workspace

Go to the Job Summary Page
- http://127.0.0.1:8080/job/ZAP_EXAMPLE_JOB/
Click Configure
- http://127.0.0.1:8080/job/ZAP_EXAMPLE_JOB/configure
Restrict where this project can be run (True)
- Name of Slave where ZAP security tool is installed
Click Save
Click Build Now

New empty workspace will be created on the Slave machine

C:\Users\<USER_ID>\Jenkins\workspace\ZAP_EXAMPLE_JOB

Configure the Job to Execute ZAP

Setup the job to run ZAP security tool with a loaded session.

Configure the Job to Execute ZAP as part of a Selenium Build

Setup the job to run a Selenium step during the executing of the ZAP security tool and persist the session afterwards.

Info: This will allow ZAP security tool to act as an Intercepting Proxy. It will map all of the requests the Selenium script makes to a web app and all of the responses ZAP receives from it.

Configure the Job's Post Build Actions

Summary Display – Documentation, how to use Summary Display in your own job configuration can be found here.
Info: This plugin allows an easy and fully customized build report display. Useful for it's Post-Build action to Archive the artifacts, thus copying over the generated report(s) and ZAP log(s) into the build's directory from the workspace.
HTML Publisher – Documentation, how to use HTML Publisher in your own job configuration can be found here.
Info: This plugin publishes HTML reports. Useful for displaying the latest .html or .xhtml report.

Save

Congratulations you've successfully setup your first ZAP Jenkins Job.

Build Now

Congratulations you should have been able to run your first successful ZAP Jenkins Build.