Class KeyPairGeneratorSpi

java.lang.Object

java.security.KeyPairGeneratorSpi

org.bouncycastle.jcajce.provider.asymmetric.compositekem.KeyPairGeneratorSpi

Direct Known Subclasses:

KeyPairGeneratorSpi.MLKEM1024_ECDH_BP384_SHA3_256, KeyPairGeneratorSpi.MLKEM1024_ECDH_P384_SHA3_256, KeyPairGeneratorSpi.MLKEM1024_ECDH_P521_SHA3_256, KeyPairGeneratorSpi.MLKEM1024_RSA3072_SHA3_256, KeyPairGeneratorSpi.MLKEM1024_X448_SHA3_256, KeyPairGeneratorSpi.MLKEM768_ECDH_BP256_SHA3_256, KeyPairGeneratorSpi.MLKEM768_ECDH_P256_SHA3_256, KeyPairGeneratorSpi.MLKEM768_ECDH_P384_SHA3_256, KeyPairGeneratorSpi.MLKEM768_RSA2048_SHA3_256, KeyPairGeneratorSpi.MLKEM768_RSA3072_SHA3_256, KeyPairGeneratorSpi.MLKEM768_RSA4096_SHA3_256, KeyPairGeneratorSpi.MLKEM768_X25519_SHA3_256

public class KeyPairGeneratorSpi
extends KeyPairGeneratorSpi

KeyPairGenerator for Composite ML-KEM (draft-ietf-lamps-pq-composite-kem). The concrete composite is selected by the subclasses at the end of this file. The generated keys are a CompositePublicKey / CompositePrivateKey pair whose components are, in order, the ML-KEM key and the traditional (RSA / ECDH / X25519 / X448) key.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	KeyPairGeneratorSpi.MLKEM1024_ECDH_BP384_SHA3_256
static final class	KeyPairGeneratorSpi.MLKEM1024_ECDH_P384_SHA3_256
static final class	KeyPairGeneratorSpi.MLKEM1024_ECDH_P521_SHA3_256
static final class	KeyPairGeneratorSpi.MLKEM1024_RSA3072_SHA3_256
static final class	KeyPairGeneratorSpi.MLKEM1024_X448_SHA3_256
static final class	KeyPairGeneratorSpi.MLKEM768_ECDH_BP256_SHA3_256
static final class	KeyPairGeneratorSpi.MLKEM768_ECDH_P256_SHA3_256
static final class	KeyPairGeneratorSpi.MLKEM768_ECDH_P384_SHA3_256
static final class	KeyPairGeneratorSpi.MLKEM768_RSA2048_SHA3_256
static final class	KeyPairGeneratorSpi.MLKEM768_RSA3072_SHA3_256
static final class	KeyPairGeneratorSpi.MLKEM768_RSA4096_SHA3_256
static final class	KeyPairGeneratorSpi.MLKEM768_X25519_SHA3_256

Method Summary

Modifier and Type	Method	Description
KeyPair	generateKeyPair()
void	initialize(int keySize, SecureRandom random)	There is no notion of a key size for composite KEMs - the parameter set is fixed by the algorithm.
void	initialize(AlgorithmParameterSpec paramSpec, SecureRandom secureRandom)	A custom AlgorithmParameterSpec is not supported - the composite parameter set is determined by the algorithm name.

Methods inherited from class Object

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

Method Details

initialize

public void initialize(int keySize,
 SecureRandom random)

There is no notion of a key size for composite KEMs - the parameter set is fixed by the algorithm. Use initialize(AlgorithmParameterSpec, SecureRandom) (with a null spec) only to supply a custom SecureRandom.

Specified by:

initialize in class KeyPairGeneratorSpi

initialize

public void initialize(AlgorithmParameterSpec paramSpec,
 SecureRandom secureRandom)
                throws InvalidAlgorithmParameterException

A custom AlgorithmParameterSpec is not supported - the composite parameter set is determined by the algorithm name. This method only serves to set a custom SecureRandom on the component generators.

Overrides:

initialize in class KeyPairGeneratorSpi

Parameters:

paramSpec - must be null.

secureRandom - a SecureRandom used by the component key generators.

Throws:

InvalidAlgorithmParameterException

generateKeyPair

public KeyPair generateKeyPair()

Specified by:

generateKeyPair in class KeyPairGeneratorSpi