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 andjcsw.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:
TheConfigurator.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