iaik.security.ec.common

Class ECKeyPairGenerator

java.lang.Object

java.security.KeyPairGeneratorSpi

java.security.KeyPairGenerator

iaik.security.ec.common.ECKeyPairGenerator

public final class ECKeyPairGenerator
extends KeyPairGenerator

This class serves as EC key pair generator and is implemented according to [1]. It can be used to generate keys of a minimum length of 160 bits. The default key size is 256 bits.

References:

[1] FIPS PUB 186-4 FEDERAL INFORMATION PROCESSING STANDARDS PUBLICATION Digital Signature Standard (DSS),Patrick Gallagher and Deputy Director Foreword and Cita Furlani Director, 2013

[2] Elaine Barker, William Barker, William Burr, William Polk, and Miles Smid, Recommendation for Key Management - Part 1: General, NIST special publication (SP 800-57); http://csrc.nist.gov/publications/nistpubs /800-57/sp800-57-Part1-revised2_Mar08-2007.pdf.

[3] ANSI X9.62-2005, "American National Standard for Financial Services - The Elliptic Curve Digital Signature Algorithm (ECDSA)" , ASC X9, November 2005.

Author:

Christian Hanser, Sebastian Ramacher

See Also:

ECKey, ECPublicKey, ECPublicKeySpec, ECPrivateKey, ECPrivateKeySpec

Constructor Summary

Constructors

Constructor and Description
ECKeyPairGenerator() 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

ECKeyPairGenerator

public ECKeyPairGenerator()

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. 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:

params - the curve domain parameters

random - the NIST SP800-90 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