Time for part 1 of our series.
During this part I will analyse all the sections of a typical .jnlp file. I understand that this may seem a bit of an overkill for a "JNLP Application Security Assessment" series of posts but it will provide a background to any reader that is not familiar with the structure and architecture of jnlp and Java WebStart.
Below is an brief description of what Java WebStart and jnlp is from Oracle.
The Java Network Launch Protocol (JNLP) enables an application to be launched on a client desktop by using resources that are hosted on a remote web server. Java Plug-in software and Java Web Start software are considered JNLP clients because they can launch remotely hosted applets and applications on a client desktop.
The main component of Java Web Start is the .jnlp file. It is an XML based file that
- instructs the java web start to take over the execution of the application,
- loads or downloads each required jar file - depending on whether it is the first time that the jnlp software is executed or not and the response from the web server when each jar file is requested (HTTP/1.1 304 Not Modified vs other)
- starts the java vm with the required execution parameters
- starts the java application with the required parameters & properties.
There are several explanations in the net regarding the structure of the jnlp file. The two best I have found are
- http://download.oracle.com/javase/tutorial/deployment/deploymentInDepth/jnlpFileSyntax.html and
- the JSR-00056 JavaTM Network Launching Protocol and API Specification http://java.sun.com/javase/technologies/desktop/javawebstart/download-spec.html which is downloadable a single zip archive
The image below is itself taken from the Specification archive and is in my opinion a very precise and condensed presentation of the jnlp XML file structure
From the above elements the ones that are more significant from a security testing perspective are the following:
- security: It defines all runtime permissions that the jnlp application will have
- resources: All of its child elements are important
- j2se: defines the required runtime version as well as java vm options that need to be passed at runtime eg. max heap , debug , etc. They are defined in the java-vm-args directive inside the j2se child element.
- jar: defines all java archives that compose the application itself. Those are downloaded ad-hoc at first application execution or are checked for modifications by the runtime at each subsequent application execution
- property: defines all properties that need to passed to the application at runtime as well, those are passed via the to the java vm via the -Dpropertyname=value directive.
- package: defines which packages are implemented in which JAR files.
- nativelib: defines a jar file that contains native libraries in it.
- application-desc: defines runtime parameters to the application The main are:
- The class that contains the main function
- arguments passed to the application
- application-desc: defines runtime parameters to the application The main are:
- The name of the main applet class
- params passed to the applet
Now that the foundations have been set, it is time to see a couple of real life examples that tie all of the above together.
[sourcecode language="xml"]
<?xml version="1.0" encoding="utf-8"?>
<!-- JNLP File for launching ArgoUML with WebStart -->
<jnlp
spec="1.0+"
codebase="http://argouml-downloads.tigris.org/maven2"
href="http://argouml-downloads.tigris.org/jws/argouml-latest-stable.jnlp">
<information>
<title>ArgoUML Latest Stable Release 0.32.2</title>
<vendor>Tigris.org (Open Source)</vendor>
<homepage href="http://argouml.tigris.org/"/>
<description>ArgoUML application.
This is the latest stable release.
</description>
<description kind="short">ArgoUML 0.32.2</description>
<icon href="http://argouml.tigris.org/images/argologo16x16.gif" width="16" height="16" />
<icon href="http://argouml.tigris.org/images/argologo32x32.gif" width="32" height="32" />
<icon href="http://argouml.tigris.org/images/argologo64x64.gif" width="64" height="64" />
<offline-allowed/>
</information>
<security>
<all-permissions/>
</security>
<resources>
<j2se version="1.5+" max-heap-size="512m"/>
<jar href="http://argouml-downloads.tigris.org/maven2/antlr/antlr/2.7.7-2/antlr-2.7.7-2.jar"/>
<jar href="http://argouml-downloads.tigris.org/maven2/org/argouml/argouml-euml/0.32/argouml-euml-0.32.jar"/>
... this application has a lot of jars ...
<jar href="http://argouml-downloads.tigris.org/maven2/org/argouml/argouml-umlpropertypanels/0.32.2/argouml-umlpropertypanels-0.32.2.jar"/>
<property name="argouml.modules"
value=";org.argouml.state2.StateDiagramModule;org.argouml.sequence2.SequenceDiagramModule;org.argouml.activity2.ActivityDiagramModule;org.argouml.core.propertypanels.module.XmlPropertyPanelsModule;org.argouml.transformer.TransformerModule;org.argouml.language.cpp.generator.ModuleCpp;org.argouml.language.cpp.notation.NotationModuleCpp;org.argouml.language.cpp.profile.ProfileModule;org.argouml.language.cpp.reveng.CppImport;org.argouml.language.cpp.ui.SettingsTabCpp;org.argouml.language.csharp.generator.GeneratorCSharp;org.argouml.language.java.cognitive.critics.InitJavaCritics;org.argouml.language.java.generator.GeneratorJava;org.argouml.language.java.profile.ProfileJava;org.argouml.language.java.reveng.JavaImport;org.argouml.language.java.reveng.classfile.ClassfileImport;org.argouml.language.java.ui.JavaTools;org.argouml.language.java.ui.SettingsTabJava;org.argouml.language.php.generator.ModulePHP4;org.argouml.language.php.generator.ModulePHP5;org.argouml.language.sql.SqlInit;org.argouml.uml.reveng.classfile.ClassfileImport;org.argouml.uml.reveng.idl.IDLFileImport" />
</resources>
<application-desc main-class="org.argouml.application.Main"/>
</jnlp>
[/sourcecode]
Following on our definition of interesting sections, we can see that the jnlp file has:
- all available security permissions to perform any actions on the users' workstation (Lines 20 - 22)
- It requires java 1.5 and greater to function as well as a maximum heap size of 512 MB (Line 24)
- It requires a lot of jars that will be downloaded and saved at the users' workstation (Lines 26 - 29)
- A single property is passed to it at runtime, argouml.modules (Line 31).
- Its main function is loaded from org.argouml.application.Main and a single parameter is passed to it (Line 34)
Another jnlp file with interesting parameters is the one below from the javaemvreader project:
[sourcecode language="xml"]
<!--?xml version="1.0" encoding="utf-8"?--><?xml version="1.0" encoding="utf-8"?>
<jnlp spec="1.6+" codebase="http://javaemvreader.googlecode.com/files/" href="webstart.jnlp">
<information>
<title>Java EMV Reader</title>
<vendor>sasc</vendor>
<homepage href="http://code.google.com/p/javaemvreader"/>
<description>Java EMV Reader</description>
<offline-allowed/>
</information>
<security>
<all-permissions/>
</security>
<resources>
<j2se version="1.6+" java-vm-args="-esa -Xnoclassgc"/>
<property name="jnlp.versionEnabled" value="true"/>
<jar href="javaemvreader-latest-full.jar" main="true"/>
</resources>
<application-desc main-class="sasc.Main"/>
</jnlp>
[/sourcecode]
The interesting bit here is the java-vm-args directive at the j2se section. Basically it is used to initiate the java virtual machine with the appropriate configuration settings and ensure a correct execution environment.
That is it for Part 1 of our tutorial. Part 2 will describe the behavior of a jnlp file execution, ways to interfere with is by manipulation some of its critical parameters and changing the execution model from Java WebStart to native java application.
./Z
No comments:
Post a Comment
Note: only a member of this blog may post a comment.