at.favre.lib.crypto.bkdf

Class PasswordHasher.Default

java.lang.Object

at.favre.lib.crypto.bkdf.PasswordHasher.Default

All Implemented Interfaces:

PasswordHasher

Enclosing interface:

PasswordHasher

public static final class PasswordHasher.Default
extends Object
implements PasswordHasher

Default implementation

Nested Class Summary

Nested classes/interfaces inherited from interface at.favre.lib.crypto.bkdf.PasswordHasher

PasswordHasher.Default

Method Summary

Modifier and Type	Method and Description
Version	getHashVersion() Get the in this instance used hash version.
String	hash(char[] password, int costFactor) For given password and cost-factor create password hash.
HashData	hashRaw(char[] password, int costFactor) For given password and cost-factor create password hash.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

hash

public String hash(char[] password,
                   int costFactor)

Description copied from interface: PasswordHasher

For given password and cost-factor create password hash.

The internal salt will be created automatically with a secure CPRNG. Usually implementations support passing your own implementation of a CPRNG (i.e. SecureRandom).

Specified by:

hash in interface PasswordHasher

Parameters:

password - from user

costFactor - exponential cost (log2 factor) between 4 and 31 e.g. 12 --> 2^12 = 4,096 iterations (higher == slower == more secure)

Returns:

"BKDF Password Hash Message Format 2" ie. Base64 encoded password hash for storage

hashRaw

public HashData hashRaw(char[] password,
                        int costFactor)

Description copied from interface: PasswordHasher

For given password and cost-factor create password hash. This method will return a more flexible model to be used to either access all the parts of the format or create different message formats from it.

Specified by:

hashRaw in interface PasswordHasher

Parameters:

password - from user

costFactor - exponential cost (log2 factor) between 4 and 31 e.g. 12 --> 2^12 = 4,096 iterations (higher == slower == more secure)

Returns:

password hash in flexible HashData model

getHashVersion

public Version getHashVersion()

Description copied from interface: PasswordHasher

Get the in this instance used hash version. See Version.

Specified by:

getHashVersion in interface PasswordHasher

Returns:

hash version