com.gemalto.idp.mobile.otp.gpfds

Interface GpfDsDevice

public interface GpfDsDevice

An interface defining a Dynamic Signature (DS) device using the Gemalto Proprietary Formatting (GPF) for generating OTPs. This works using an Ezio Server that supports GPF. For Ezio Servers not configured for GPF, use DsFormattingDevice.getCapParameters(com.gemalto.idp.mobile.core.util.SecureString, com.gemalto.idp.mobile.otp.dsformatting.Template.DomainType, com.gemalto.idp.mobile.otp.dsformatting.DsCapParameters.DsCapMode, com.gemalto.idp.mobile.otp.dsformatting.DsTransactionData) to perform dynamic signatures via CAP modes.

Method Summary

Modifier and Type	Method and Description
SecureString	getCode(AuthInput authInput) Generates a code.
SecureString	getDynamicSignature(AuthInput authInput, SecureString challenge, Template.DomainType domain, DsTransactionData dsTransactionData) Generates a dynamic signature.

Method Detail

getCode

SecureString getCode(AuthInput authInput)
              throws IdpException

Generates a code.

A GpfDs code in practice is identical to a CAP mode2 token (excluding any prefixing of '0's in order to meet the minimum length requirement).

Use CapTools.prefixSequenceNumberToOtp(com.gemalto.idp.mobile.core.util.SecureString, com.gemalto.idp.mobile.otp.cap.CapToken, int) to prefix the sequence number.

Use OtpTools.formatOtp(com.gemalto.idp.mobile.otp.util.OtpTools.FormatType, com.gemalto.idp.mobile.core.util.SecureString) to format the token.

Parameters:

authInput - the authentication input.

Returns:

Code.

Throws:

IdpRuntimeException - when there is a cryptography operation failure

IdpException - this is generic exception, you can directly catch this exception or catch each specific exception below.

IdpStorageException - when there is a database operation failure.

WrappedCounterException - when the ATC/counter reaches its maximum value.

DeviceFingerprintException - when the token's fingerprint checksum does not match.

PasswordManagerException - when the TOKEN domain is not logged in (using one of the password managers)

IdpAuthException - when the authentication mode is not supported by the token.

Since:

4.0

getDynamicSignature

SecureString getDynamicSignature(AuthInput authInput,
                                 SecureString challenge,
                                 Template.DomainType domain,
                                 DsTransactionData dsTransactionData)
                          throws IdpException

Generates a dynamic signature.

Use CapTools.prefixSequenceNumberToOtp(com.gemalto.idp.mobile.core.util.SecureString, com.gemalto.idp.mobile.otp.cap.CapToken, int) to prefix the sequence number.

Use OtpTools.formatOtp(com.gemalto.idp.mobile.otp.util.OtpTools.FormatType, com.gemalto.idp.mobile.core.util.SecureString) to format the token.

Parameters:

authInput - the authentication input.

challenge - the challenge received from the bank or null if the domain operates in connected mode.

domain - the secure domain.

dsTransactionData - the transaction data or null if there is no transaction data.

Returns:

Signature.

Throws:

IdpRuntimeException - when there is a cryptography operation failure.

IdpException - this is generic exception, you can directly catch this exception or catch each specific exception below.

IdpStorageException - when there is a database operation failure.

WrappedCounterException - when the ATC/counter reaches its maximum value.

DeviceFingerprintException - when the token's fingerprint checksum does not match.

PasswordManagerException - when the TOKEN domain is not logged in (using one of the password managers).

IdpAuthException - when the authentication mode is not supported by the token.

Since:

4.0