CSSI Logging

CSSI allows the creation of log files to log the communication activity of the MS-CAPI, PKCS#11 and TSS interfaces. This is useful for debugging difficult problems. When turned on, CSSI will log all function calls into a .txt file.

Microsoft Windows

Logging is activated by setting the following registry settings at  HKEY_LOCAL_MACHINE\Software\charismathics\smart security interface.

Set the log directory, or use the default settings and create a directory named "temp" on the C drive.

Create the C:\temp folder and add the following entries for logging PKCS#11 and CSP functions depending on your windows version:

Windows 32bit. x86

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\charismathics\smart security interface]
"LogFile_mode"=dword:00000002
"CSP_LogFile_name"="c:\\temp\\cmCSP32.log"
"PKCS11_LogFile_name"="c:\\temp\\cmP1132.log"

Windows 64bit. x64

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\charismathics\smart security interface]
"LogFile_mode"=dword:00000002
"CSP_LogFile_name"="c:\\temp\\cmCSP64.log"
"PKCS11_LogFile_name"="c:\\temp\\cmP1164.log"

[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\charismathics\smart security interface]
"LogFile_mode"=dword:00000002
"CSP_LogFile_name"="c:\\temp\\cmCSP32.log"
"PKCS11_LogFile_name"="c:\\temp\\cmP1132.log"

Virtual Smart Card

If you are using the TPM extension of CSSI by using the TSS stack, please use CSSI_param.reg in the main installation directory, instead of manual entries into the registry. Then double-check the registry for the new settings under:

[HKEY_LOCAL_MACHINE\SOFTWARE\ charismathics\smart security interface]

In both cases dword:00000001 sets the logging mode to "on", dword:00000000 sets it back to "off".

Linux

If you want to create a logfile within Linux, you may specify the environment variable ´SCINTERFACE´ with the specified filename and path, for example
in bash ´export SCINTERFACE=/tmp/cmP11.log´