iaik.pkcs.pkcs11.provider.keyfactories

Class DesEdeKeyFactory

java.lang.Object

javax.crypto.SecretKeyFactorySpi

iaik.pkcs.pkcs11.provider.keyfactories.PKCS11SecretKeyFactory

iaik.pkcs.pkcs11.provider.keyfactories.SecretKeyFactory

iaik.pkcs.pkcs11.provider.keyfactories.DesEdeKeyFactory

All Implemented Interfaces:

PKCS11EngineClass

public class DesEdeKeyFactory
extends SecretKeyFactory

This is a Tripple DES key factory that transforms Tripple DES key specs into PKCS#11 key objects and vice versa.

Author:

Karl Scheibelhofer

Field Summary

Fields

Modifier and Type	Field and Description
protected static java.lang.String	ALGORITHM_NAME The name of the key algorithm.

Fields inherited from class iaik.pkcs.pkcs11.provider.keyfactories.PKCS11SecretKeyFactory

pkcs11KeySpec_, pkcs11OperationInitialized_, session_, softwareDelegate_, tokenManager_

Constructor Summary

Constructors

Constructor and Description
DesEdeKeyFactory() Default constructor.

Method Summary

Modifier and Type	Method and Description
protected iaik.pkcs.pkcs11.objects.Object	createKeyCreationTemplate(java.security.spec.KeySpec keySpec) Create the key template to use as input for the object creation.
protected java.lang.String	getAlgorithmName() Get the (default) algorithm name of this factory.
protected boolean	isAlgorithmAccepted(java.lang.String algorithmName) Check, if this factory can handle keys of the algorithm given by its name.
protected java.security.spec.KeySpec	pkcs11GetKeySpec(javax.crypto.SecretKey key, java.lang.Class keySpecClass) Returns a specification (key material) of the given key object.
protected void	validateKeySpec(java.security.spec.KeySpec keySpec) Check, if this factory can handle the given key specification.

Methods inherited from class iaik.pkcs.pkcs11.provider.keyfactories.SecretKeyFactory

extractKeyMaterial, getSoftwareDelegateAlgorithm, isFormatAccepted, pkcs11GenerateSecret

Methods inherited from class iaik.pkcs.pkcs11.provider.keyfactories.PKCS11SecretKeyFactory

createKey, engineGenerateSecret, engineGetKeySpec, engineTranslateKey, finalize, finalizePkcs11Operation, initializePkcs11Operation, initializeSession, initializeSoftwareDelegate, isSessionAppropriate, isSupportedBy, pkcs11TranslateKey

Methods inherited from class java.lang.Object

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

Field Detail

ALGORITHM_NAME

protected static final java.lang.String ALGORITHM_NAME

The name of the key algorithm.

See Also:

Constant Field Values

Constructor Detail

DesEdeKeyFactory

public DesEdeKeyFactory()

Default constructor.

Method Detail

createKeyCreationTemplate

protected iaik.pkcs.pkcs11.objects.Object createKeyCreationTemplate(java.security.spec.KeySpec keySpec)
                                                             throws java.security.spec.InvalidKeySpecException

Create the key template to use as input for the object creation. The given secerte key specification provides application defined attributes.

Specified by:

createKeyCreationTemplate in class SecretKeyFactory

Parameters:

keySpec - The key spec providing algorithm specific key attributes.

Returns:

The key tempalte to serve as input for the PKCS#11 object creation.

Throws:

java.security.spec.InvalidKeySpecException - If the given key material is inapropriate for this factory.

Postconditions:

(result <> null)

Preconditions:

(keySpec <> null)

pkcs11GetKeySpec

protected java.security.spec.KeySpec pkcs11GetKeySpec(javax.crypto.SecretKey key,
                                                      java.lang.Class keySpecClass)
                                               throws java.security.spec.InvalidKeySpecException

Returns a specification (key material) of the given key object. keySpec identifies the specification class in which the key material should be returned. It could, for example, be SecretKeySpec.class, to indicate that the key material should be returned in an instance of the SecretKeySpec class.

Overrides:

pkcs11GetKeySpec in class SecretKeyFactory

Parameters:

key - The key.

keySpecClass - The specification class in which the key material should be returned.

Returns:

The underlying key specification (key material) in an instance of the requested specification class.

Throws:

java.security.spec.InvalidKeySpecException - if the requested key specification is inappropriate for the given key, or the given key cannot be dealt with (e.g., the given key has an unrecognized format).

Postconditions:

(result <> null)

Preconditions:

(key <> null) and (keySpecClass <> null) and (keySpecClass.equals(PKCS11KeySpec.class) or keySpecClass.equals(SecretKeySpec.class) or keySpecClass.equals(DESedeKeySpec.class))

getAlgorithmName

protected java.lang.String getAlgorithmName()

Get the (default) algorithm name of this factory.

Specified by:

getAlgorithmName in class PKCS11SecretKeyFactory

Returns:

The name of the key algorithm of this factory.

Postconditions:

(result <> null)

isAlgorithmAccepted

protected boolean isAlgorithmAccepted(java.lang.String algorithmName)

Check, if this factory can handle keys of the algorithm given by its name.

Specified by:

isAlgorithmAccepted in class SecretKeyFactory

Parameters:

algorithmName - The name of the key algorithm.

Returns:

True, if this factory can handle keys of this algorithm.

validateKeySpec

protected void validateKeySpec(java.security.spec.KeySpec keySpec)
                        throws java.security.spec.InvalidKeySpecException

Check, if this factory can handle the given key specification. This method trows an InvalidKeySpecException if the given keySpec is invalid.

Overrides:

validateKeySpec in class SecretKeyFactory

Parameters:

keySpec - The key specification.

Throws:

java.security.spec.InvalidKeySpecException - If the requested key specification is inappropriate for the given key, or the given key cannot be dealt with (e.g., the given key has an unrecognized format).

Preconditions:

(secretKeySpec <> null)