Calypsonet Terminal Calypso Crypto Legacy SAM API

The Calypsonet Terminal Calypso Crypto Legacy SAM API is an extension of the Calypsonet Terminal Reader API which provides a high-level API standardizing the way to interact with a Calypso® legacy SAM product (SAM-C1, HSM-C1, etc…).


The Calypso API provides the means to select a target or control SAM and then perform a transaction with the selected target.

  • The result of a SAM selection is a smartcard image whose keys' parameters can be read.
  • A transaction with a target SAM may involve a control SAM in order to secure the operations.

The LegacySam interface provide accessors in order to recover the information of the selected smartcard.

To optimize the number of exchanges with a SAM reader, the Legacy SAM API allows to group the commands. A set of command could be first prepared, and then be processed by a selected target at the selection or during the transaction. A transaction with a Calypso SAM is fully managed through one of the LSTransactionManager interfaces:

Calypso Crypto Legacy SAM API - class diagram

Implementations & API Documentation

The third version number (x.y.z) only concerns updates of the javadoc because this component does not contain any implementation, but only an API. Therefore, it is recommended to always perform a dynamic import as described above in order to have the most up-to-date documentation.

Calypso Legacy SAM API in Java

All deliverables are available directly from the Maven Central Repository or by using one of the project resource managers below:

implementation 'org.calypsonet.terminal:calypsonet-terminal-calypso-crypto-legacysam-java-api:0.2.0'

Calypso Legacy SAM API in C++

work in progress…