iaik.security.pq.mldsa

Class MLDSAKeyPairGeneratorSpi

java.lang.Object

java.security.KeyPairGeneratorSpi

iaik.security.pq.mldsa.MLDSAKeyPairGeneratorSpi

public final class MLDSAKeyPairGeneratorSpi
extends KeyPairGeneratorSpi

This class extends the KeyPairGeneratorSpi and serves as an interface for users to create KeyPairs for the ML-DSA [0] Algorithm.

References: [0] FIPS 204

Constructor Summary

Constructors

Constructor and Description
MLDSAKeyPairGeneratorSpi()

Method Summary

Modifier and Type	Method and Description
KeyPair	generateKeyPair() Generates a KeyPair consisting of a MLDSAPrivateKey and MLDSAPublicKey depending on the initialization of this object.
void	initialize(AlgorithmParameterSpec algorithmParameterSpec, SecureRandom random) Initializes the key pair generator using the specified parameters and the specified SecureRandom instance.
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

MLDSAKeyPairGeneratorSpi

public MLDSAKeyPairGeneratorSpi()

Method Detail

initialize

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

Initializes the key pair generator using the specified parameters and the specified SecureRandom instance.

Overrides:

initialize in class KeyPairGeneratorSpi

Parameters:

algorithmParameterSpec - has to be of type MLDSAAlgorithmParameterSpec

random - the NIST SP800-90 PRNG; if null an appropriate NIST * SP800-90 PRNG will be selected automatically

Throws:

InvalidAlgorithmParameterException - thrown when the AlgorithmParameterSpec is not an instance of MLDSAAlgorithmParameterSpec

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 NIST SP800-90 PRNG; if null an appropriate NIST SP800-90 PRNG will be selected automatically

Throws:

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

See Also:

for more information obout the security levels defined by NIST

generateKeyPair

public KeyPair generateKeyPair()

Generates a KeyPair consisting of a MLDSAPrivateKey and MLDSAPublicKey depending on the initialization of this object.

Specified by:

generateKeyPair in class KeyPairGeneratorSpi

Returns:

a KeyPair consisting of a MLDSAPublicKey and a MLDSAPrivateKey.