Configuring the Java Card Development Kit Simulator

Before using the simulator for the first time, it must be provisioned with an initial Secure Channel Protocol key set and with a Global PIN.

This can be done by running the Configurator tool from the command line as follows:

java -jar Configurator.jar -binary <simulator-binary> -SCP-keyset <kvn> <k_enc> <k_mac> <k_dek> -global-pin <pin> <tries_count>
where:
  • simulator-binary is the SDK binary file to inject the data, which is jcsl for Linux and jcsw.exe for Windows.
  • kvn is the Key Version Number for the Initial SCP keyset.
  • k_enc is the ENC key of the card manager SCP keyset. It is not set by default.
  • k_mac is the MAC key of the card manager SCP keyset. It is not set by default.
  • k_dek is the DEK key of the card manager SCP keyset. It is not set by default.
  • pin is the global Personal Identification Number (PIN) used as a mechanism for CVM.
  • tries_count is the CVM Retry Limit.

Note:

The Configurator.jar file is located in the tools sub-directory of JC_HOME_SIMULATOR. To print the available arguments and further details of the configurator, execute java -jar Configurator.jar

Here are examples on how to provision the simulator using the Configurator. Use your own values accordingly.

Example - Linux (values must be set with yours):

java -jar ${JC_HOME_SIMULATOR}/tools/Configurator.jar -binary ${JC_HOME_SIMULATOR}/runtime/bin/jcsl -SCP-keyset 10 1111111111111111111111111111111111111111111111111111111111111111 2222222222222222222222222222222222222222222222222222222222222222 3333333333333333333333333333333333333333333333333333333333333333 -global-pin 01020304050f 03

Example - Windows

java -jar %JC_HOME_SIMULATOR%\tools\Configurator.jar -binary %JC_HOME_SIMULATOR%\runtime\bin\jcsw.exe -SCP-keyset 10 1111111111111111111111111111111111111111111111111111111111111111 2222222222222222222222222222222222222222222222222222222222222222 3333333333333333333333333333333333333333333333333333333333333333 -global-pin 01020304050f 03