public interface CDCVMBrokerListener extends BrokerListener
BrokerListener
interface including definitions specific to the CDCVM (Consumer Device CVM) use case. When invoking this interface, in order to form a valid parameter value the caller shall:
BrokerListener.onBrokerEvent(short, short, short, short, short, short, short)
:event
parameter, combine (OR-ing) a EVENT_CDCVM_XXX
constant with a CDCVM_TYPE_XXX
constant.
info
parameter, build a short
value of the form 'XYZZ' where:event
parameter). A value of 15 ('F') indicates that the number of remaining
tries is unknown, not applicable or greater than 14.
environment
parameter, combine (OR-ing) a ENV_CAPTURE_XXX
constant with a ENV_VERIFICATION_XXX
constant.
device
parameter, combine (OR-ing) a DEVICE_CAPTURE_XXX
constant with a DEVICE_VERIFICATION_XXX
constant.
security
parameter, combine (OR-ing) a SECURITY_CAPTURE_XXX
constant with a SECURITY_VERIFICATION_XXX
constant.
assurance
parameter: use the ASSURANCE_LEVEL_UNKNOWN
constant (NOTE: other choices may be defined in the future).
BrokerListener.initBrokerRequest(short)
:request
parameter, combine (OR-ing) a REQUEST_CDCVM_XXX
constant with a CDCVM_TYPE_XXX
constant.
E.g.
listener.onBrokerEvent((short)(EVENT_CDCVM_VERIFICATION_SUCCEEDED|CDCVM_TYPE_FINGERPRINT),...);The implementation of this interface may use the
MASK_XXX
constants to inspect the received parameters. E.g.
switch ((short)(event&MASK_EVENT_CDCVM)) { case EVENT_CDCVM_VERIFICATION_SUCCEEDED: ... if ((short)(event&MASK_CDCVM_TYPE) == CDCVM_TYPE_FINGERPRINT) { ... if ((short)(environment&MASK_ENV_VERIFICATION) == ENV_VERIFICATION_CLOUD) { ... } } break; case EVENT_CDCVM_VERIFICATION_FAILED: ... case EVENT_CDCVM_BLOCKED: ... case EVENT_CDCVM_INVALIDATE: ... }
SIO_BROKER_LISTENER
initBrokerRequest, onBrokerEvent, processBrokerRequest, updateBrokerRequest
static final byte SIO_CDCVM_BROKER_LISTENER
When using this constant to retrieve a BrokerListener
instance, the
caller should explicitly cast the object returned by the Application to the
type CDCVMBrokerListener
to ensure it is of the correct type.
JCSystem.getAppletShareableInterfaceObject(javacard.framework.AID, byte)
,
Constant Field Valuesstatic final short MASK_EVENT_CDCVM
static final short EVENT_CDCVM_NOT_PERFORMED
static final short EVENT_CDCVM_VERIFICATION_SUCCEEDED
static final short EVENT_CDCVM_VERIFICATION_FAILED
static final short EVENT_CDCVM_BLOCKED
static final short EVENT_CDCVM_VERIFICATION_CONSUMED
static final short EVENT_CDCVM_ERROR
static final short EVENT_CDCVM_VERIFICATION_INVALIDATED
EVENT_CDCVM_VERIFICATION_SUCCEEDED
shall be discarded. This event shall
be notified once only. After that, until the Broker Application gets aware of any new CDCVM event,
the Broker Application shall notify EVENT_CDCVM_NOT_PERFORMED
to
any application requesting information about the last CDCVM event
(i.e. using the CDCVMBrokerCallbackRequest
).static final short MASK_CDCVM_TYPE
static final short CDCVM_TYPE_PASSCODE
static final short CDCVM_TYPE_FINGERPRINT
static final short CDCVM_TYPE_DEVICE_PATTERN
static final short CDCVM_TYPE_FACIAL_BIOMETRIC
static final short CDCVM_TYPE_IRIS_BIOMETRIC
static final short CDCVM_TYPE_VOICE_BIOMETRIC
static final short CDCVM_TYPE_VEIN_RECOGNITION
static final short MASK_INFO_TRIES
static final short MASK_INFO_TRY_LIMIT
static final short MASK_INFO_REMAINING_TRIES
static final short MASK_ENV_CAPTURE
static final short ENV_CAPTURE_UNKNOWN
static final short ENV_CAPTURE_UNTRUSTED_HW
static final short ENV_CAPTURE_TRUSTED_HW
static final short ENV_CAPTURE_EXTERNAL_TRUSTED_DEVICE
static final short MASK_ENV_VERIFICATION
static final short ENV_VERIFICATION_UNKNOWN
static final short ENV_VERIFICATION_HOST_DEVICE_OS
static final short ENV_VERIFICATION_TEE
static final short ENV_VERIFICATION_REE
static final short ENV_VERIFICATION_CLOUD
static final short ENV_VERIFICATION_SE
static final short ENV_VERIFICATION_OTHER_SE
static final short ENV_VERIFICATION_EXTERNAL_TRUSTED_DEVICE
static final short MASK_DEVICE_CAPTURE
static final short DEVICE_CAPTURE_UNKNOWN
static final short DEVICE_CAPTURE_HOST
static final short DEVICE_CAPTURE_MOBILE_COMPANION
static final short MASK_DEVICE_VERIFICATION
static final short DEVICE_VERIFICATION_UNKNOWN
static final short DEVICE_VERIFICATION_HOST
static final short DEVICE_VERIFICATION_MOBILE_COMPANION
static final short SECURITY_CAPTURE_DATA_UNKNOWN
static final short SECURITY_CAPTURE_DATA_NOT_APPLICABLE
static final short MASK_SECURITY_CAPTURE_DATA
static final short SECURITY_CAPTURE_DATA_SECURE_CHANNEL
static final short SECURITY_CAPTURE_DATA_DEDICATED_IO_NO_SC
static final short SECURITY_VERIFICATION_RESULT_UNKNOWN
static final short SECURITY_VERIFICATION_RESULT_NOT_APPLICABLE
static final short MASK_SECURITY_VERIFICATION_RESULT
static final short SECURITY_VERIFICATION_RESULT_SECURE_CHANNEL
static final short SECURITY_VERIFICATION_RESULT_DEDICATED_IO_NO_SC
static final short ASSURANCE_LEVEL_UNKNOWN
static final short MASK_REQUEST_CDCVM
static final short REQUEST_CDCVM_VERIFY
Copyright © 2003-2019 GlobalPlatform, Inc. All rights reserved. The technology provided or described in this specification is subject to updates, revisions, and extensions by GlobalPlatform. Recipients of this document are invited to submit, with their comments, notification of any relevant patent rights or other intellectual property rights of which they may be aware which might be necessarily infringed by the implementation of the specification or other work product set forth in this document, and to provide supporting documentation.
THIS SPECIFICATION OR OTHER WORK PRODUCT IS BEING OFFERED WITHOUT ANY WARRANTY WHATSOEVER, AND IN PARTICULAR, ANY WARRANTY OF NON-INFRINGEMENT IS EXPRESSLY DISCLAIMED. ANY IMPLEMENTATION OF THIS SPECIFICATION OR OTHER WORK PRODUCT SHALL BE MADE ENTIRELY AT THE IMPLEMENTER'S OWN RISK, AND NEITHER THE COMPANY, NOR ANY OF ITS MEMBERS OR SUBMITTERS, SHALL HAVE ANY LIABILITY WHATSOEVER TO ANY IMPLEMENTER OR THIRD PARTY FOR ANY DAMAGES OF ANY NATURE WHATSOEVER DIRECTLY OR INDIRECTLY ARISING FROM THE IMPLEMENTATION OF THIS SPECIFICATION OR OTHER WORK PRODUCT.