Package org.mozilla.jss.util
Class Password
java.lang.Object
org.mozilla.jss.util.Password
- All Implemented Interfaces:
Serializable
,Cloneable
,PasswordCallback
Stores a password.
clear
should be
called when the password is no longer needed so that the sensitive
information is not left in memory.
A Password
can be used as a hard-coded
PasswordCallback
.
- See Also:
-
Nested Class Summary
Nested classes/interfaces inherited from interface org.mozilla.jss.util.PasswordCallback
PasswordCallback.GiveUpException
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate boolean
static org.slf4j.Logger
private char[]
private static final long
private StackTraceElement[]
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic byte[]
charToByte
(char[] charArray) Converts a char array to a null-terminated byte array using a standard encoding, which is currently UTF8.void
clear()
Clears the password so that sensitive data is no longer present in memory.clone()
Clones the password.boolean
Compares this password to another and returns true if they are the same.protected void
finalize()
Deprecated.finalize() in Object has been deprecated(package private) byte[]
Returns a null-terminated byte array that is the byte-encoding of this password.char[]
Returns a char array that is a copy of the password.char[]
getChars()
Returns the char array underlying this password.An implementation ofPasswordCallback.getPasswordAgain
.An implementation ofPasswordCallback.getPasswordFirstAttempt
.int
hashCode()
static Password
Reads a password from the console with echo disabled.static void
wipeBytes
(byte[] byteArray) Wipes a byte array by setting all its elements to zero.static void
wipeChars
(char[] charArray) Wipes a char array by setting all its elements to zero.
-
Field Details
-
serialVersionUID
private static final long serialVersionUID- See Also:
-
logger
public static org.slf4j.Logger logger -
stackTrace
-
password
private char[] password -
cleared
private boolean cleared
-
-
Constructor Details
-
Password
private Password()Don't use this if you aren't Password. -
Password
public Password(char[] pw) Creates a Password from a char array, then wipes the char array.- Parameters:
pw
- A char[] containing the password. This array will be cleared (set to zeroes) by the constructor.
-
-
Method Details
-
getPasswordFirstAttempt
public Password getPasswordFirstAttempt(PasswordCallbackInfo info) throws PasswordCallback.GiveUpException An implementation ofPasswordCallback.getPasswordFirstAttempt
. This allows aPassword
object to be treated as aPasswordCallback
. This method simply returns a clone of the password.- Specified by:
getPasswordFirstAttempt
in interfacePasswordCallback
- Parameters:
info
- Information about the token that is being logged into.- Returns:
- A copy of the password. The caller is responsible for clearing this copy.
- Throws:
PasswordCallback.GiveUpException
- If the callback does not want to supply a password.
-
equals
Compares this password to another and returns true if they are the same. -
hashCode
public int hashCode() -
getPasswordAgain
An implementation ofPasswordCallback.getPasswordAgain
. This allows aPassword
object to be used as aPasswordCallback
. This method is only called after a call togetPasswordFirstAttempt
returned the wrong password. This means the password is incorrect and there's no sense returning it again, so aGiveUpException
is thrown.- Specified by:
getPasswordAgain
in interfacePasswordCallback
- 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.
-
getChars
public char[] getChars()Returns the char array underlying this password. It must not be modified in any way. -
getCharCopy
public char[] getCharCopy()Returns a char array that is a copy of the password. The caller is responsible for wiping the returned array, for example usingwipeChars
. -
getByteCopy
byte[] getByteCopy()Returns a null-terminated byte array that is the byte-encoding of this password. The returned array is a copy of the password. The caller is responsible for wiping the returned array, for example usingwipeChars
. -
clear
public void clear()Clears the password so that sensitive data is no longer present in memory. This should be called as soon as the password is no longer needed. -
clone
Clones the password. The resulting clone will be completely independent of the parent, which means it will have to be separately cleared. -
finalize
Deprecated.finalize() in Object has been deprecatedThe finalizer clears the sensitive information before releasing it to the garbage collector, but it should have been cleared manually before this point anyway. -
charToByte
public static byte[] charToByte(char[] charArray) Converts a char array to a null-terminated byte array using a standard encoding, which is currently UTF8. The caller is responsible for clearing the copy (withwipeBytes
, for example).- Parameters:
charArray
- A character array, which should not be null. It will be wiped with zeroes.- Returns:
- A copy of the charArray, converted from Unicode to UTF8. It
is the responsibility of the caller to clear the output byte array;
wipeBytes
is ideal for this purpose. - See Also:
-
wipeBytes
public static void wipeBytes(byte[] byteArray) Wipes a byte array by setting all its elements to zero.null
must not be passed in. -
wipeChars
public static void wipeChars(char[] charArray) Wipes a char array by setting all its elements to zero.null
must not be passed in. -
readPasswordFromConsole
Reads a password from the console with echo disabled. This is a blocking call which will return after the user types a newline. It only works with ASCII password characters. The call is synchronized because it alters terminal settings in a way that is not thread-safe.- Returns:
- The password the user entered at the command line.
- Throws:
PasswordCallback.GiveUpException
- If the user enters no password (just hits<enter>
).
-