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, PasswordHasher.HashData

Method Summary

Modifier and Type	Method and Description
String	hash(char[] password, int costFactor) For given password and cost-factor create password hash.
PasswordHasher.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 PasswordHasher.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 PasswordHasher.HashData model