org.cyclos.impl.access

Interface DeviceConfirmationServiceLocal

All Superinterfaces:

DeviceConfirmationService, Service

public interface DeviceConfirmationServiceLocal
extends DeviceConfirmationService

Local interface for device confirmations.

Author:

ameyer

Field Summary

Fields inherited from interface org.cyclos.services.access.DeviceConfirmationService

DEVICE_CONFIRMATION_VALUE_PREFIX

Method Summary

Modifier and Type	Method and Description
void	check(long confirmationId, CreateDeviceConfirmationParams params) Checks if the confirmation was approved and also its QR-content matches the generated from the CreateDeviceConfirmationParams parameter.
DeviceConfirmationVO	create(CreateDeviceConfirmationParams params, BasicUser creatorUser, BasicUser ownerUser, boolean unmaskIds) Creates a new pending for approval device confirmation for the owner user.
static BasicUser	getCreatorUserAttr(CreateDeviceConfirmationParams params) The creator user attribute is used in some cases where the confirmation's owner user is different than the user who created the confirmation (e.g in a receive payment the creator is the payee)
java.util.Map<MessageKey,java.lang.Object>	getQRFields(DeviceConfirmationType type, java.util.Map<DeviceConfirmationField,java.lang.Object> canonicalValues) Returns a map with the fields used to generated the QR content for a given device confirmation type
static boolean	isDeviceConfirmation(java.lang.String confirmationPassword) Returns true if the password represents a device confirmation.
static void	setCreatorUserAttr(CreateDeviceConfirmationParams params, BasicUser user)
void	validate(long id, long deviceId, java.lang.String hmac) Validates a confirmation with a device to ensure the device is a valid trusted device.

Methods inherited from interface org.cyclos.services.access.DeviceConfirmationService

approve, barcode, create, getApprovalData, load, reject, remove

Method Detail

getCreatorUserAttr

static BasicUser getCreatorUserAttr(CreateDeviceConfirmationParams params)

The creator user attribute is used in some cases where the confirmation's owner user is different than the user who created the confirmation (e.g in a receive payment the creator is the payee)

isDeviceConfirmation

static boolean isDeviceConfirmation(java.lang.String confirmationPassword)

Returns true if the password represents a device confirmation.

setCreatorUserAttr

static void setCreatorUserAttr(CreateDeviceConfirmationParams params,
                               BasicUser user)

check

void check(long confirmationId,
           CreateDeviceConfirmationParams params)
    throws InvalidDeviceConfirmationException

Checks if the confirmation was approved and also its QR-content matches the generated from the CreateDeviceConfirmationParams parameter. Also, if the confirmation was found and is approved then it's removed.

Throws:

InvalidDeviceConfirmationException - if the confirmation was not found or is invalid. The possible values contained in the exception are: InvalidDeviceConfirmationResult.INVALID_CONFIRMATION and InvalidDeviceConfirmationResult.MAX_CHECK_ATTEMPTS_REACHED.
This method blocks the user if the max attempts was reached.

create

DeviceConfirmationVO create(CreateDeviceConfirmationParams params,
                            BasicUser creatorUser,
                            BasicUser ownerUser,
                            boolean unmaskIds)

Creates a new pending for approval device confirmation for the owner user. If the ids present in the 'params' object are masked then set the 'unmaskIds' flag to true. If a 'creatorUser' is given then the push-notification will be send to that user instead of to the owner user.

getQRFields

java.util.Map<MessageKey,java.lang.Object> getQRFields(DeviceConfirmationType type,
                                                       java.util.Map<DeviceConfirmationField,java.lang.Object> canonicalValues)

Returns a map with the fields used to generated the QR content for a given device confirmation type

Parameters:

canonicalValues - the values obtained after parsing the CreateDeviceConfirmationParams.FIELDS map NOTE: This method is used by the associated junit-test class (that was the reason to be placed in the local interface)

validate

void validate(long id,
              long deviceId,
              java.lang.String hmac)
       throws InvalidDeviceConfirmationException

Validates a confirmation with a device to ensure the device is a valid trusted device. This method perform the same validation as for DeviceConfirmationService.approve(long, long, String) but immediately remove the confirmation and do not send any push-notification if the validation success.

Throws:

InvalidDeviceConfirmationException