|
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface PtConnectionAdvancedI
Extends PTAPI connection interface with advanced security operations.
Method Summary | |
---|---|
void |
controlLastMatchData(int action,
byte[] secret)
Controls status of last match data. |
void |
copyFingerData(PtInputBir srcTemplate,
int srcTag,
int dstSlotNr,
int dstTag,
int dstAccessRights)
Copies additional application data assigned to a finger template from one template to another one. |
PtBir |
copyFingerDataWrapped(PtInputBir srcTemplate,
int srcTag,
PtInputBir inputBIR,
int dstTag,
int dstAccessRights)
Copies additional application data assigned to a finger template from a template to another wrapped template. |
byte[] |
createProfileWrapped(byte[] authKey,
byte[] accessRights)
Creates wrapped profile. |
byte[] |
deviceControl(int controlCode,
byte[] inData)
Calls FM's extension operations in IOCTL-like style. |
byte[] |
diagnostics(byte[] inData,
IntegerArgI resultCode)
Runs built-in FM Diagnostics. |
byte[] |
generateDeviceKeyPair(int keyType,
int keyLength,
int publicExponent,
int flags)
Generates new random RSA key pair. |
byte[] |
getFingerDataEx(PtInputBir template,
int tag)
Reads the additional application data associated with a finger template stored in FM's non-volatile memory or with a wrapped template. |
PtBir |
loadFingerEx(PtInputBir inputBIR,
boolean returnPayload)
Loads template from stored slot or wrapped template. |
int |
queryFingerData(PtInputBir template,
int tag)
Queries access rights of additional application data associated with a finger template stored in FM's non-volatile memory. |
void |
setDevicePrivateKey(int keyType,
byte[] privateKey)
Stores private part of RSA key pair to the device. |
void |
setFingerDataEx(int slotNr,
int tag,
int accessRights,
byte[] fingerData)
Assigns an additional application data to a finger template stored in FM's non-volatile memory. |
PtBir |
setFingerDataExWrapped(PtInputBir inputBIR,
int tag,
int accessRights,
byte[] fingerData)
Assigns an additional application data to a finger template stored in wrapped template. |
void |
setProfileWrapped(byte[] wrappedProfile)
Sets wrapped profile created previously by createProfileWrapped(). |
PtBir |
storeFingerWrapped(PtInputBir template)
Stores given fingerprint template into wrapped template. |
byte[] |
useFingerData(PtInputBir template,
int tag,
int operation,
byte[] inputData)
Performs given 'use' operation with finger data of specified template. |
byte[] |
useSetFingerData(int slotNr,
int tag,
int accessRights,
int operation,
byte[] inputData)
Performs given 'use-set' operation and store result as finger data of specified template stored in FM's non-volatile memory. |
PtBir |
useSetFingerDataWrapped(PtInputBir inputBir,
int tag,
int accessRights,
int operation,
byte[] inputData,
ByteArrayArgI outputData)
Performs given 'use-set' operation and store result as finger data of specified wrapped template. |
byte[] |
useUpdateFingerData(int slotNr,
int tag,
int operation,
byte[] inputData)
Performs given 'use-update' operation with finger data of specified template stored in FM's non-volatile memory, updated finger data are stored back to non-volatile memory. |
PtBir |
useUpdateFingerDataWrapped(PtInputBir inputBir,
int tag,
int operation,
byte[] inputData,
ByteArrayArgI outputData)
Performs given 'use-update' operation with finger data of specified wrapped template, updated wrapped template is returned back to host. |
Method Detail |
---|
void controlLastMatchData(int action, byte[] secret) throws PtException
action
- Requested action (see PT_LMD_xxxx values).secret
- Optional data for some actions, can be NULL.
PtException
- Exception with operation status (error) code.void copyFingerData(PtInputBir srcTemplate, int srcTag, int dstSlotNr, int dstTag, int dstAccessRights) throws PtException
srcTemplate
- Source template whose application data has to be copied.srcTag
- Source finger data tag.dstSlotNr
- The slot number of the destination template to which the finger
data has to be copied.dstTag
- Destination finger data tag.dstAccessRights
- Destination finger data access rights.
PtException
- Exception with operation status (error) code.PtBir copyFingerDataWrapped(PtInputBir srcTemplate, int srcTag, PtInputBir inputBIR, int dstTag, int dstAccessRights) throws PtException
srcTemplate
- Source template whose application data has to be copied.srcTag
- Source finger data tag.inputBIR
- Pointer to a wrapped template to which the finger data has to be copied.dstTag
- Destination finger data tag.dstAccessRights
- Destination finger data access rights.
PtException
- Exception with operation status (error) code.byte[] createProfileWrapped(byte[] authKey, byte[] accessRights) throws PtException
authKey
- Authentication key to be used with created profile.accessRights
- Access rights mask to be used with created profile, if it is NULL then
access rights mask of current account is used.
PtException
- Exception with operation status (error) code.byte[] deviceControl(int controlCode, byte[] inData) throws PtException
controlCode
- The control code for the operation.inData
- The input buffer that contains the data required to perform the operation.
PtException
- Exception with operation status (error) code.byte[] diagnostics(byte[] inData, IntegerArgI resultCode) throws PtException
inData
- Input data block.
PtException
byte[] generateDeviceKeyPair(int keyType, int keyLength, int publicExponent, int flags) throws PtException
keyType
- Type of key to be generated.keyLength
- Length of generated key in bits. Allowed values
are 512, 768, 1024, 1536 and 2048.publicExponent
- Value of key's public exponent, allowed
values are 0, 3, 17 and 65537 (0 is internally interpreted as 3).flags
- Additional flags for key generation.
PtException
- Exception with operation status (error) code.byte[] getFingerDataEx(PtInputBir template, int tag) throws PtException
template
- Template whose application data has to be read.tag
- Finger data tag.
PtException
- Exception with operation status (error) code.PtBir loadFingerEx(PtInputBir inputBIR, boolean returnPayload) throws PtException
inputBIR
- Source of the template, it can be slot or wrapped templatereturnPayload
- If TRUE then the template is returned with its payload.
PtException
- Exception with operation status (error) code.int queryFingerData(PtInputBir template, int tag) throws PtException
template
- Template whose application data are inquired.tag
- Finger data tag.
PtException
- Exception with operation status (error) code.void setDevicePrivateKey(int keyType, byte[] privateKey) throws PtException
keyType
- Type of key to be set.privateKey
- Private part of stored key pair.
PtException
- Exception with operation status (error) code.void setFingerDataEx(int slotNr, int tag, int accessRights, byte[] fingerData) throws PtException
slotNr
- The slot number of the template to be associated with data.tag
- Finger data tag.accessRights
- Access rights assigned to this finger data.fingerData
- The data to be stored together with the template. If
the data length is zero, the application data associated with given fingerprint
will be deleted
PtException
- Exception with operation status (error) code.PtBir setFingerDataExWrapped(PtInputBir inputBIR, int tag, int accessRights, byte[] fingerData) throws PtException
inputBIR
- Input wrapped template in which finger data has to be modified.tag
- Finger data tag.accessRights
- Access rights assigned to this finger data.fingerData
- The data to be stored together with the template. If
the data length is zero, the application data associated with given fingerprint
will be deleted
PtException
- Exception with operation status (error) code.void setProfileWrapped(byte[] wrappedProfile) throws PtException
wrappedProfile
- Wrapped profile to be set.
PtException
- Exception with operation status (error) code.PtBir storeFingerWrapped(PtInputBir template) throws PtException
template
- Template (BIR) to be stored into wrapped template.
PtException
- Exception with operation status (error) code.byte[] useFingerData(PtInputBir template, int tag, int operation, byte[] inputData) throws PtException
template
- Template whose application data has to be used.tag
- Finger data tag.operation
- Operation to be performed.inputData
- Additional data used in operation.
PtException
byte[] useSetFingerData(int slotNr, int tag, int accessRights, int operation, byte[] inputData) throws PtException
slotNr
- The slot number of the template with which will be
the result of the operation stored.tag
- Finger data tag.accessRights
- Access rights assigned to the stored finger data.operation
- Operation to be performed.inputData
- Additional data used in operation.
PtException
- Exception with operation status (error) code.PtBir useSetFingerDataWrapped(PtInputBir inputBir, int tag, int accessRights, int operation, byte[] inputData, ByteArrayArgI outputData) throws PtException
inputBir
- Input wrapped template to which will be stored
the result of given operation.tag
- Finger data tag.accessRights
- Access rights assigned to the stored finger data.operation
- Operation to be performed.inputData
- Additional data used in operation.outputData
- Address of the pointer, which will be set to point to the
operation's output data.
PtException
- Exception with operation status (error) code.byte[] useUpdateFingerData(int slotNr, int tag, int operation, byte[] inputData) throws PtException
slotNr
- The slot number of the template whose finger data will
be used for given operation.tag
- Finger data tag.operation
- Operation to be performed.inputData
- Additional data used in operation.
PtException
- Exception with operation status (error) code.PtBir useUpdateFingerDataWrapped(PtInputBir inputBir, int tag, int operation, byte[] inputData, ByteArrayArgI outputData) throws PtException
inputBir
- Input wrapped template whose finger data will be used
for given operation.tag
- Finger data tag.operation
- Operation to be performed.inputData
- Additional data used in operation.outputData
- Address of the pointer, which will be set to point to the
operation's output data.
PtException
- Exception with operation status (error) code.
|
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |