Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Wiki Markup
{jenkins-plugin-info:ibm-security-appscanstandard-scanner}

Project Description

The purpose of this plugin is to allow Jenkins to perform dynamic analysis with IBM AppScan Standard with minimal configuration.

...

  • Select the Available Plugins tab
  • Search for AppScan Standard
  •    
  • Select and install. 

Plugin Configuration

  1. From the Jenkins homepage, click Manage Jenkins and then Global Tool Configuration
  2. 
  3. Scroll down the page and locate the section titled AppScan Standard
  4. Click Add AppScan Standard
  5. Fill out the AppScan Standard form

...

  1. Create a new job or access an existing job
  2. Select Configure
  3. Select "Add build step" and select "Run AppScan Standard"
  4.    
  5. Complete the fields that appear:
  6.    
  7.  Installation will show the name you provided for the installation on the global configuration screen.
      1.  If you have not added an installation, please go the the Jenkins Global Tool Configuration link under Manage Jenkins.
      2.  If you only have one installation configured, the installation should be selected for you. If you plan to execute AppScan Standard on multiple Jenkins nodes, you may need to configure multiple installation paths.
    1. Starting URL is the URL AppScan Standard will use to run the spiders on to find compile a list of URIs to scan.
    2. Authenticated Scan will scan the website logged in as the provided account, this will provide better scanning results.
      1. Recorded Login Sequence uses a recorded login sequence (you must generate it using AppScan Standard previously) to login.
      2. Form Based Authentication tries to login automatically using the credentials provided, this method may fail depending on your website's authentication configuration.
    3. Generate Report will generate and save a report with the vulnerabilities found by AppScan Standard.
      1. Report title the generated report will be saved using this title for the name.
      2. HTML Report saves the report in HTML format.
      3. PDF saves the report in PDF format.
        1. You can save both formats in one run.
    4. Advanced configurations that can be applied to the scan
      1.    
      2. Include URLs for Scanning allows you to manually include URLs for scanning in case the spiders miss them
      3. Test Policy File Path will use the specified test policy instead of the default options
      4. Additional Commands can be used to execute additional options available in the command line interface that are not available in plugin's graphical user interface.
    5. If you need help filling in any field, check the help description by pressing the ? icon
      1.    
  8. Click Save at the bottom
  9. Run the job.

...

Setting a parameter on the build would look something like the image below.



Using HTML Publisher Plugin with AppScan Standard Plugin

...

  1. Select Generate a Report, insert a Report Title and check HTML Report
    1. 
  2. In the Post-build Actions add Publish HTML reports, press Add and fill it in to match the settings from AppScan Standard Plugin (report title must match Index page[s])
    1. 

When the build completes you will have a new item in the job's page, press it to access the report generated by AppScan Standard.


The expected result should be similar to the image below if you allow CSS in Jenkins, if you only see text then CSS is most likely blocked (set by default), this link explains how to change that option.

If you change the CSS options, they won't be applied to the current report, you must re-run the build/scan.



Compatibility

This version of the plugin was tested with Jenkins 2.0, 2.7 and 2.17 and IBM Security AppScan Standard 9.0.3.

...