Package at.favre.lib.hkdf

Class HkdfMacFactory.Default

java.lang.Object

at.favre.lib.hkdf.HkdfMacFactory.Default

All Implemented Interfaces:

HkdfMacFactory

Enclosing interface:

HkdfMacFactory

public static final class HkdfMacFactory.Default
extends Object
implements HkdfMacFactory

Default implementation

Nested Class Summary

Nested classes/interfaces inherited from interface at.favre.lib.hkdf.HkdfMacFactory

HkdfMacFactory.Default

Constructor Summary

Constructors

Constructor	Description
Default(String macAlgorithmName)	Creates a mac factory
Default(String macAlgorithmName, Provider provider)	Creates a mac factory

Method Summary

Modifier and Type	Method	Description
Mac	createInstance(SecretKey key)	Creates a new instance of Hmac with given key, i.e.
SecretKey	createSecretKey(byte[] rawKeyMaterial)	Creates a secret key from a byte raw key material to be used with HkdfMacFactory.createInstance(SecretKey)
int	getMacLengthBytes()	Get the length of the mac output in bytes
static HkdfMacFactory	hmacSha1()	Deprecated. sha1 with HMAC should be fine, but not recommended for new protocols; see https://crypto.stackexchange.com/questions/26510/why-is-hmac-sha1-still-considered-secure
static HkdfMacFactory	hmacSha256()	Creates a factory creating HMAC with SHA-256
static HkdfMacFactory	hmacSha512()	Creates a factory creating HMAC with SHA-512

Methods inherited from class java.lang.Object

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

Constructor Detail

Default

public Default(String macAlgorithmName)

Creates a mac factory

Parameters:

macAlgorithmName - as used by Mac.getInstance(String)

Default

public Default(String macAlgorithmName,
               Provider provider)

Creates a mac factory

Parameters:

macAlgorithmName - as used by Mac.getInstance(String)

provider - the security provider, see Mac.getInstance(String, Provider); may be null to use default

Method Detail

hmacSha256

public static HkdfMacFactory hmacSha256()

Creates a factory creating HMAC with SHA-256

Returns:

factory

hmacSha512

public static HkdfMacFactory hmacSha512()

Creates a factory creating HMAC with SHA-512

Returns:

factory

hmacSha1

@Deprecated
public static HkdfMacFactory hmacSha1()

Deprecated.

sha1 with HMAC should be fine, but not recommended for new protocols; see https://crypto.stackexchange.com/questions/26510/why-is-hmac-sha1-still-considered-secure

Creates a factory creating HMAC with SHA-1

Returns:

factory

createInstance

public Mac createInstance(SecretKey key)

Description copied from interface: HkdfMacFactory

Creates a new instance of Hmac with given key, i.e. it must already be initialized with Mac.init(Key).

Specified by:

createInstance in interface HkdfMacFactory

Parameters:

key - the key used, must not be null

Returns:

a new mac instance

getMacLengthBytes

public int getMacLengthBytes()

Description copied from interface: HkdfMacFactory

Get the length of the mac output in bytes

Specified by:

getMacLengthBytes in interface HkdfMacFactory

Returns:

the length of mac output in bytes

createSecretKey

public SecretKey createSecretKey(byte[] rawKeyMaterial)

Description copied from interface: HkdfMacFactory

Creates a secret key from a byte raw key material to be used with HkdfMacFactory.createInstance(SecretKey)

Specified by:

createSecretKey in interface HkdfMacFactory

Parameters:

rawKeyMaterial - the raw key

Returns:

wrapped as secret key instance or null if input is null or empty