Functionalities and services

The Authentication Suite Server SDK provides a couple of services that serve different functionalities.

DPX Import service

The DPX Import service groups the functionalities responsible for the import process, which consists in extracting the Digipass data from the DPX file.

Digipass data import

• AAL2DPXClose()

• AAL2DPXGetMessageVector()

• AAL2DPXGetStaticVector()

• AAL2DPXGetToken()

• AAL2DPXGetTokenBlobs()

• AAL2DPXGetTokenBlobsEx()

• AAL2DPXGetTokenBlobsEx2()

• AAL2DPXInit()

• AAL2DPXInitEx()

• AAL2CINIT_APrepare()

• AAL2CINIT_AProcess()

Digipass Dynamic Authentication service

The Digipass Dynamic Authentication service provides functionalities for different user authentication processes.

Challenge generation

• AAL2GenerateChallenge()

• AAL2GenerateChallengeEx()

Password validation

• AAL2VerifyPassword()

• AAL2VerifyPasswordEx()

Password validation with enhanced security

• AAL2VerifyPasswordEs()

Digipass e-Signature Validation service

The Digipass e-Signature Validation service is used to perform signature validation and integrity control, based on the signature code generated by the user's authenticator, and on custom data fields.

Signature validation

• AAL2VerifySignature()

• AAL2VerifySignatureEx()

Signature validation with enhanced security

• AAL2VerifySignatureEs()

Message signature validation

• AAL2VerifyMessageSignature()

Virtual Mobile Authenticator service

The Virtual Mobile Authenticator service provides a password generation solution to permanently replace a standard hardware authenticator or as a backup solution in combination with a password delivery mechanism.

Password generation

• AAL2GenPassword()

• AAL2GenPasswordEx()

Signature generation

• AAL2GenSignature()

• AAL2GenSignatureEx()

Digipass Management service

The Digipass Management service provides facilities for the authenticator management for help desk and administration purposes.

Digipass unlocking

• AAL2AuthorizeUnlock()

• AAL2GenUnlockAuthCode()

• AAL2Unlock()

Digipass information management

• AAL2GetTokenInfo()

• AAL2GetTokenInfoEx()

• AAL2ResetTokenInfo()

Digipass test

• AAL2DP500Test()

Digipass static PIN management

• AAL2ChangeEncryptedStaticPassword()

• AAL2ChangeStaticPassword()

• AAL2ResetStaticPassword()

Digipass static PIN management with enhanced security

• AAL2ChangeEncryptedStaticPasswordEs()

Digipass token data synchronization

• AAL2SyncTokenBlob()

Digipass token and host synchronization

• AAL2SyncTokenAndHost()

Digipass protection key management

• AAL2MigrateBlob()

• AAL2MigrateBlobEx()

Digipass properties management

• AAL2GetTokenProperty()

• AAL2SetTokenProperty()

Question/Answer service

The Question/Answer service offers the possibility to authenticate users through their answers to a list of questions.

• AAL2GenQAKey()

• AAL2QADecryptQABlob()

• AAL2QAGenQABlob()

• AAL2QAGenQAHashData()

Digipass Matrix Card service

The Digipass Matrix Card service is used for matrix card generation and matrix card user authentication.

Matrix card generation

• AAL2MXGenAuthCar()

Matrix card authentication

• AAL2MXGenerateChallenge()

• AAL2MXVerifyPassword()

Digipass CHAP & Microsoft Authentication service

CHAP and Microsoft response authentication

• AAL2VerifyWIN()

Software Digipass Activation service

The Software Digipass Activation service allows the standard activation of compliant authenticators in offline or online mode. When the software authenticator is activated, settings and secrets are written into the authenticator.

Software Digipass activation data generation

• AAL2GenActivationCodeEx()

• AAL2GenActivationCodeXErc()

Software Digipass activation data generation with random key generation

• AAL2GenActivationDataRndKey()

Software Digipass Derivation service

The Software Digipass Derivation service allows to derive the Digipass data of a software authenticator based on Digipass SDK 4.0 or later (software authenticator activated with the standard one-step activation).

• AAL2DeriveTokenBlobs()

Digipass Multi-Device Activation service

The Digipass Multi-Device Activation service groups functionalities for multi-device activation (two-step activation) of compliant authenticators (software or hardware).

Payload key BLOB generation

• AAL2GenPayloadKeyBlob()

Activation message 1 generation

• AAL2GenMessageActivation1()

Device code validation

• AAL2VerifyDeviceCode()

Activation message 2 and authenticator instance generation

• AAL2GenMessageActivation2()

Digipass Secure Channel service

The Digipass Secure Channel service groups functionalities for operations based on the secure channel protocol for compliant authenticators (software or hardware), including the generation of secure channel request messages and deactivation messages, and processing of response messages and information messages.

Request message generation

• AAL2GenMessageRequest()

Response message processing

• AAL2ProcMessageResponse()

Information message processing

• AAL2ProcMessageInformation()

Message properties retrieval

• AAL2GetMessageProperties()

Deactivation message generation

• AAL2GenMessageDeactivation()

Payload Key BLOB Management service

The Payload Key BLOB Management service provides facilities for the payload key BLOB management for help desk and administration purposes.

• AAL2MigratePKBlob()

• AAL2MigratePKBlobEx()

Data Conversion service

• AAL2ConvTokenData()

Version Information service

• AAL2GetLibraryVersion()

Error Management service

• AAL2DPXGetErrorMsg()

• AAL2GetErrorMsg()