Deploying Invicti Shark (IAST) for Node.js - Docker
Invicti Shark enables you to carry out interactive security testing (IAST) in your web application in order to confirm more vulnerabilities and further minimize false positives.
- Node.js is an open-source server environment designed to build scalable network applications, as it is capable of handling a vast number of simultaneous connections with high throughput. Depending on the specific frameworks and libraries, debugging a Node.js application can be tricky though.
- You can take advantage of Invicti's unique DAST-induced IAST approach to get an inside view into how security checks and test payloads are processed within these environments. These additional insights will let you isolate the location and root cause of security defects quickly.
For further information, Invicti adds IAST support for Node.js.
The most principled way of deploying Invicti Shark in a Docker scenario is to simply layer the Shark modifications onto your already existing container definition.
The following example demonstrates how you can deploy the Shark together with your web application.
Step 1. Adding your website to Invicti Enterprise
For this example, we will assume that the URL for your target is http://invictiexample.com:60000.
- Add your website to Invicti. For further information, see How to add a website in Invicti Enterprise.
- Download the Node.js sensor. For further information, see Downloading Shark sensors in Invicti Enterprise.
- Save the Node.js sensor file to use it later on.
Step 2. Defining the web application image
The following file structure defines the simple web application.
/testnodejs-docker/
/testnodejs-docker/Dockerfile
/testnodejs-docker/src/app.js
/testnodejs-docker/src/package.json- Create your /testnodejs-docker/Dockerfile file to read as follows:
From node:12
#setup the web pages
Copy src/..
#install npm and dependencies
Run npm install
- Create your /testnodejs-docker/src/app.js file to read as follows:
const app = require('express')();
const port = 60000;
app.get('/', function (req, res) {
res.send(
'<html><body>' +
'<h1>Shark(IAST) Example for Node.JS</h1>' +
'<br>' +
'Hello World! - Main Page' +
'<br>' +
'<a href="/page1">Go to Page 1</a>' +
'</body></html>'
);
});
app.get('/page1', function (req, res) {
res.send(
'<html><body>' +
'<h1>Shark(IAST) Example for Node.JS</h1>' +
'<br>' +
'Hello World! - Page 1' +
'<br>' +
'<a href="/">Go to Main Page</a>' +
'</body></html>'
);
});
app.listen(port, function(err){
if (err) console.log(err);
console.log("Server listening on port: ", port);
});- Create your /testnodejs-docker/src/package.json file to read as follows:
{
"name": "testnodejs-docker",
"version": "1.0.0",
"dependencies": {
"express": "*"
}
}- Finally, build the image with:
cd /testnodejs-docker
docker build -t testnodejs-docker
Step 3. Defining the Shark layer image
The Shark layer will be defined through the following file structure:
/testnodejs-docker-shark/
/testnodejs-docker-shark/Dockerfile
/testnodejs-docker-shark/Shark(IAST).tar
Copy the Shark(IAST).tar file you created in the first step to your docker host into the /testnodejs-docker-shark directory.
Create your /testnodejs-docker-shark/Dockerfile file to read as follows:
From testnodejs-docker
#setup and install Invicti Shark
Run mkdir /shark
Copy node-shark(IAST).tar /shark/node-shark(IAST).tar
#expose port and launch the app with Invicti Shark
Expose 60000
Cmd [ "npx", "/shark/node-shark(IAST).tar", "app.js" ]
Build and run your image with:
cd /testnodejs-docker-shark
docker build -t testnodejs-docker-shark
docker run -d -p 60000:60000 --name mytestnodejs testnodejs-docker-shark
Step 4. Testing and scanning your web application
- Point your browser to your web application - in this example http://invictiexample.com:60000 to confirm it is running as intended.
- Run a scan on your URL. The scan summary displays whether Invicti Shark is used for the scan.
