iaik.security.ec.common

Class X25519KeyPairGenerator

java.lang.Object

java.security.KeyPairGeneratorSpi

java.security.KeyPairGenerator

iaik.security.ec.common.X25519KeyPairGenerator

public final class X25519KeyPairGenerator
extends KeyPairGenerator

This class serves as key pair generator for X25519. The key pair generator is explained in [1].

References:

[1] A. Langley, M. Hamburg. RFC 7748: Elliptic Curves for Security. https://tools.ietf.org/html/rfc7748

Author:

Sebastian Ramacher

See Also:

EdKey, EdPublicKey, EdPublicKeySpec, EdPrivateKey, EdPrivateKeySpec

Constructor Summary

Constructors

Constructor and Description
X25519KeyPairGenerator() Default constructor.

Method Summary

Modifier and Type	Method and Description
KeyPair	generateKeyPair()
void	initialize(AlgorithmParameterSpec params) Initializes the key pair generator with the given curve domain parameters.
void	initialize(AlgorithmParameterSpec params, SecureRandom random) Initializes the key pair generator with the given curve domain parameters and the specified SecureRandom.
void	initialize(int keySize) Initializes the key pair generator with curve domain parameters matching the given key size.
void	initialize(int keySize, SecureRandom random) Initializes the key pair generator with curve domain parameters matching the given key size and the specified SecureRandom.

Methods inherited from class java.security.KeyPairGenerator

genKeyPair, getAlgorithm, getInstance, getInstance, getInstance, getProvider

Methods inherited from class java.lang.Object

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

Constructor Detail

X25519KeyPairGenerator

public X25519KeyPairGenerator()

Default constructor.

Method Detail

initialize

public void initialize(int keySize)

Initializes the key pair generator with curve domain parameters matching the given key size. It automatically selects an appropriate NIST SP800-90 PRNG to generate the key pair.

Overrides:

initialize in class KeyPairGenerator

Parameters:

keySize - the size of the curve domain parameters

initialize

public void initialize(int keySize,
                       SecureRandom random)

Initializes the key pair generator with curve domain parameters matching the given key size and the specified SecureRandom. Note that [1] requires the SecureRandom object to be a NIST SP800-90 PRNG. If the user specifies another type of PRNG, an exception will be thrown.

Overrides:

initialize in class KeyPairGenerator

Parameters:

keySize - the size of the curve domain parameters

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

initialize

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

Initializes the key pair generator with the given curve domain parameters and the specified SecureRandom.

Overrides:

initialize in class KeyPairGenerator

Parameters:

params - the curve domain parameters

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

Throws:

InvalidAlgorithmParameterException

initialize

public void initialize(AlgorithmParameterSpec params)
                throws InvalidAlgorithmParameterException

Initializes the key pair generator with the given curve domain parameters. It automatically selects an appropriate NIST SP800-90 PRNG to generate the key pair.

Overrides:

initialize in class KeyPairGenerator

Parameters:

params - the curve domain parameters

Throws:

InvalidAlgorithmParameterException

generateKeyPair

public KeyPair generateKeyPair()

Overrides:

generateKeyPair in class KeyPairGenerator