Overview

The Contrast Java agent analyzes the behavior of Java applications running on J2EE containers; newer frameworks like Netty, Play or Vert.X; FatJar/microservice applications like SpringBoot; or even regular desktop Java applications. If there's a JVM, the Java agent can get security insights.

How It Works

To start analyzing an application, install the Java agent by adding it as -javaagent JVM parameter. After installation, continue to use the application as you normally would. (If it's a web application, just click on links, submit forms using normal data, and so forth.) The Java agent's sensors gather information about the application's security, architecture and libraries. You can see the results of the agent's analysis in the Contrast UI.

Supported Technologies

Contrast is tested and proven to be compatible with the following technologies; however, Contrast is also compatible with many more that aren't listed.

Supported JDKS Supported Containers Supported Application Frameworks
IBM 1.6, 1.7 GlassFish 4 Apache POI, fileupload, HttpComponents
JRockit 1.6 (update 95+ or R28.3.6+) Grizzly 2.3.20+ Axis (RPC), XMLRPC, RMI, Apache CXF, JMS (javax.jms)
Oracle JDK 1.6, 1.7, 1.8 JBoss 4.2, 5, 5.1, 6.1, 7, 7.1 Direct Web Remoting (DWR)
Open JDK 1.6, 1.7, 1.8 Jetty 7, 8, 9 DropWizard
Karaf 3.0.x Freemarker, Velocity
Netty 4.x GSON, Kryo, minidev, org.json
Play 2.4 Google Web Toolkit (GWT)
Tomcat 5, 6, 7, 8 Hibernate
Vert.X 3.0 J2SE
WebLogic 10, 11g, 12c JDBC, JDBI, MongoDB
WebSphere 8.5* JSF (MyFaces, RichFaces, Sun)
WildFly 10, 10.1.x java.nio, java.beans
Java EE/J2EE, Servlet/JSP
Jersey
OWASP ESAPI, AntiSamy, Coverity
Oracle, SQL Server, PostgreSQL, DB2, MySQL JDBC drivers
Seam
Spring, Spring Boot, Spring AOP
Struts, Struts 2
Wicket
XStream, Jackson (JSON/XML)
Xerces, JAXB, nu.xom

Contrast tests WebSphere on Windows and Linux, and offers limited support for zSeries and AIX environments. Customers using WebSphere on SPARC Solaris require version 8.5.5.11.

Note for Proguard Users

Proguard includes Java bytecode optimization features which break basic assumptions that runtime agents like Contrast rely on. Proguard users that want to protect their applications with Contrast need to avoid these optimizations by using Proguard's -dontoptimize configuration option.