at.favre.lib.crypto.bcrypt

Class BCrypt

java.lang.Object

at.favre.lib.crypto.bcrypt.BCrypt

public final class BCrypt
extends Object

The main access point the the Bcrypt APIs

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	BCrypt.HashData Holds the raw data of a bcrypt hash
static class	BCrypt.Hasher Can create bcrypt hashes
static class	BCrypt.Result Result of a bcrypt hash verification
static class	BCrypt.Verifyer Can verify bcrypt hashes
static class	BCrypt.Version The supported version identifiers for bcrypt according to the modular crypt format.

Field Summary

Fields

Modifier and Type	Field and Description
static int	MAX_COST Maximum allowed cost factor
static int	MAX_PW_LENGTH_BYTE The max length of the password in bytes excluding lats null-terminator byte
static int	MIN_COST Minimum allowed cost factor
static int	SALT_LENGTH Fixed lenght of the bcrypt salt

Method Summary

Modifier and Type	Method and Description
static BCrypt.Verifyer	verifyer() Creates a new instance of bcrypt verifier to verify a password against a given hash
static BCrypt.Hasher	with(BCrypt.Version version) Create a new instance of bcrypt hash with given BCrypt.Version.
static BCrypt.Hasher	with(BCrypt.Version version, SecureRandom secureRandom, LongPasswordStrategy longPasswordStrategy) Create a new instance with custom version, secureRandom and long password strategy
static BCrypt.Hasher	with(LongPasswordStrategy longPasswordStrategy) Create a new instance of bcrypt hash with default version BCrypt.Version.VERSION_2A.
static BCrypt.Hasher	with(SecureRandom secureRandom) Create a new instance of bcrypt hash with default version BCrypt.Version.VERSION_2A.
static BCrypt.Hasher	withDefaults() Create a new instance of bcrypt hash with default version BCrypt.Version.VERSION_2A.

Methods inherited from class java.lang.Object

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

Field Detail

SALT_LENGTH

public static final int SALT_LENGTH

Fixed lenght of the bcrypt salt

See Also:

Constant Field Values

MAX_PW_LENGTH_BYTE

public static final int MAX_PW_LENGTH_BYTE

The max length of the password in bytes excluding lats null-terminator byte

See Also:

Constant Field Values

MIN_COST

public static final int MIN_COST

Minimum allowed cost factor

See Also:

Constant Field Values

MAX_COST

public static final int MAX_COST

Maximum allowed cost factor

See Also:

Constant Field Values

Method Detail

withDefaults

public static BCrypt.Hasher withDefaults()

Create a new instance of bcrypt hash with default version BCrypt.Version.VERSION_2A. Will throw an exception if given password is longer than the max length support for bycrpt of MAX_PW_LENGTH_BYTE.

Returns:

new bcrypt hash instance

with

public static BCrypt.Hasher with(BCrypt.Version version)

Create a new instance of bcrypt hash with given BCrypt.Version. Will throw an exception if given password is longer than the max length support for bycrpt of MAX_PW_LENGTH_BYTE.

Parameters:

version - defines what version of bcrypt will be generated (mostly the version identifier changes)

Returns:

new bcrypt hash instance

with

public static BCrypt.Hasher with(SecureRandom secureRandom)

Create a new instance of bcrypt hash with default version BCrypt.Version.VERSION_2A. The passed SecureRandom is used for generating the random salt. Will throw an exception if given password is longer than the max length support for bycrpt of MAX_PW_LENGTH_BYTE.

Parameters:

secureRandom - to use for random salt generation

Returns:

new bcrypt hash instance

with

public static BCrypt.Hasher with(LongPasswordStrategy longPasswordStrategy)

Create a new instance of bcrypt hash with default version BCrypt.Version.VERSION_2A. The passed LongPasswordStrategy will decide what to do when the password is longer than the supported MAX_PW_LENGTH_BYTE

Parameters:

longPasswordStrategy - decides what to do on pw that are too long

Returns:

new bcrypt hash instance

with

public static BCrypt.Hasher with(BCrypt.Version version,
                                 SecureRandom secureRandom,
                                 LongPasswordStrategy longPasswordStrategy)

Create a new instance with custom version, secureRandom and long password strategy

Parameters:

version - defines what version of bcrypt will be generated (mostly the version identifier changes)

secureRandom - to use for random salt generation

longPasswordStrategy - decides what to do on pw that are too long

Returns:

new bcrypt hash instance

verifyer

public static BCrypt.Verifyer verifyer()

Creates a new instance of bcrypt verifier to verify a password against a given hash

Returns:

new verifier instance