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.