Possible interference with Other Applications

The Crescendo SDK / CLI Tool employs a distinct transaction (SCardTransaction) for token communication. If another application that interacts with the device is installed and operates concurrently or immediately after the token connection (for instance, DigiCert PKI Client), an issue may arise where the SDK / CLI Tool is unable to access the token due to the other application’s exclusive token connection. This is beyond the control of the SDK / CLI Tool. Once the other application relinquishes the connection, the SDK / CLI Tool will resume its functionality.

PowerShell logging output

When using the Crescendo SDK (or the CLI Tool) in PowerShell ISE, if the LogLevel is set to anything other than LogLevel.SILENT, an error message will appear at the beginning of the output:

PS C:\Temp> .\CrescendoCLI.exe pin-verify -p 123456 -v
.\CrescendoCLI.exe : [2024-04-11 11:00:15.077][INFO]   Log level is set to "DEBUG".
At line:1 char:1
+ .\CrescendoCLI.exe pin-verify -p 123456 -v
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : NotSpecified: ([2024-04-11 11:...set to "DEBUG".:String) [], RemoteException
    + FullyQualifiedErrorId : NativeCommandError
 
[2024-04-11 11:00:15.184][DEBUG]  Successfully connected to reader Circle Idaxis SecurePIV 0.
[2024-04-11 11:00:15.185][DEBUG]  SCardTransaction was correctly established.
[2024-04-11 11:00:15.185][INFO]   Connected to:
[2024-04-11 11:00:15.185][INFO]     - Reader: "Circle Idaxis SecurePIV 0"
[2024-04-11 11:00:15.185][INFO]     - Token: "Crescendo 4000 FIPS"
[2024-04-11 11:00:15.185][INFO]     - ATR: 3B-DA-96-FF-81-91-FE-1F-C3-43-34-30-30-30-2D-46-49-50-53-E7
...

This error message is a result of PowerShell attempting to interpret the logs as standard error status messages, as they are stored in STDERR. However, this does not impact the functionality of the SDK / CLI Tool.

To use PowerShell ISE without encountering this error, you can redirect the STDERR output (the logs) to a file as shown below:

PS C:\Temp> .\CrescendoCLI.exe pin-verify -p 123456 -v 2>file.txt