How To Protect Node.js Apps With Jscrambler

Learn to protect Node.js apps with the most advanced polymorphic obfuscation techniques, code locks, and self-defensive capabilities. This tutorial will explain how to integrate Jscrambler seamlessly into the build process of a typical Node.js app in just a few minutes.

Node.js is a popular and open-source JavaScript runtime environment for creating server-side applications.

Prerequisites

First, ensure you have the latest version of NPM installed on your local machine.

npm update -g npm

Now, we need a sample Node.js app to use in this tutorial. Go ahead and use a simple Hello World Express app. First, install Express.

npm install express --save

Then, create an app.js file in our project root folder with the following code provided on the Express website:

const express = require('express')
const app = express()
const port = 3000

app.get('/', (req, res) => {
  res.send('Hello World!')
})

app.listen(port, () => {
  console.log(`Example app listening at http://localhost:${port}`)
})

This app starts a server and listens on port 3000 for connections. The app responds with Hello World! for requests to the root URL (/) or route.

If we run the app with the code below:

node app.js

We will see a Hello World message on localhost:3000.

Integrating Jscrambler

Let's begin by getting a ready-to-use file with our intended Jscrambler configuration.

If you haven't created a Jscrambler account yet, be sure to do so before moving forward.

Log into the Jscrambler Web App. Once there, create a new app. It is time to pick the Jscrambler transformations we want to use. We can pick them one by one in the Fine-Tuning tab, but, in our case, let's go ahead to the Templates tab and pick up the Obfuscation template. If you need help with these steps, please refer to our guide to making your first protection request.

Now, we have to download a JSON file with all this configuration, which will be used only for quickly getting the required settings. You can do this by clicking the cogwheel next to "Protect App" on the right sidebar, which will present the following screen:
Now that you have the file with the needed configuration, you can integrate Jscrambler into your Node.js app's build process using one of the tools, Grunt or Gulp. Let's explore both approaches.

Grunt

Grunt is a JavaScript task runner to automate repetitive tasks like minification, compilation, unit testing, code protection, etc. In this case, it is a handy option to ensure that the source code of your Node.js app is always protected at build time.

To get started with Grunt, let's install it as a dev dependency:

npm install grunt --save-dev

Now, we need to create a configuration file for Grunt, Gruntfile.js. This file contains our project and Grunt task configuration and loads Grunt plugins and tasks.

To keep things simple, let's set up a basic Gruntfile:

module.exports = function(grunt) {
  grunt.initConfig({
    pkg: grunt.file.readJSON('package.json')
  });
};

Next, we want to add the Jscrambler Grunt plugin:

npm install grunt-jscrambler --save-dev

Now that the plugin is installed, we must enable it in our Gruntfile by adding this line at the bottom:

grunt.loadNpmTasks('grunt-jscrambler');

Right after this line, we have to set the "default" Grunt task with:

grunt.registerTask('default', ['jscrambler']);

Now that this is done, we must specify the task itself. Here, we will use some parts of the jscrambler.json file we downloaded before, namely accessKey, secretKey, applicationId, and the params array.

Our final Gruntfile.js file should look like this:

module.exports = function(grunt) {

    grunt.initConfig({
      pkg: grunt.file.readJSON('package.json'),
      jscrambler: {
        main: {
          options: {
            keys: {
              accessKey: 'YOUR_ACCESS_KEY',
              secretKey: 'YOUR_SECRET_KEY'
            },
            applicationId: 'YOUR_APPLICATION_ID',
            params: [
                {
                    "name": "objectPropertiesSparsing"
                  },
                  {
                    "name": "variableMasking"
                  },
                  {
                    "name": "whitespaceRemoval"
                  },
                  {
                    "name": "identifiersRenaming",
                    "options": {
                      "mode": "SAFEST"
                    }
                  },
                  {
                    "name": "dotToBracketNotation"
                  },
                  {
                    "name": "stringConcealing"
                  },
                  {
                    "name": "functionReordering"
                  },
                  {
                    "options": {
                      "freq": 1,
                      "features": [
                        "opaqueFunctions"
                      ]
                    },
                    "name": "functionOutlining"
                  },
                  {
                    "name": "propertyKeysObfuscation",
                    "options": {
                      "encoding": [
                        "hexadecimal"
                      ]
                    }
                  },
                  {
                    "name": "regexObfuscation"
                  },
                  {
                    "name": "booleanToAnything"
                  }
                ]
          },
          files: [
            {expand: true, src: ['app.js'], dest: 'dist/'},
          ]
        }
      }
    });
  
    grunt.loadNpmTasks('grunt-jscrambler');
    
    
    grunt.registerTask('default', ['jscrambler']);
    
  };

