Package org.eclipse.keypop.calypso.card.transaction

Interface SecureTransactionManager<T extends SecureTransactionManager<T>>

Type Parameters:

T - The type of the lowest level child object.

All Superinterfaces:

TransactionManager<T>

All Known Subinterfaces:

SecureExtendedModeTransactionManager, SecurePkiModeTransactionManager, SecureRegularModeTransactionManager, SecureSymmetricCryptoTransactionManager<T>

public interface SecureTransactionManager<T extends SecureTransactionManager<T>>
extends TransactionManager<T>

Contains operations common to all card transactions secured by cryptographic algorithms.

See TransactionManager parent interface for more information and details of others available card operations.

Since:

2.0.0

Method Summary

Modifier and Type	Method	Description
<E extends CardTransactionCryptoExtension> E	getCryptoExtension(Class<E> cryptoExtensionClass)	Returns the associated CardTransactionCryptoExtension instance.
T	prepareCancelSecureSession()	Schedules the execution of a special "Close Secure Session" command in order to abort the current secure session.
T	prepareCloseSecureSession()	Schedules the execution of a "Close Secure Session" command.

Methods inherited from interface org.eclipse.keypop.calypso.card.transaction.TransactionManager

getTransactionAuditData, prepareAppendRecord, prepareChangePin, prepareCheckPinStatus, prepareDecreaseCounter, prepareDecreaseCounters, prepareGenerateAsymmetricKeyPair, prepareGetData, prepareIncreaseCounter, prepareIncreaseCounters, preparePutData, prepareReadBinary, prepareReadCounter, prepareReadRecord, prepareReadRecords, prepareReadRecordsPartially, prepareSearchRecords, prepareSelectFile, prepareSelectFile, prepareSetCounter, prepareSvReadAllLogs, prepareUpdateBinary, prepareUpdateRecord, prepareVerifyPin, prepareWriteBinary, prepareWriteRecord, processCommands

Method Details

getCryptoExtension

<E extends CardTransactionCryptoExtension> E getCryptoExtension(Class<E> cryptoExtensionClass)

Returns the associated CardTransactionCryptoExtension instance.

Type Parameters:

E - The generic type of the expected crypto extension.

Parameters:

cryptoExtensionClass - The class of the crypto extension.

Returns:

A non-null CardTransactionCryptoExtension.

Throws:

IllegalArgumentException - If the provided class is null.

Since:

2.0.0

prepareCloseSecureSession

T prepareCloseSecureSession()

Schedules the execution of a "Close Secure Session" command.

The ratification mechanism is disabled by default but can be enabled via the SymmetricCryptoSecuritySetting.enableRatificationMechanism() method.

In this case, a ratification command is added after the "Close Secure Session" command when the communication is done in contactless mode.

Returns:

The current instance.

Throws:

IllegalStateException - In the following cases:

• No secure session is opened and no secure session opening is prepared
• A secure session closing is already prepared
• A secure session canceling is prepared

Since:

1.6.0

prepareCancelSecureSession

T prepareCancelSecureSession()

Schedules the execution of a special "Close Secure Session" command in order to abort the current secure session.

This command will be executed in safe mode and will not raise any exceptions.

Returns:

The current instance.

Since:

1.6.0