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	checkIfExistsOrNew(AuthCodeDataBO data)
ScaAuthConfirmationBO	completeAuthConfirmation(String authorisationId, boolean authCodeConfirmed) Compete auth confirmation process
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;
de.adorsys.ledgers.util.exception.ScaModuleException	updateFailedCount(String authorisationId, boolean isLoginOperation)
ScaValidationBO	validateAuthCode(String authorisationId, String opId, String opData, String authCode, int scaWeight) Verify that the auth code, recomputing and verifying the hash of (Auth Code and opData).
ScaAuthConfirmationBO	verifyAuthConfirmationCode(String authorisationId, String confirmationCode) Verify auth confirmation code

Method Detail

generateAuthCode

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.

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.

validateAuthCode

ScaValidationBO validateAuthCode(String authorisationId,
                                 String opId,
                                 String opData,
                                 String authCode,
                                 int scaWeight)

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:

SCA validation object

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)

Load an auth code data object from the database.

Parameters:

authorizationId - identifier of Authorization object

Returns:

SCA Operation object

authenticationCompleted

boolean authenticationCompleted(String opId,
                                OpTypeBO opType)

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

Parameters:

opId - identifier of primary operation for which authorization is carried

opType - type of primary operation

Returns:

boolean representation of success or failure

verifyAuthConfirmationCode

ScaAuthConfirmationBO verifyAuthConfirmationCode(String authorisationId,
                                                 String confirmationCode)

Verify auth confirmation code

Parameters:

authorisationId - : the id of this authorization instance.

confirmationCode - : Auth confirmation code

completeAuthConfirmation

ScaAuthConfirmationBO completeAuthConfirmation(String authorisationId,
                                               boolean authCodeConfirmed)

Compete auth confirmation process

Parameters:

authorisationId - : the id of this authorization instance.

authCodeConfirmed - : Auth confirmation code was successfully confirmed or not

checkIfExistsOrNew

SCAOperationBO checkIfExistsOrNew(AuthCodeDataBO data)

updateFailedCount

de.adorsys.ledgers.util.exception.ScaModuleException updateFailedCount(String authorisationId,
                                                                       boolean isLoginOperation)