@contrast/agent

Contrast Security Node.js Agent

This package will enable instrumentation of your Node.js application for security anaylsis and runtime protection by ContrastSecurity.com.

Unlike legacy application security testing solutions, Contrast produces accurate results without dependence on application security experts. Accuracy comes from Contrast's patented Deep Security Instrumentation technology, which integrates the most effective elements of Interactive (IAST), Static (SAST), and Dynamic (DAST) application security testing technology, software composition analysis (SCA), and configuration analysis, and delivers them directly to applications.

Contrast produces a continuous stream of accurate vulnerability and compliance risk information whenever and wherever software is run. Development, QA and Security teams get results as they develop and test software, enabling them to find and fix security flaws early in the software lifecycle, when they are easiest and cheapest to remediate.

Getting Started

Existing Contrast Node.js agent users should install and update the Contrast Node.js agent from npm. Auto-update for the Node.js agent is no longer supported. The Contrast Node.js agent follows semantic versioning (major.minor.patch).

An API key, provided by Contrast Security, is required for the agent to function.

Ensure you have installed the latest LTS (Long Term Support) version of Node.js

To install from npm using the command line (run from the app root directory):

$ npm install @contrast/agent

Usage

    Usage: node -r @contrast/agent app-main.js [agent arguments] -- [app arguments]

    Options:

        -h, --help           output usage information
        -V, --version        output the version number
        -c, --config <path>  path to agent config file

The agent expects that the contrast_security.yaml configuration file exists in the application's root directory (where the package.json file usually resides). The minimum required contrast_security.yaml setup should look something like this:

api:
  url: https://app.contrastsecurity.com
  user_name: contrast_user
  api_key: demo
  service_key: demo

Property	Description
api.api_key	Organization's API key
api.user_name	Contrast user account ID (In most cases, this is your login ID)
api.service_key	Contrast user account service key
api.url	Address of the Contrast installation you would like your agent to report to

For detailed installation and configuration instructions, see the Node.js Agent documentation.