de.adorsys.ledgers.sca.service

Interface SCAOperationService

public interface SCAOperationService

Method Summary

Modifier and Type	Method and Description
boolean	authenticationCompleted(String opId, OpTypeBO opType) Return true if all authorization instances of this operation are validated.
SCAOperationBO	createAuthCode(AuthCodeDataBO authCodeData, ScaStatusBO scaStatus) Creates an authCodeData object.
SCAOperationBO	generateAuthCode(AuthCodeDataBO authCodeData, UserBO user, ScaStatusBO scaStatus) Generates an authentication code, hashes it using the operation data and stores the hash for later verification.
SCAOperationBO	loadAuthCode(String authorizationId) Load an auth code data object from the database.
void	processExpiredOperations() All operations that have status NEW will be changed on EXPIRED if date of creation + validitySeconds in the past, unless validitySeconds is -1;
boolean	validateAuthCode(String authorisationId, String opId, String opData, String authCode) Verify that the auth code, recomputing and verifying the hash of (Auth Code and opData).

Method Detail

generateAuthCode

SCAOperationBO generateAuthCode(AuthCodeDataBO authCodeData,
                                UserBO user,
                                ScaStatusBO scaStatus)
                         throws SCAMethodNotSupportedException,
                                UserScaDataNotFoundException,
                                SCAOperationValidationException,
                                SCAOperationNotFoundException

Generates an authentication code, hashes it using the operation data and stores the hash for later verification.

Parameters:

authCodeData - : data for generation auth code

user - : the user object

scaStatus - : the actual scaStatus to be set if auth code is generated and sent.

Returns:

the generated AuthCode in clear text.

Throws:

SCAMethodNotSupportedException

UserScaDataNotFoundException

SCAOperationNotFoundException

SCAOperationValidationException

validateAuthCode

boolean validateAuthCode(String authorisationId,
                         String opId,
                         String opData,
                         String authCode)
                  throws SCAOperationNotFoundException,
                         SCAOperationValidationException,
                         SCAOperationUsedOrStolenException,
                         SCAOperationExpiredException

Verify that the auth code, recomputing and verifying the hash of (Auth Code and opData).

Parameters:

authorisationId - : the id of this authorization instance.

opId - : This is the id of the operation like provided by the consuming module.

opData - : This are data to be linked to the generated One Time Password.

authCode - : This auth code was generated at previous step @see #generateAuthCode(String opId, String opData, int validitySeconds)

Returns:

true if auth code is valid in other cases false will be returned

Throws:

SCAOperationNotFoundException

SCAOperationValidationException

SCAOperationUsedOrStolenException

SCAOperationExpiredException

processExpiredOperations

void processExpiredOperations()

All operations that have status NEW will be changed on EXPIRED if date of creation + validitySeconds in the past, unless validitySeconds is -1;

createAuthCode

SCAOperationBO createAuthCode(AuthCodeDataBO authCodeData,
                              ScaStatusBO scaStatus)

Creates an authCodeData object.

Parameters:

authCodeData - : data for generation auth code

scaStatus - : the actual scaStatus to be set.

Returns:

the created AuthCode wrapped.

loadAuthCode

SCAOperationBO loadAuthCode(String authorizationId)
                     throws SCAOperationNotFoundException

Load an auth code data object from the database.

Parameters:

authorizationId -

Returns:

Throws:

SCAOperationNotFoundException

authenticationCompleted

boolean authenticationCompleted(String opId,
                                OpTypeBO opType)

Return true if all authorization instances of this operation are validated.

Parameters:

opId -

opType -

Returns: