EMGpfDsDevice Protocol Reference

Conforms to NSObject
Declared in EMGpfDsDevice.h

Overview

A protocol defining a Dynamic Signature (DS) device using the Gemalto Proprietary Formatting (GPF) for generating OTPs.

This works using the Gemalto VAS Authentication Server. For pure CAP authentication servers should use [EMDsDevice capParametersWithChallenge:domain:dsCapMode:transactionData:] or [EMDsDevice capParametersWithDomain:dsCapMode:transactionData:] instead.

– codeWithAuthInput:error: required method

Generates a code.

- (id<EMSecureString>)codeWithAuthInput:(id<EMAuthInput>)authInput error:(NSError **)error

Parameters

authInput

the authInput.
error

If an error occurs, upon return contains an NSError object that describes the problem. If you are not interested in possible errors, you may pass in NULL.

Return Value

The code.

Availability

3.2

Discussion

Note that a code in practice is a CAP mode2 OTP with a prefixed sequence number formatting applied. Example: 010 543 203. Use [EMToolBox formatOtpWithType:otp:] to format the token.

Warning: Depending of the EMAuthInput type you are using, you may have to use this function asynchronously, please @see EMAuthInput for more details

Declared In

EMGpfDsDevice.h

– dynamicSignatureWithAuthInput:challenge:domain:transactionData:error: required method

Generates a dynamic signature.

- (id<EMSecureString>)dynamicSignatureWithAuthInput:(id<EMAuthInput>)authInput challenge:(id<EMSecureString>)challenge domain:(EMDomainType)domain transactionData:(id<EMDsTransactionData>)transactionData error:(NSError **)error

Parameters

authInput

The authInput.
challenge

The challenge. The challenge can be nil in connected mode.
domain

The secure domain.
transactionData

The transaction data. The transaction data can be nil.
error

If an error occurs, upon return contains an NSError object that describes the problem. If you are not interested in possible errors, you may pass in NULL.

Return Value

The signature.

Availability

3.2

Discussion

Note that a dynamic signature in practice is a CAP mode3 TDS OTP with prefixed sequence number and formatting applied. Example: 010 543 203. Use [EMToolBox prefixSequenceNumberToOtp:token:tokenVersionLength:] to prefix the sequence number. Use [EMToolBox formatOtpWithType:otp:] to format the token.

Declared In

EMGpfDsDevice.h