PreEmptive Protection DashO for Android & Java

Web App or Services (.war)

When you select an application type of Web in the Wizard, it will ask you for the location and name of the .war file, as well as the location of the JDK that PreEmptive Protection™ DashO™ for Android & Java should use to resolve Java runtime classes (See Include JDK).

The wizard will examine the .war file for classes and jars that are included. These items include the special locations in WEB-INF that are used by the web container as well as jars that may be referenced by JNLP files. You can select which items in the .war file that you wish to obfuscate.

In addition to the jar files that are stored in the .war file, DashO needs the classes that are part of the Servlet and JSP APIs. The wizard will look for references to these jars in well-known locations and add them to the list of support jars. If your application expects the web container to provide any other classes shared amongst web applications, such as the logging service log4j, you need to add it to the list of support jars. Java modules (.jmod) can also be added to the list of support libraries.

Finally, the wizard asks for the directory where you want to save the wizard's output. The wizard will create several files in addition to a project file:

  • obfuscate.xml: An Ant script that opens the .war file, runs the DashO project file, and then reassembles the .war file.

  • obfuscate.properties: A Java properties file read by obfuscate.xml. Use this file to change location defaults.

The obfuscate.xml file can be executed by running Ant:

ant -f obfuscate.xml

or by calling it from another Ant file:

<ant antfile="obfuscate.xml"/>

It performs three tasks:

  • It extracts the .war file into a directory. The default directory is .unwar.

  • It runs the Wizard generated project file against the contents of the .unwar directory. Results are temporarily stored in the .obfus directory.

  • It reassembles the .war file with obfuscated code in a new file with _dashoed appended to the name.

If the directory you specified contains project files that will be overwritten, DashO will ask if you want to replace the project.

If you choose to save over the existing project, your new settings will be saved, and a backup will be created of the old project.

You will need to install DashO's Ant tasks to perform the obfuscation. See DashO's Ant Task documentation for additional details.