|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
@TransactionType(value=NOT_SUPPORTED) @SensitiveType(sensitivity=FULL) public interface Password
This interface represents a Password. An implementation must maintain these internal values:
Password
becomes blocked.
An owner implementation of this interface must provide a way to initialize/update the Password value. The owner implementation of the interface must protect against attacks based on program flow prediction. In addition, even if a transaction is in progress, update of internal state such as the try counter, the validated flag, and the blocking state, shall not participate in the transaction during Password presentation.
A typical password usage will combine an instance of
OwnerBioTemplate
returned by
BioBuilder
for the type
PASSWORD
and a Proxy Password
interface (such as SharedPasswordAuth
) which extends both
the Password
and the Shareable
interfaces and
re-declares the methods of the Password
interface.
The OwnerBioTemplate
instance would be manipulated only by the
owner who has update privilege. All others would access the password
functionality via the proxy password interface.
OwnerBioTemplate
,
BioBuilder
,
BioBuilder.PASSWORD
,
SharedPasswordAuth
,
Shareable
Method Summary | |
---|---|
boolean |
check(String password)
Compares password against the Password value. |
byte |
getTriesRemaining()
Returns the number of times remaining that an incorrect password can be presented before the Password is blocked. |
boolean |
isValidated()
Returns true if a valid password value has been presented since
the last card reset or last call to reset() . |
void |
reset()
If the validated flag is set, this method resets the validated flag and resets the Password try counter to the value of the
Password try limit. |
Method Detail |
---|
byte getTriesRemaining()
Password
is blocked.
boolean isValidated()
true
if a valid password value has been presented since
the last card reset or last call to reset()
.
true
if validated; false
otherwisevoid reset()
Password
try counter to the value of the
Password
try limit. If the validated flag is not set, this
method does nothing.
boolean check(String password)
password
against the Password value. If they
match and the Password
is not blocked, it sets the
validated flag and resets the try counter to its maximum. If it does not
match, it decrements the try counter and, if the counter has reached
zero, blocks the Password
. Even if a transaction is in
progress, update of internal state - the try counter, the validated flag,
and the blocking state, shall not participate in the transaction.
Note:
NullPointerException
is
thrown, the validated flag must be set to false, the try counter must be decremented
and, the Password
blocked if the counter reaches zero.
Password
parameter is null
a NullPointerException
exception is thrown.
password
- the String containing the Password value being checked
true
if the Password value matches;
false
otherwise
NullPointerException
- if password
is null
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |