iaik.security.pq.mldsa

Class MLDSAKeyFactory

java.lang.Object

java.security.KeyFactorySpi

iaik.security.pq.mldsa.MLDSAKeyFactory

public class MLDSAKeyFactory
extends KeyFactorySpi

Implementation of the Key Factory Service Provider for ML-DSA.

See Also:

KeyFactorySpi

Constructor Summary

Constructors

Constructor and Description
MLDSAKeyFactory()

Method Summary

Modifier and Type	Method and Description
protected PrivateKey	engineGeneratePrivate(KeySpec keySpec) Generates a private key from the given key spec.
protected PublicKey	engineGeneratePublic(KeySpec keySpec) Generates a public key from the given key spec.
protected <T extends KeySpec> T	engineGetKeySpec(Key key, Class<T> keySpec) Implementation of the engine method.
protected Key	engineTranslateKey(Key key) Translates the given key object of some unknown or untrusted provider into a key object supported by this ML-DSA key factory.
static MLDSAPrivateKey	translatePrivateKey(PrivateKey key) Translation routine for ML-DSA private keys.
static MLDSAPublicKey	translatePublicKey(PublicKey key) Translation routine for ML-DSA public keys.

Methods inherited from class java.lang.Object

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

Constructor Detail

MLDSAKeyFactory

public MLDSAKeyFactory()

Method Detail

translatePublicKey

public static MLDSAPublicKey translatePublicKey(PublicKey key)
                                         throws InvalidKeyException

Translation routine for ML-DSA public keys.

Parameters:

key - the private key to be translated

Returns:

the private key in its internal representation

Throws:

InvalidKeyException - if the key could not be translated

translatePrivateKey

public static MLDSAPrivateKey translatePrivateKey(PrivateKey key)
                                           throws InvalidKeyException

Translation routine for ML-DSA private keys.

Parameters:

key - the private key to be translated

Returns:

the private key in its internal representation

Throws:

InvalidKeyException - if the key could not be translated

engineGeneratePublic

protected PublicKey engineGeneratePublic(KeySpec keySpec)
                                  throws InvalidKeySpecException

Generates a public key from the given key spec.

Specified by:

engineGeneratePublic in class KeyFactorySpi

Parameters:

keySpec - the key material; it may either be MLDSAPublicKeySpec or X509EncodedKeySpec

Throws:

InvalidKeySpecException - if the key spec is not supported or erroneous

engineGeneratePrivate

protected PrivateKey engineGeneratePrivate(KeySpec keySpec)
                                    throws InvalidKeySpecException

Generates a private key from the given key spec.

Specified by:

engineGeneratePrivate in class KeyFactorySpi

Parameters:

keySpec - the key material; it may either be MLDSAPrivateKeySpec or PKCS8EncodedKeySpec

Throws:

InvalidKeySpecException - if the key spec is not supported or erroneous

engineGetKeySpec

protected <T extends KeySpec> T engineGetKeySpec(Key key,
                                                 Class<T> keySpec)
                                          throws InvalidKeySpecException

Implementation of the engine method. Converts a key into its spec.

Specified by:

engineGetKeySpec in class KeyFactorySpi

Parameters:

key - the key to be converted (either MLDSAPrivateKey or MLDSAPublicKey)

keySpec - the key specification type. If the given key is of type MLDSAPrivateKey the keySpec may be MLDSAPrivateKeySpec or PKCS8EncodedKeySpec. Otherwise (key is of type MLDSAPublicKey) the keySpec must be MLDSAPublicKeySpec or X509EncodedKeySpec

Returns:

the corresponding key spec

Throws:

InvalidKeySpecException - if the key cannot be transformed into the provided keySpec.

engineTranslateKey

protected Key engineTranslateKey(Key key)
                          throws InvalidKeyException

Translates the given key object of some unknown or untrusted provider into a key object supported by this ML-DSA key factory. This method can only translate keys of type MLDSAPrivateKey or MLDSAPublicKey.

Specified by:

engineTranslateKey in class KeyFactorySpi

Parameters:

key - the key to be translated

Returns:

the translated key

Throws:

InvalidKeyException - if the given key cannot be translated