org.mozilla.jss.util
Interface PasswordCallback
- All Known Implementing Classes:
- ConsolePasswordCallback, NullPasswordCallback, Password
- public interface PasswordCallback
Represents a password callback, which is called to login to the key
database and to PKCS #11 tokens.
The simplest implementation of a PasswordCallback is a Password object.
- See Also:
Password
,
NullPasswordCallback
,
ConsolePasswordCallback
,
CryptoManager.setPasswordCallback(org.mozilla.jss.util.PasswordCallback)
getPasswordFirstAttempt
public Password getPasswordFirstAttempt(PasswordCallbackInfo info)
throws PasswordCallback.GiveUpException
- Supplies a password. This is called on the first attempt; if it
returns the wrong password,
getPasswordAgain
will
be called on subsequent attempts.
- Parameters:
info
- Information about the token that is being logged into.- Returns:
- The password. This password object is owned by and will
be cleared by the caller.
- Throws:
PasswordCallback.GiveUpException
- If the callback does not want to supply
a password.
getPasswordAgain
public Password getPasswordAgain(PasswordCallbackInfo info)
throws PasswordCallback.GiveUpException
- Tries supplying a password again. This callback will be called if
the first callback returned an invalid password. It will be called
repeatedly until it returns a correct password, or it gives up by
throwing a
GiveUpException
.
- Parameters:
info
- Information about the token that is being logged into.- Throws:
PasswordCallback.GiveUpException
- If the callback does not want to supply
a password. This may often be the case if the first attempt failed.