Package zeroecho.core.alg.ecdsa

Class EcdsaPrivateKeyBuilder

java.lang.Object

zeroecho.core.alg.ecdsa.EcdsaPrivateKeyBuilder

All Implemented Interfaces:

AsymmetricKeyBuilder<EcdsaPrivateKeySpec>

public final class EcdsaPrivateKeyBuilder
extends Object
implements AsymmetricKeyBuilder<EcdsaPrivateKeySpec>

ECDSA Private Key Builder

Implementation of AsymmetricKeyBuilder for EcdsaPrivateKeySpec. This builder is responsible for importing ECDSA private keys from encoded representations.

Supported operations

• importPrivate(EcdsaPrivateKeySpec) - construct a PrivateKey instance from a PKCS#8 encoded key.
• generateKeyPair(EcdsaPrivateKeySpec) - unsupported; use EcdsaKeyGenBuilder instead.
• importPublic(EcdsaPrivateKeySpec) - unsupported; use EcdsaPublicKeySpec with EcdsaPublicKeyBuilder instead.

Encoding

The EcdsaPrivateKeySpec stores the private key in PKCS#8 DER format. This builder delegates to a JCA KeyFactory for the "EC" algorithm to reconstruct a usable PrivateKey.

Usage

Typically accessed indirectly through CryptoAlgorithms.privateKey(String, zeroecho.core.spec.AlgorithmKeySpec) or CryptoAlgorithm.importPrivate(zeroecho.core.spec.AlgorithmKeySpec).

 // Example: Import an ECDSA private key
 byte[] pkcs8 = ...; // load PKCS#8 DER data
 EcdsaPrivateKeySpec spec = new EcdsaPrivateKeySpec(pkcs8);
 PrivateKey priv = new EcdsaPrivateKeyBuilder().importPrivate(spec);
 

Since:

1.0

Constructor Summary

Constructors

Constructor	Description
EcdsaPrivateKeyBuilder()

Method Summary

Modifier and Type	Method	Description
KeyPair	generateKeyPair(EcdsaPrivateKeySpec spec)	Unsupported operation for this builder.
PrivateKey	importPrivate(EcdsaPrivateKeySpec spec)	Imports a private key from a PKCS#8 encoded specification.
PublicKey	importPublic(EcdsaPrivateKeySpec spec)	Unsupported operation for this builder.

Methods inherited from class java.lang.Object

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

Constructor Details

EcdsaPrivateKeyBuilder

public EcdsaPrivateKeyBuilder()

Method Details

generateKeyPair

public KeyPair generateKeyPair(EcdsaPrivateKeySpec spec)

Unsupported operation for this builder.

ECDSA key pair generation should be performed using EcdsaKeyGenBuilder, not from a private key specification.

Specified by:

generateKeyPair in interface AsymmetricKeyBuilder<EcdsaPrivateKeySpec>

Parameters:

spec - unused private key specification

Returns:

never returns normally

Throws:

UnsupportedOperationException - always thrown

importPublic

public PublicKey importPublic(EcdsaPrivateKeySpec spec)

Unsupported operation for this builder.

Public key import should be performed using EcdsaPublicKeySpec with EcdsaPublicKeyBuilder.

Specified by:

importPublic in interface AsymmetricKeyBuilder<EcdsaPrivateKeySpec>

Parameters:

spec - unused private key specification

Returns:

never returns normally

Throws:

UnsupportedOperationException - always thrown

importPrivate

public PrivateKey importPrivate(EcdsaPrivateKeySpec spec)
                         throws GeneralSecurityException

Imports a private key from a PKCS#8 encoded specification.

Uses a JCA KeyFactory instance for "EC" to parse the given EcdsaPrivateKeySpec and construct a PrivateKey.

Specified by:

importPrivate in interface AsymmetricKeyBuilder<EcdsaPrivateKeySpec>

Parameters:

spec - private key specification containing PKCS#8 DER encoding

Returns:

reconstructed PrivateKey instance

Throws:

GeneralSecurityException - if the encoding is invalid or the key cannot be reconstructed