NodeSecurityShield - A Developer And Security Engineer Friendly Package For Securing NodeJS Applications

A Developer and Security Engineer friendly package for Securing NodeJS Applications.

Inspired by the log4J vulnerability (CVE-2021-44228) which can be exploited because an application can make arbitrary network calls.

We felt there is an need for an application to declare what privileges it can have so that exploitation of such vulnerabilities becomes harder.

To achieve this, NSS (Node Security Shield) has Resource Access Policy.

Resource Access Policy (RAP)

Resource Access Policy is similar to CSP(Content Security Policy).

It lets the developer/security engineer declare what resources an application should access. And Node Security Shield will enforce it.


Install Node Security Shield using npm

  npm install nodesecurityshield


// Require Node Security Shieldlet nodeSecurityShield = require('nodesecurityshield');// Enable Attack Monitoring and/or BlockingnodeSecurityShield.enableAttackMonitoring(resourceAccessPolicy ,callbackFunction);

Sample resourceAccessPolicy

const resourceAccessPolicy  = {  "outBoundRequest" : {          "blockedDomains" : ["*.123.com", "stats.abc.com", 'xyz.com'],          "allowedDomains" : ["*.domdog.io"]      }};
  • Note: blockedDomains holds precedence over allowedDomains.
  • i.e., requests checked against blockedDomains first then allowedDomains.

Sample callbackFunction for Attack Monitoring

var callbackFunction = function (violationEvent) {  console.log(violationEvent);}

Sample callbackFunction for Attack Blocking

var callbackFunction = function (violationEvent) {    throw new Error("Request Blocked. It violates declared Resource Access Policy.")}

Sample violationEvent

{ "violationtType": "Outbound Request", "message": "Outbound request to 'www.malicious.com' violates declared 'Resource Access Policy (RAP)'.", "policy": {  "outBoundRequest" : {          "blockedDomains" : ["*.123.com", "stats.abc.com", 'xyz.com'],          "allowedDomains" : ["*.domdog.io"]      }}

Integrating with Sentry

Sample callbackFunction to integrate with Sentry

var callbackFunction = function (violationEvent) {    var e = new Error();  e.name = 'Resource Access Policy Violation';  e.message = JSON.stringify(violationEvent);  Sentry.captureException(e);}

Screenshot from Sentry dashboard


  • Attack Monitoring
    • Outbound Network Calls
  • Attack Blocking
    • Outbound Network Calls


  • Attack Monitoring
    • Command Execution
    • File Calls
  • Attack Blocking
    • Command Execution
    • File Calls
  • Vulnerability Scanner



Apache License 2.0

Disqus Comments