Package org.calypsonet.terminal.calypso.transaction

Interface TraceableSignatureVerificationData

All Superinterfaces:

CommonSignatureVerificationData<TraceableSignatureVerificationData>

public interface TraceableSignatureVerificationData
extends CommonSignatureVerificationData<TraceableSignatureVerificationData>

Contains the input/output data of the CommonTransactionManager.prepareVerifySignature(CommonSignatureVerificationData) method for traceable signature verification using the "PSO Verify Signature" SAM command.

Since:

1.2.0

Method Summary

Modifier and Type	Method	Description
TraceableSignatureVerificationData	withoutBusyMode()	Indicates that the signature has been computed in non "Busy" mode.
TraceableSignatureVerificationData	withSamTraceabilityMode(int offset, boolean isPartialSamSerialNumber, boolean checkSamRevocationStatus)	Indicates that the signature has been computed in "SAM traceability" mode and therefore whether the revocation status of the signing SAM should be checked or not.

Methods inherited from interface org.calypsonet.terminal.calypso.transaction.CommonSignatureVerificationData

isSignatureValid, setData, setKeyDiversifier

Method Detail

withSamTraceabilityMode

TraceableSignatureVerificationData withSamTraceabilityMode(int offset,
                                                           boolean isPartialSamSerialNumber,
                                                           boolean checkSamRevocationStatus)

Indicates that the signature has been computed in "SAM traceability" mode and therefore whether the revocation status of the signing SAM should be checked or not.

By default, the signature is not supposed to have been computed in "SAM traceability" mode.

Parameters:

offset - The offset in bits of the SAM traceability data.

isPartialSamSerialNumber - True if only the 3 LSBytes of the SAM serial number have been used.

checkSamRevocationStatus - True if it is requested to check if the SAM is revoked or not. If true, then the SamRevocationServiceSpi service must be registered in the security settings using the CommonSecuritySetting.setSamRevocationService(SamRevocationServiceSpi) method.

Returns:

The current instance.

Since:

1.2.0

See Also:

TraceableSignatureComputationData.withSamTraceabilityMode(int, boolean), SamRevocationServiceSpi, CommonSecuritySetting.setSamRevocationService(SamRevocationServiceSpi)

withoutBusyMode

TraceableSignatureVerificationData withoutBusyMode()

Indicates that the signature has been computed in non "Busy" mode.

By default, the signature is supposed to have been computed in "Busy" mode.

The signature may have been generated with "Busy mode" enabled. In this mode, after a "PSO Verify Signature" failing because of an incorrect signature, during a few seconds the SAM rejects any "PSO Verify Signature" commands with "Busy" mode by responding with the "busy" status word.

When a "PSO Verify Signature" fails with the busy status, the terminal should repeat the command until the SAM is not busy anymore.

The busy mode duration is typically of a few seconds, and it is never of greater than ten seconds.

Note that after a reset of the SAM, "PSO Verify Signature" commands being in "Busy" mode fail with the busy status until the end of the busy mode duration.

Returns:

The current instance.

Since:

1.2.0

See Also:

TraceableSignatureComputationData.withoutBusyMode()