Digital Authentication Framework 4.2.0.30
Public Member Functions | Protected Attributes | Package Functions

com.good.daf.app.EnrollProcessParams Class Reference

A collection of parameters for completing an DAF enrollment in a background thread. More...

Inheritance diagram for com.good.daf.app.EnrollProcessParams:
com.good.daf.app.GeneralProcessParams com.good.daf.app.ProgressCallback

List of all members.

Public Member Functions

void start ()
 Start the enrollment process.
void setPassphrase (byte[] pass)
 Inputs the pre-collected passphrase.
byte[] getPassphrase ()
 Gets the pre-collected passphrase.
void setPassphraseCallback (PassphraseCallback pc)
 Sets the passphrase collection callback.
void setUserString (byte[] us)
 Sets the 'user string' -- an arbitrary string stored inside with the state resulting from the enrollment.
byte[] getUserString ()
void setAuthToken (byte[] token)
 Sets the DAF authentication token.
byte[] getAuthToken ()

Protected Attributes

byte[] passphrase
byte[] authToken = new byte[] {}
byte[] newUserString = null
PassphraseCallback passphraseCallback

Package Functions

byte[] requestPassphrase () throws Exception
 Internal: call the passphraseCallback to obtain a passphrase.

Detailed Description

A collection of parameters for completing an DAF enrollment in a background thread.


Member Function Documentation

byte [] com.good.daf.app.EnrollProcessParams.getAuthToken ( )
Returns:
the last value passed to setAuthToken, or the empty bytestring by default
byte [] com.good.daf.app.EnrollProcessParams.getPassphrase ( )

Gets the pre-collected passphrase.

Returns:
the last value given to setPassphrase()
byte [] com.good.daf.app.EnrollProcessParams.getUserString ( )
Returns:
the last value given to setUserString(), or null if it has never been called.
byte [] com.good.daf.app.EnrollProcessParams.requestPassphrase ( ) throws Exception [package]

Internal: call the passphraseCallback to obtain a passphrase.

Returns:
the passphrase returned by the callback.
void com.good.daf.app.EnrollProcessParams.setAuthToken ( byte[]  token)

Sets the DAF authentication token.

The authentication token is a sequence of bytes with hardware-specific format and semantics, which can be used by the hardware driver to authenticate the user.

The default authtoken is the empty string.

Parameters:
tokennew auth token
void com.good.daf.app.EnrollProcessParams.setPassphrase ( byte[]  pass)

Inputs the pre-collected passphrase.

If you know this process will always require a passphrase, you can collect it from the user before beginning the process and input it here.

This overrides any callback passed to setPassphraseCallback.

Parameters:
passpre-collected passphrase
void com.good.daf.app.EnrollProcessParams.setPassphraseCallback ( PassphraseCallback  pc)

Sets the passphrase collection callback.

See the documentation for PassphraseCallback for the rules surrounding this call.

setPassphrase() overrides this method.

Parameters:
pcnew passphrase callback implementor
void com.good.daf.app.EnrollProcessParams.setUserString ( byte[]  us)

Sets the 'user string' -- an arbitrary string stored inside with the state resulting from the enrollment.

This can be used to remember the identity of the device that authentication must be performed with.

Class 0 devices must not store the device identity here. The value is effectively unencrypted (because it must be available in plaintext before the GD container is unlocked.)

This is optional. By default, no user string is stored.

Parameters:
usnew user string value
void com.good.daf.app.EnrollProcessParams.start ( )

Start the enrollment process.

This call completes quickly; the actual process takes place in a background worker thread. Provide a ProgressCallback if you want to be notified of the worker thread's results.


The documentation for this class was generated from the following file: