Keypop Calypso Crypto Legacy SAM C++ API 0.6.0
Reference Calypso Crypto Legacy SAM API for C++
Public Member Functions | List of all members
keypop::calypso::crypto::legacysam::transaction::FreeTransactionManager Class Referenceabstract

#include <FreeTransactionManager.hpp>

Inheritance diagram for keypop::calypso::crypto::legacysam::transaction::FreeTransactionManager:
Inheritance graph
[legend]
Collaboration diagram for keypop::calypso::crypto::legacysam::transaction::FreeTransactionManager:
Collaboration graph
[legend]

Public Member Functions

virtual FreeTransactionManagerprepareGetData (const GetDataTag tag)=0
 
virtual FreeTransactionManagerprepareGenerateCardAsymmetricKeyPair (KeyPairContainer keyPairContainer)=0
 
virtual FreeTransactionManagerprepareComputeCardCertificate (LegacyCardCertificateComputationData data)=0
 
virtual FreeTransactionManagerprepareComputeSignature (SignatureComputationData<?> data)=0
 
- Public Member Functions inherited from keypop::calypso::crypto::legacysam::transaction::ReadTransactionManager< FreeTransactionManager >
virtual FreeTransactionManagerprepareReadSystemKeyParameters (const SystemKeyType systemKeyType)=0
 
virtual FreeTransactionManagerprepareReadCounterStatus (const int counterNumber)=0
 
virtual FreeTransactionManagerprepareReadAllCountersStatus ()=0
 
- Public Member Functions inherited from keypop::calypso::crypto::legacysam::transaction::TransactionManager< T >
virtual T & processCommands ()=0
 

Detailed Description

Transaction manager dedicated to operations performed without control SAM.

An instance of this interface can be obtained via the method const std::shared_ptr<CardReader>, LegacySam). 0.1.0

Definition at line 32 of file FreeTransactionManager.hpp.

Member Function Documentation

◆ prepareComputeCardCertificate()

virtual FreeTransactionManager & keypop::calypso::crypto::legacysam::transaction::FreeTransactionManager::prepareComputeCardCertificate ( LegacyCardCertificateComputationData  data)
pure virtual

Schedules the execution of a "PSO Compute Certificate" command.

Once the command is processed, the result will be available in the provided input/output LegacyCardCertificateComputationData object.

Parameters
dataThe input/output data containing the parameters of the command.
Returns
The current instance.
Exceptions
IllegalArgumentExceptionIf data is null.
See also
LegacyCardCertificateComputationData
LegacySamApiFactory::createLegacyCardCertificateComputationData()
Since
0.5.0

◆ prepareComputeSignature()

virtual FreeTransactionManager & keypop::calypso::crypto::legacysam::transaction::FreeTransactionManager::prepareComputeSignature ( SignatureComputationData<?>  data)
pure virtual

Schedules the execution of a "Data Cipher" or "PSO Compute Signature" command.

Once the command is processed, the result will be available in the provided input/output BasicSignatureComputationData or TraceableSignatureComputationData objects.

The signature may be used for many purposes, for example:

  • To add a signature to data recorded in a contactless card or ticket.
    Remark: to speed up processing, it is recommended to use a constant signing key (which is not diversified before ciphering). Instead, the serial number of the card or ticket should be inserted at the beginning of the data to sign.
  • To sign some data reported from a terminal to a central system.
    Remark: in this case, the terminal SAM contains a signing work key diversified with its own serial number, guarantying that the data has indeed been signed by this SAM. The central system SAM uses the master signing key, diversified before signing with the diversifier set previously by "Select Diversifier" command.
Parameters
dataThe input/output data containing the parameters of the command.
Returns
The current instance.
Exceptions
IllegalArgumentExceptionIf the input data is inconsistent.
See also
SignatureComputationData
BasicSignatureComputationData
TraceableSignatureComputationData
LegacySamApiFactory::createBasicSignatureComputationData()
Since
0.1.0

◆ prepareGenerateCardAsymmetricKeyPair()

virtual FreeTransactionManager & keypop::calypso::crypto::legacysam::transaction::FreeTransactionManager::prepareGenerateCardAsymmetricKeyPair ( KeyPairContainer  keyPairContainer)
pure virtual

Schedules the execution of "Card Generate Asymmetric Key Pair" command.

Once this command is processed, the key pair data will be available in the provided output KeyPairContainer objects.

Parameters
keyPairContainerThe container for the output data.
Returns
The current instance.
Exceptions
IllegalArgumentExceptionIf keyPairContainer is null.
See also
KeyPairContainer
LegacySamApiFactory::createKeyPairContainer()
Since
0.5.0

◆ prepareGetData()

virtual FreeTransactionManager & keypop::calypso::crypto::legacysam::transaction::FreeTransactionManager::prepareGetData ( const GetDataTag  tag)
pure virtual

Schedules the execution of a "Get Data" command for the specified tag.

Once this command is processed, data is accessible using dedicated getter methods, like LegacySam::getCaCertificate().

Parameters
tagThe tag to retrieve the data for.
Returns
The current instance.
Exceptions
IllegalArgumentExceptionIf tag is null.
Since
0.5.0

The documentation for this class was generated from the following file: