To start using the Jscrambler App head to https://app.jscrambler.com/dashboard. After registering and logging in to your account, you will be prompted to protect a simple demonstration Application. After that, the Dashboard is presented. Here is one more demonstration application, and there is the possibility of creating new ones.
By hovering the mouse over the Playground app and selecting 'View App' you'll be led into the Playground application.
The Playground is a sample Web Application, and all transformations are available to use. Protections done in the Playground won't lower the account balance, so it is the best application to test transformations without any worries.
In the File Tree on the left, there are all of our application files. By clicking one of these files, you will see its code on the left side of the Text Editor. On the right, the protected code will appear once a protection is made.
On the right side of the application there are three tabs:
Application Modes, to set language specifications and what type of application is being protected;
Templates, to select a default template, or use a personalized template created from a specific set of transformations to your code;
Fine-Tuning, to select what transformations will be applied;
Starting with the Fine-Tuning tab, note there is an Advanced Options switch. By clicking it, more transformation options will become available. This happens due to the fact that some of the simpler options represent a set of advanced options, for example, Functions represents Function Outlining and Function Reordering in the Advanced Options.
By hovering over each transformation in the Advanced Options, a brief explanation will appear explaining the use of each one.
Once a transformation is selected a Clear Selection link will appear under the Fine-Tuning tab.
Clicking this link will clear all the selected transformations.
Proceed with selecting Booleans, Functions, Identifiers and Objects in the Obfuscation options. In Optimization, select Minification, and in RASP (Runtime Application Self-Protection) select Self Defending. Alternatively, head to Templates and select the Self Defending template, as it has the same options as the ones mentioned above.
Now, by pressing the Protect App button at the bottom, the application will be protected, and the resulting protection will be available on the right side of the text editor.
It is possible to run the Playground application right from this screen. This will allow you to compare the result without having to download the code. This feature is only available on the Playground.
You can use
Run Source and
Run Protected to compare the original application with the protected one.
By pressing Download App, the protected code will be downloaded.
To test, you just have to open
index.html in a browser.
If the application should only run in a certain Domain, along with the Self Defending template, there's the possibility to save the set of transformations as a template so it is always ready to use. Head into the Fine-Tuning tab, select Domain Lock and insert a domain. We want to see the code failing to run, so as an example we'll use
www.foo.com in the domain. Let's protect and download the application again. When running this newly protected code, you will notice that the application does not show up.
Now we'll use a domain we can work with. In this case whatever shows up in the browser's navigator when on the application page. Add this domain to your accepted domains, and remove
www.foo.com. Protect and download the application again and run it. The application will be working properly again.
These transformations aren't available in all plans so the template creation might fail. A working template for all plans is achieved by selecting Duplicate Literals Removal, Identifiers Renaming, and Whitespace Removal.
To save these options as a template, go back to the Jscrambler application page. The transformation options should still be selected. Click the Create Template button below the transformations. Give your template a name and a description, click Save Template and a template will be created.
By going to the Templates tab the new Template will be visible under the Custom section.
By going back to the Dashboard, and clicking the Create App button, a new application will be created in the Dashboard.
After filling in the Application’s name and clicking the Create App button there will be an automatic redirection into the newly created application.
To use the API, click the blue download button next to the Application Settings. This will download a JSON file with the selected transformations at the time. To download a template, select it then download the Json file.
The downloaded file will be similar to the one below:
secretKey vary from user to user, while applicationId changes according to the application that will be protected.
applicationId is inside the app, above the text editor.
As for the
secret keys, these are available in the account settings, at API Credentials.
Further information on the API, and Jscrambler’s transformations is available in our documentation.
If there are any questions regarding this or other issues, feel free to contact us at firstname.lastname@example.org.