com.safenetinc.luna.provider.keyfactory

Class LunaKeyFactory

java.lang.Object

java.security.KeyFactorySpi

com.safenetinc.luna.provider.keyfactory.LunaKeyFactory

Direct Known Subclasses:

LunaKeyFactoryDH, LunaKeyFactoryDsa, LunaKeyFactoryEC, LunaKeyFactoryRsa

public abstract class LunaKeyFactory
extends KeyFactorySpi

Abstract base class for the Luna key factories.

Constructor Summary

Constructors

Constructor and Description
LunaKeyFactory()

Method Summary

Modifier and Type	Method and Description
protected abstract Key	createLunaKey(PublicKey key)
protected LunaKey	decodeX509(X509EncodedKeySpec spec)
protected <T extends KeySpec> T	engineGetKeySpec(Key key, Class<T> specType) Gets a key spec of the specified class for the given key.
protected Key	engineTranslateKey(Key key) Extracts the specifications of the given public key or private key and returns an instance of LunaPublicKey or LunaPrivateKey.

Methods inherited from class java.security.KeyFactorySpi

engineGeneratePrivate, engineGeneratePublic

Methods inherited from class java.lang.Object

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

Constructor Detail

LunaKeyFactory

public LunaKeyFactory()

Method Detail

engineGetKeySpec

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

Gets a key spec of the specified class for the given key. Only X509EncodedKeySpecs for LunaPublicKeys are supported. Private key data never leaves the HSM, so no spec can be returned for LunaPrivateKeys.

Specified by:

engineGetKeySpec in class KeyFactorySpi

Parameters:

key - The key to get the spec for

specType - A class object representing the type of key spec requested. This must be X509EncodedKeySpec

Returns:

An instance of the requested key spec class containing the specifications of the given key

Throws:

InvalidKeySpecException - If the key class is anything than a subclass of LunaPublicKey, or if the key spec is anything other than X509EncodedKeySpec

engineTranslateKey

protected Key engineTranslateKey(Key key)
                          throws InvalidKeyException

Extracts the specifications of the given public key or private key and returns an instance of LunaPublicKey or LunaPrivateKey. If the incoming key is already an instance of one of those classes, the same key object is returned. If a new key is created on the HSM, it is a temporary session object; use the MakePersistent method to make it permanent.

Specified by:

engineTranslateKey in class KeyFactorySpi

Parameters:

key - The incoming key to translate into a Luna key

Returns:

An instance of a Luna key with the same specifications as the incoming key

Throws:

InvalidKeyException - If the incoming key is not an instance of PublicKey or PrivateKey

createLunaKey

protected abstract Key createLunaKey(PublicKey key)

decodeX509

protected LunaKey decodeX509(X509EncodedKeySpec spec)
                      throws InvalidKeySpecException

Throws:

InvalidKeySpecException