Last updated on October 24th, 2019
We’ve decided to take a step back from our transformations and show you a simple way to protect your code through our command line interface (CLI).
Let’s take a sample project:
Note that there’s a subfolder structure. Inside the
js folder, we have a
dontProtect.js file that we don’t want to protect with Jscrambler, but we do want to protect the
clock.js and the
We’ll start by creating a
.jscramblerignore file in order to ignore the
.jscramblerignore file must be placed at the root of your project. The level where you should place this file depends on how you plan to zip your project.
If you will zip the project from inside the sample project folder, the
.jscramblerignore file should be at the same level as
As so, the
.jscramblerignore file should include the following:
If you want to include the sample project folder in your zip file, then the
.jscramblerignore file should be at the same level as this folder.
In this case, the
.jscramblerignore file should have the following:
You can also use
.jscramblerignore for folders, and to include certain files in the protection process. For example:
#ignore all files in js folder sample project/js/ #except for clock.js !sample project/js/clock.js
Now, we’re ready to protect our application using the CLI.
First, we have to go to Jscrambler’s Dashboard and create an Application by clicking the Create App button.
Once you’re inside the app, select the Application Modes and the Transformations you want to apply (or select a template). Once that’s done, download your selections to a
jscrambler.json file by clicking on the blue download icon.
Installing the CLI
Let’s continue by installing the CLI through node’s package manager:
npm install -g jscrambler
Now let’s zip our project, and remember to include the
.jscramblerignore file. For ease, we will place our
jscrambler.json file next to our zip file, but they could be in different locations.
Now, open your terminal, and after navigating to the same folder where you have your zip and
jscrambler.json file, run the following:
jscrambler -c jscrambler.json -o protected sampleProject.zip
This means that the sampleProject.zip will be protected and placed in the protected folder.
Now, you can test if the protection worked correctly. If you open the
dontProtect.js will be protected.
You can find further information about the Jscrambler CLI options here.
Integrations with Frameworks and Libraries
- React Native
- More information about Framework Compatibility
Feel free to proceed to one of our other 101 Tutorials:
- Jscrambler 101 — First Use
- Jscrambler 101 — Code Annotations (Code Performance)
- Jscrambler 101 — Self Defending
- Jscrambler 101 — Control Flow Flattening
- Jscrambler 101 — Code Locks
- Jscrambler 101 — Source Maps
- Jscrambler 101 — Countermeasures
- Jscrambler 101 — Self-Healing
- Jscrambler 101 — Profiling (Code Performance)
- Jscrambler 101 — App Classification
- Jscrambler 101 — Memory Protection
- Jscrambler 101 — SIEM Integration
Enjoy your testing and start protecting your Applications ASAP! If you have any additional questions, feel free to contact us.