com.gemalto.idp.mobile.otp.vic

Interface VicDevice

public interface VicDevice

An interface defining a device that verifies VIC codes.

Since:

4.0

Method Summary

Modifier and Type	Method and Description
boolean	isVerifyBlocked() Check if Verify Issuer Code is blocked (verifyIssuerCode(com.gemalto.idp.mobile.core.util.SecureString, com.gemalto.idp.mobile.authentication.AuthInput)).
boolean	isVerifyLastAttempt() Check if Verify Issuer Code is the last attempt (verifyIssuerCode(com.gemalto.idp.mobile.core.util.SecureString, com.gemalto.idp.mobile.authentication.AuthInput)).
boolean	verifyIssuerCode(SecureString vic, AuthInput authInput) Verify the code given by the caller to authenticate him

Method Detail

isVerifyBlocked

boolean isVerifyBlocked()
                 throws IdpException

Check if Verify Issuer Code is blocked (verifyIssuerCode(com.gemalto.idp.mobile.core.util.SecureString, com.gemalto.idp.mobile.authentication.AuthInput)).

This method is affected by the PUK Try Counter value.

Returns:

true if verify issuer code is blocked

Throws:

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

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)

isVerifyLastAttempt

boolean isVerifyLastAttempt()
                     throws IdpException

Check if Verify Issuer Code is the last attempt (verifyIssuerCode(com.gemalto.idp.mobile.core.util.SecureString, com.gemalto.idp.mobile.authentication.AuthInput)).

This method is affected by the PUK Try Counter value.

Returns:

true if only one attempt left for the Verify Issuer Code

Throws:

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

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)

verifyIssuerCode

boolean verifyIssuerCode(SecureString vic,
                         AuthInput authInput)
                  throws IdpException

Verify the code given by the caller to authenticate him

Parameters:

vic - the code to be verified

authInput - the authInput for authentication

Returns:

true if the code is correct. false otherwise

Throws:

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

VicException - when the ATC counter reaches its maximum value or when the Try Counter is blocked.

IdpAuthException - When Authentication mode is not property activated.

IllegalArgumentException - when the length of the VIC code is incorrect.

IdpRuntimeException - when there is a cryptography operation failure.

IdpStorageException - when there is a database operation failure

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)