iaik.security.pq.dilithium

Class DilithiumKeyPairGeneratorSpi

java.lang.Object

java.security.KeyPairGeneratorSpi

iaik.security.pq.dilithium.DilithiumKeyPairGeneratorSpi

public final class DilithiumKeyPairGeneratorSpi
extends KeyPairGeneratorSpi

This class extends the KeyPairGenerator and serves as an interface for users to create KeyPairs for the Dilithium [0] Algorithm.

[0] Bai, Ducas, Kiltz, Lepoint, Lyubashevsky, Schwabe, Seiler and Stehlé: "CRYSTALS-Dilithium" - 8 February, 2021

Constructor Summary

Constructors

Constructor and Description
DilithiumKeyPairGeneratorSpi()

Method Summary

Modifier and Type	Method and Description
KeyPair	generateKeyPair() Generates a KeyPair consisting of a DilithiumPrivateKey and DilithiumPublicKey depending on the initialization of this object.
void	initialize(AlgorithmParameterSpec algorithmParameterSpec, SecureRandom random) Initializes the key pair generator using the specified parameter set and source of randomness.
void	initialize(int keySize, SecureRandom random) Initializes this KeyPairGenerator with the given key size and PRNG.

Methods inherited from class java.lang.Object

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

Constructor Detail

DilithiumKeyPairGeneratorSpi

public DilithiumKeyPairGeneratorSpi()

Method Detail

initialize

public void initialize(AlgorithmParameterSpec algorithmParameterSpec,
                       SecureRandom random)
                throws InvalidAlgorithmParameterException

Initializes the key pair generator using the specified parameter set and source of randomness. If the parameter set is true, the implementation defaults to DilithiumAlgorithmParameterSpec, Furthermore, if source random is null, the implementation defaults to the SecureRandom implementation of the JCE Provider.

Overrides:

initialize in class KeyPairGeneratorSpi

Parameters:

algorithmParameterSpec -

random -

Throws:

InvalidAlgorithmParameterException

initialize

public void initialize(int keySize,
                       SecureRandom random)

Initializes this KeyPairGenerator with the given key size and PRNG.

Specified by:

initialize in class KeyPairGeneratorSpi

Parameters:

keySize - the key size (in bits), either 10496, 15616 or 20736 corresponding to the NIST security levels 2,3 and 5 respectively

random - the source of randomness, if null, SecureRandom from the JCE Provider is used

Throws:

IllegalArgumentException - if the given key size is not 10496, 15616 or 20736

generateKeyPair

public KeyPair generateKeyPair()

Generates a KeyPair consisting of a DilithiumPrivateKey and DilithiumPublicKey depending on the initialization of this object. If DilithiumKeyPairGeneratorSpi was not initialized, the implementation defaults to DilithiumAlgorithmParameterSpec.

Specified by:

generateKeyPair in class KeyPairGeneratorSpi

Returns:

a KeyPair consisting of a DilithiumPublicKey and a DilithiumPrivateKey.