If we look at the file array, we'll see that Jscrambler will use the app.js file, protect it, and then place the protected version in the dist/ folder. You can change these to match your project's requirements.

All that's left is to ensure our build process uses Grunt. In our case, we must make sure that there's a script in our package.JSON file to build our app using Grunt:

"scripts": {
    "build": "grunt"
  },

We're now ready to run our build:

npm run build

That's it! If we check our /dist/app.js file, we will see that it has been obfuscated with Jscrambler.

Gulp

According to the 2019 State of JavaScript survey, Gulp is the second most popular build tool for JS. Similarly to Grunt, it allows you to automate repetitive workflows into efficient build pipelines.

To get started with Gulp, let's install it as a dev dependency:

npm install gulp --save-dev

Let's also install the Jscrambler Gulp plugin:

npm install gulp-jscrambler --save-dev

Now, we need to create a configuration file for Gulp, gulpfile.js.

Let's go right ahead and add the configurations we need to get Jscrambler working with Gulp. To do this, we will need some parts of the jscrambler.json file we downloaded earlier: accessKey, secretKey, applicationId, and the params array.

Our final gulpfile.js file should look like this:

var gulp = require('gulp');
var jscrambler = require('gulp-jscrambler');

gulp.task('default', function (done) {
  gulp
    .src('app/**/*.js')
    .pipe(jscrambler({
      keys: {
        accessKey: 'YOUR_ACCESS_KEY',
        secretKey: 'YOUR_SECRET_KEY'
      },
      applicationId: 'YOUR_APPLICATION_ID',
      params: [
        {
            "name": "objectPropertiesSparsing"
          },
          {
            "name": "variableMasking"
          },
          {
            "name": "whitespaceRemoval"
          },
          {
            "name": "identifiersRenaming",
            "options": {
              "mode": "SAFEST"
            }
          },
          {
            "name": "dotToBracketNotation"
          },
          {
            "name": "stringConcealing"
          },
          {
            "name": "functionReordering"
          },
          {
            "options": {
              "freq": 1,
              "features": [
                "opaqueFunctions"
              ]
            },
            "name": "functionOutlining"
          },
          {
            "name": "propertyKeysObfuscation",
            "options": {
              "encoding": [
                "hexadecimal"
              ]
            }
          },
          {
            "name": "regexObfuscation"
          },
          {
            "name": "booleanToAnything"
          }
        ]
    }))
    .pipe(gulp.dest('dist/'))
    .on('end', done);
});

If we take a closer look at this file, we'll see that src specifies the path to the files that Jscrambler will use. At the bottom of the file, .pipe(gulp.dest('dist/')) places the protected version in the dist/ folder. You can change these to match your project's requirements.

Now, all that's left is to make sure that our build process is using Gulp. In our case, we must make sure that there's a script in our package.JSON file to build our app using Gulp:

"scripts": {
    "build": "gulp"
  },

We're now ready to run our build:

npm run build

That's it! If we check our /dist/app.js file, we will see that it has been obfuscated with Jscrambler.

Final Thoughts

Node.js is the technology for building server-side apps, thanks to frameworks like Express.

If you're building Node.js applications that have sensitive logic and want to prevent reverse engineering, licensing violations, and tampering, a security solution such as Jscrambler is a must.

You can easily integrate Jscrambler into Node's build process using either Grunt or Gulp.

Even though we used the Obfuscation template, try other templates and protection layers like Self-Defending for improved runtime protection.

Jscrambler comes with premium support, so contact us if you have any questions!