1-Wire API for .NET Version 4.00
|
Inherits com::dalsemi::onewire::application::sha::SHATransaction.
Public Member Functions | |
SHASoftAuth (SHAiButtonCopr copr) | |
SHADebit constructor. | |
SHASoftAuth (SHAiButtonCopr copr, byte[] extra_data, int len) | |
SHADebit constructor. | |
boolean | setupTransactionData (SHAiButtonUser user) throws OneWireException, OneWireIOException |
synchronized boolean | verifyUser (SHAiButtonUser user) throws OneWireException, OneWireIOException |
synchronized boolean | verifyTransactionData (SHAiButtonUser user) throws OneWireException, OneWireIOException |
synchronized boolean | executeTransaction (SHAiButtonUser user, boolean verifySuccess) throws OneWireException, OneWireIOException |
synchronized int | getParameter (int type) |
synchronized int | getParameter (int type, byte[] data, int offset, int len) |
synchronized boolean | setParameter (int type, byte[] data, int offset, int len) |
synchronized boolean | setParameter (int type, int param) |
synchronized void | resetParameters () |
Static Public Attributes | |
static final int | VERIFICATION_DATA = 2 |
Update the verification data. | |
static final int | I_FILE_LENGTH = 0 |
indices for fields in user account file | |
Protected Member Functions | |
SHASoftAuth () | |
User apps should never call this. |
This class implements an software authrization account application for SHA Transactions. The account data is stored on the user iButtons after being digitally signed by a virtual machine coprocessor. Account data consists of the following:
A typical use case for this class might be as follows:
OneWireContainer18 coprOWC18 = new OneWireContainer18(adapter,address);
//COPR.0 is the filename for coprocessor service data SHAiButtonCopr copr = new SHAiButtonCopr(coprOWC18,"COPR.0");
//Initial amount for new users is $100, and debit amount is 50 cents byte[] ver_data = new byte[] {0x00,0x01,0x02,0x03,0x04,0x05,0x06}; SATransaction trans = new SHAsoftauth(copr, ver_data, 7);
OneWireContainer18 owc18 = new OneWireContainer18(adapter, userAddress);
//The following constructor erases all transaction data from the user and //installs the system authentication secret on the user iButton. SHAiButtonUser user = new SHAiButtonUser18(copr, owc18, true, authSecret);
//creates account data on iButton if(trans.setupTransactionData(user)) System.out.println("Account data installed successfully"); else System.out.println("Account data installation failed");
//... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ...
//"challenges" user iButton if(trans.verifyUser(user)) { System.out.println("User Verified Successfully");
//checks data signature if(trans.verifyTransactionData(user)) { System.out.println("Account Data Verified Successfully");
//writes verification data to user iButton System.out.println("User's verification data: "); softauth.getParameter(SHASoftAuth.VERIFICATION_DATA, ver_data,0,7); IOHelper.writeBytes(ver_data); } }
//... ... ... ... ... ... ... ... ... ... ... ... ... ... ... ...
if(trans.getLastError()!=0) { System.err.println("Error code: " + trans.getLastError()); }
This class makes use of several performance enhancements for TINI. For instance, most methods are synchronized
to access instance variable byte arrays rather than creating new byte arrays every time a transaction is performed. This could hurt performance in multi-threaded applications, but the usefulness of having several threads contending to talk to a single iButton is questionable since the methods in com.dalsemi.onewire.adapter.DSPortAdapter
beginExclusive(boolean)
and endExclusive()
should be used.
SHASoftAuth | ( | SHAiButtonCopr | copr | ) |
SHADebit constructor.
copr
is the SHAiButtonCopr that is used to perform this transaction. After saving a reference to the SHA coprocessor, this constructor resets all parameters for this type of transaction to their default values.
copr | The coprocessor used for authentication and data signing in this transaction. |
SHASoftAuth | ( | SHAiButtonCopr | copr, |
byte[] | extra_data, | ||
int | len | ||
) |
SHADebit constructor.
copr
is the SHAiButtonCopr that is used to perform this transaction. After saving a reference to the SHA coprocessor, this constructor resets all parameters for this type of transaction to their default values.
copr | The coprocessor used for authentication and data signing in this transaction. |
extra_data | The 7 bytes of extra data to be used instead of the balance. |
len | The len, 7 or less of the data. It is 0 padded. |
synchronized boolean executeTransaction | ( | SHAiButtonUser | user, |
boolean | verifySuccess | ||
) | throws OneWireException, OneWireIOException [virtual] |
Performs the signed debit, subtracting the debit amount from the user's balance and storing the new, signed account data on the user's iButton. The debit amount can be set using transaction.setParameter(SHADebit.DEBIT_AMOUNT, 50)
, where the value is in units of cents (i.e. for 1 dollar, use 100).
Flow of action:
If previous steps have been executed, all "Read" commands on the user are reading from cached data.
user | SHAiButtonUser upon which the transaction occurs. |
verifySuccess | A boolean to let this method know if verification was successful. |
true
if and only if the user has enough in the account balance to perform the requested debit AND a new digital signature is successfully created AND the account data has been written to the button.Implements SHATransaction.
synchronized int getParameter | ( | int | type | ) | [virtual] |
Retrieves the value of a particular parameter for this debit transaction.
Valid Parameters
Note that the value of SHADebit.USER_BALANCE
will be set after calling verifyTransactionData(SHAiButtonUser)
and after calling executeTransaction(SHAiButtonUser)
.
IllegalArgumentException | if an invalid parameter type is requested. |
Implements SHATransaction.
synchronized int getParameter | ( | int | type, |
byte[] | data, | ||
int | offset, | ||
int | len | ||
) |
Retrieves the value of a particular parameter for this debit transaction.
Valid Parameters
Note that the value of SHADebit.USER_BALANCE
will be set after calling verifyTransactionData(SHAiButtonUser)
and after calling executeTransaction(SHAiButtonUser)
.
IllegalArgumentException | if an invalid parameter type is requested. |
synchronized void resetParameters | ( | ) | [virtual] |
Resets all transaction parameters to default values
Implements SHATransaction.
synchronized boolean setParameter | ( | int | type, |
int | param | ||
) | [virtual] |
Sets the value of a particular parameter for this debit transaction.
Valid Parameters
type | Specifies the parameter type (SHADebit.DEBIT_AMOUNT or SHADebit.INITIAL_AMOUNT ) |
IllegalArgumentException | if an invalid parameter type is requested. |
Implements SHATransaction.
synchronized boolean setParameter | ( | int | type, |
byte[] | data, | ||
int | offset, | ||
int | len | ||
) |
Sets the value of a particular parameter for this debit transaction.
Valid Parameters
type | Specifies the parameter type (SHADebit.DEBIT_AMOUNT or SHADebit.INITIAL_AMOUNT ) |
IllegalArgumentException | if an invalid parameter type is requested. |
boolean setupTransactionData | ( | SHAiButtonUser | user | ) | throws OneWireException, OneWireIOException [virtual] |
Setup account data on a fresh user iButton. Prior to calling setup transaction data, the authentication secret for the iButton should already be setup and a directory entry (as well as at least an empty placeholder file) should exist for the account data. If you constructed the SHAiButtonUser using SHAiButtonUser(SHAiButtonCopr,OneWireContainer18,boolean,byte[])
the secret has been setup for you and you should know call this function. If you try to install the authentication secret after creating the account data, you will destroy all account data on the iButton.
You can set the value of the intial account balance by calling transaction.setParameter(SHADebit.INITIAL_AMOUNT,10000)
where the value of the units is in cents (i.e. 10000 = $100).
Flow of action:
user | SHAiButtonUser upon which the transaction occurs. |
true
if and only if the signature is successfully created by the coprocessor AND the data is successfully written to the user iButton.Implements SHATransaction.
synchronized boolean verifyTransactionData | ( | SHAiButtonUser | user | ) | throws OneWireException, OneWireIOException [virtual] |
Verifies user's account data. Account data is "verified" if the digital signature matches the signature recreated by the coprocessor.
Flow of action:
If previous steps have been executed, all "Read" commands on the user are reading from cached data.
user | SHAiButtonUser upon which the transaction occurs. |
true
if and only if the account balance is greater than zero and digital signature matches the signature recreated by the coprocessor.Implements SHATransaction.
synchronized boolean verifyUser | ( | SHAiButtonUser | user | ) | throws OneWireException, OneWireIOException [virtual] |
Verifies user's authentication response. User is "authenticated" if and only if the digital signature generated the user iButton matches the digital signature generated by the coprocessor after the user's unique secret has been recreated on the coprocessor.
Flow of action:
user | SHAiButtonUser upon which the transaction occurs. |
Implements SHATransaction.