@saucelabs/zap

Sauce Labs OWASP ZAP Node API

The NodeJS implementation to access the OWASP ZAP API in Sauce Labs. This is a "Labs" project and for experimental use only.

Install

npm install @saucelabs/zap

Usage

Sauce Labs provides OWASP Zap instances in the cloud for you to use. You only need to authenticate with your Sauce account to access the API. Currently only the australia-southeast1 region is supported.

import SauceZAP from '@saucelabs/zap'

;(async () => {
    const zaproxy = new ZapClient({
        user: process.env.SAUCE_USERNAME,
        key: process.env.SAUCE_ACCESS_KEY,
        region: 'apac' // only supported region so far
    });

    /**
     * initiate cloud session (no other command will be accessible before)
     */
    await zaproxy.session.newSession({ commandTimeout: 1000 * 60 })

    /**
     * run ZAP commands
     */
    const { scan } = await zaproxy.spider.scan({ url: urlToScan })
    // ...

    /**
     * delete session
     */
    await zaproxy.session.deleteSession()
})().catch(console.error)

API

For a full API list, see https://www.zaproxy.org/docs/api. The Node API methods have the same signature as the API documentation.

Getting Help

For help using the OWASP ZAP API refer to:

• API Documentation;
• OWASP ZAP User Group - for asking questions;

For specific help with this Node API, contact @christian-bromann (the maintainer).

Issues

To report issues related to the OWASP ZAP Node API, bugs and enhancements requests, use the issue tracker of the main OWASP ZAP project.