Package 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:
-
Nested Class Summary
Nested ClassesModifier and TypeInterfaceDescriptionstatic class
This exception is thrown if thePasswordCallback
wants to stop guessing passwords. -
Method Summary
Modifier and TypeMethodDescriptionTries supplying a password again.Supplies a password.
-
Method Details
-
getPasswordFirstAttempt
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
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 aGiveUpException
.- 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. This may often be the case if the first attempt failed.
-