DigipassService

Overview

The DigipassService provides functionalities for managing Vasco Digipass tokens, including activation, authentication, validation, and signature processing. It interfaces with secure messaging protocols and database storage for handling secure authentication workflows.

Available Functions

setJdbcUrl(String jdbcUrl)

Sets the JDBC URL for database connection.

• Parameters:

  • jdbcUrl (String): The database connection URL.

setUsername(String username)

Sets the database username.

• Parameters:

  • username (String): The username for authentication.

setPassword(String password)

Sets an encrypted or plain password for database authentication.

• Parameters:

  • password (String): The password to store.

setDataSource(DataSource dataSource)

Assigns a data source and tests the connection.

• Parameters:

  • dataSource (DataSource): The database source.

generateChallenge(String serialNumber, String mode): String

Generates a Digipass challenge for authentication.

• Parameters:

  • serialNumber (String): The serial number of the token.

  • mode (String): The Digipass mode.

• Returns:

  • String: The generated challenge.

authenticateWithChallenge(String serialNumber, String mode, String challenge, String password): DigipassAuthentication

Authenticates a user against a challenge.

• Parameters:

  • serialNumber (String): The Digipass serial number.

  • mode (String): The Digipass mode.

  • challenge (String): The generated challenge.

  • password (String): The user's response.

• Returns:

  • DigipassAuthentication: An object containing authentication details.

mdlGenAuthRequest(String serialNumber, DigipassMdlSignOptions options): DigipassMdlSignRequest

Generates an authentication request for signing.

• Parameters:

  • serialNumber (String): The Digipass serial number.

  • options (DigipassMdlSignOptions): Customization options.

• Returns:

  • DigipassMdlSignRequest: The authentication request.

mdlValidateSignature(String serialNumber, String signedMessage, String signature, int expirationTime): DigipassMdlSignReply

Validates a signature generated from a signing request.

• Parameters:

  • serialNumber (String): The Digipass serial number.

  • signedMessage (String): The signed message.

  • signature (String): The user's signature.

  • expirationTime (int): Timeout duration.

• Returns:

  • DigipassMdlSignReply: Validation results.

validateOtp(String serial, String application, String otp)

Validates a one-time password (OTP).

• Parameters:

  • serial (String): The serial number of the Digipass token.

  • application (String): The application name.

  • otp (String): The OTP to validate.

getFreeDigipass(String dpType): String

Retrieves an available Digipass token.

• Parameters:

  • dpType (String): Type of Digipass.

• Returns:

  • String: The serial number of the available Digipass.

resetStaticPassword(String serialNumber)

Resets the static password of a Digipass.

• Parameters:

  • serialNumber (String): The Digipass serial number.

getDigipassStatus(String serialNumber, String application): int

Retrieves the current status of a Digipass.

• Parameters:

  • serialNumber (String): The Digipass serial number.

  • application (String): The application name.

• Returns:

  • int: The status code.

Summary

The DigipassService provides core functionalities for:

• Managing Digipass tokens (activation, authentication, and validation).

• Processing secure transactions using Vasco's security mechanisms.

• Storing and retrieving Digipass information from a secure database.

This service is essential for implementing strong multi-factor authentication solutions.