Getting Started with the Java Tracer

On this page we will show you how to use the Cryptosense Java Tracer to obtain a cryptography trace from an application.

Prerequisites

Before you use the Java Tracer, make sure you have followed the installation instructions.

You will also need a Java application that you know how to run with the java command in a terminal (for other Java applications, see the reference manual).

Tracing the application

Go to a directory where you have write access and run it with java as usual, except with the added -javaagent:/path/to/cs-java-tracer.jar command-line parameter.

For example, if your application doesn't need any other command-line parameters, you can run the following command:

java -javaagent:/path/to/cs-java-tracer.jar -jar /path/to/application.jar

When your application has finished executing, you will find trace files like these in your directory:

cs-tracer
└── cs-trace_2022-06-02-13-30-53-113_79629.cst.gz

These trace files are now ready for uploading to the Cryptosense Analyzer Platform. The directory where the Java Tracer writes the trace can be changed with the -Dcryptosense.agent.out parameter. See the manual to learn how to use those parameters and to get a list of all available parameters.