Module ibm.crypto.hdwrcca
Package com.ibm.crypto.hdwrCCA.provider

Class DESKeyFactory

java.lang.Object
javax.crypto.SecretKeyFactorySpi
com.ibm.crypto.hdwrCCA.provider.DESKeyFactory
public final class DESKeyFactory extends SecretKeyFactorySpi
This class implements the DES key factory of the IBMJCECCA provider.

This documentation describes a Service Provider Interface. It is provided for implementation insight only. This class is not intended to be called directly by application developers. Please consult the 'Java Cryptography Architecture Standard' for details on how to use this interface through a public standard class.

NOTE:
Certain operations may require specific hardware or software, or specific key types. See the rest of this document and the z/OS Unique Considerations Hardware Crypto Reference Guide for more details. Unsupported operations and/or combinations may result in a RuntimeException Hardware Error.
For public interface details, consult the JCE API documentation for java.security.KeyFactory.

  • Constructor Details

    • DESKeyFactory

      public DESKeyFactory()
      Verify the JCE framework in the constructor.
      Throws:
      SecurityException - if fails to verify the JCE framework.

  • Method Details

    • engineGenerateSecret

      protected SecretKey engineGenerateSecret(KeySpec keySpec) throws InvalidKeySpecException
      Generates a SecretKey object from the provided key specification (key material).
      Specified by:
      engineGenerateSecret in class SecretKeyFactorySpi
      Parameters:
      keySpec - the specification (key material) of the secret key
      Returns:
      the secret key
      Throws:
      InvalidKeySpecException - if the given key specification is inappropriate for this key factory to produce a public key.

    • engineGetKeySpec

      protected KeySpec engineGetKeySpec(SecretKey key, Class<?> keySpec) throws InvalidKeySpecException
      Returns a specification (key material) of the given key in the requested format.
      Specified by:
      engineGetKeySpec in class SecretKeyFactorySpi
      Parameters:
      key - the key
      keySpec - the requested format in which the key material shall be returned
      Returns:
      the underlying key specification (key material) in the requested format
      Throws:
      InvalidKeySpecException - if the requested key specification is inappropriate for the given key, or the given key cannot be processed (e.g., the given key has an unrecognized algorithm or format).

    • engineTranslateKey

      protected SecretKey engineTranslateKey(SecretKey key) throws InvalidKeyException
      Translates a SecretKey object, whose provider may be unknown or potentially untrusted, into a corresponding SecretKey object of this key factory.
      Specified by:
      engineTranslateKey in class SecretKeyFactorySpi
      Parameters:
      key - the key whose provider is unknown or untrusted
      Returns:
      the translated key
      Throws:
      InvalidKeyException - if the given key cannot be processed by this key factory.