iaik.security.lw.ascon

Class AsconKeyGenerator

java.lang.Object

javax.crypto.KeyGeneratorSpi

iaik.security.lw.ascon.AsconKeyGenerator

Direct Known Subclasses:

AsconKeyGenerator.Ascon128KeyGenerator, AsconKeyGenerator.Ascon80pqKeyGenerator

public class AsconKeyGenerator
extends KeyGeneratorSpi

KeyGenerator base class for generating keys to be used by the Ascon cipher and Ascon Mac. The key size is 128 bits for Ascon-128, Ascon-128a, Ascon-Mac, Ascon-Maca, Ascon-Prf, Ascon-Prfa, and Ascon-PrfShort. The key size is 160 bits for Ascon-80pq.

An application uses

 KeyGenerator keyGen = KeyGenerator.getInstance("Ascon-128", "IAIK");
 

for creating a KeyGenerator object for the Ascon algorithm. For actually generating the requested secret key from the KeyGenerator object just created, an application calls the generateKey method after having initialized the generator with some random seed or relying on the default system-provided source of randomness:

 SecretKey key = keyGen.generateKey();
 

See Also:

KeyGenerator, KeyGeneratorSpi, SecretKey

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AsconKeyGenerator.Ascon128KeyGenerator Ascon KeyGenerator for generating 128 bit keys.
static class	AsconKeyGenerator.Ascon80pqKeyGenerator Ascon KeyGenerator for generating 160 bit keys.

Constructor Summary

Constructors

Constructor and Description
AsconKeyGenerator() Default Constructor for creating an AsconKeyGenerator object.

Method Summary

Modifier and Type	Method and Description
protected SecretKey	engineGenerateKey() Actually generates a secret key from this KeyGenerator object.
protected void	engineInit(AlgorithmParameterSpec algorithmParameterSpec, SecureRandom secureRandom) Initializes this key generator with given algorithm parameters and random seed.
protected void	engineInit(int keysize, SecureRandom secureRandom) Initializes this key generator with the given keysize and the given random seed
protected void	engineInit(SecureRandom secureRandom) Initializes the key generator with the given random seed.

Methods inherited from class java.lang.Object

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

Constructor Detail

AsconKeyGenerator

public AsconKeyGenerator()

Default Constructor for creating an AsconKeyGenerator object.

Method Detail

engineInit

protected void engineInit(SecureRandom secureRandom)

Initializes the key generator with the given random seed.

Specified by:

engineInit in class KeyGeneratorSpi

Parameters:

secureRandom - the random seed

See Also:

KeyGenerator.init(java.security.SecureRandom)

engineInit

protected void engineInit(AlgorithmParameterSpec algorithmParameterSpec,
                          SecureRandom secureRandom)

Initializes this key generator with given algorithm parameters and random seed.

Specified by:

engineInit in class KeyGeneratorSpi

Parameters:

algorithmParameterSpec - the algorithm parameters

secureRandom - the random seed

See Also:

KeyGenerator.init(java.security.SecureRandom)

engineInit

protected void engineInit(int keysize,
                          SecureRandom secureRandom)

Initializes this key generator with the given keysize and the given random seed

Specified by:

engineInit in class KeyGeneratorSpi

Parameters:

keysize - the size of the key to be created

secureRandom - the random seed

See Also:

KeyGenerator.init(java.security.SecureRandom)

engineGenerateKey

protected SecretKey engineGenerateKey()

Actually generates a secret key from this KeyGenerator object.

Specified by:

engineGenerateKey in class KeyGeneratorSpi

Returns:

the generated secret key

See Also:

KeyGenerator.generateKey()