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 java.security.KeyFactorySpi

Abstract base class for the Luna key factories.

Constructor Summary

Constructors

Constructor and Description
LunaKeyFactory()

Method Summary

Methods

Modifier and Type	Method and Description
protected abstract java.security.Key	createLunaKey(java.security.PublicKey key)
protected LunaKey	decodeX509(java.security.spec.X509EncodedKeySpec spec)
protected <T extends java.security.spec.KeySpec> T	engineGetKeySpec(java.security.Key key, java.lang.Class<T> specType) Gets a key spec of the specified class for the given key.
protected java.security.Key	engineTranslateKey(java.security.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 java.security.spec.KeySpec> T engineGetKeySpec(java.security.Key key,
                                                        java.lang.Class<T> specType)
                                                         throws java.security.spec.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 java.security.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:

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

engineTranslateKey

protected java.security.Key engineTranslateKey(java.security.Key key)
                                        throws java.security.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 java.security.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:

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

createLunaKey

protected abstract java.security.Key createLunaKey(java.security.PublicKey key)

decodeX509

protected LunaKey decodeX509(java.security.spec.X509EncodedKeySpec spec)
                      throws java.security.spec.InvalidKeySpecException

Throws:

java.security.spec.InvalidKeySpecException