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

Class DilithiumKeyPairGenerator

java.lang.Object
java.security.KeyPairGeneratorSpi
com.ibm.crypto.hdwrCCA.provider.DilithiumKeyPairGenerator
@Deprecated(since="21.0.11.0", forRemoval=true) public class DilithiumKeyPairGenerator extends KeyPairGeneratorSpi
Deprecated, for removal: This API element is subject to removal in a future version.
Replaced by ML-DSA implementation. This CRYSTALS-Dilithium implementation is deprecated and will be removed in a future release, in alignment with NIST's latest recommendations for post-quantum cryptography modernization. Users should transition to the finalized ML-DSA standards.
This class generates CRSTALS-Dilithium public/private key pairs via hardware. An application can specify the size, the key label, the storage type and usage type of the key pair to be generated via an instance of the DilithiumKeyParameterSpec class.
See Also:

  • Constructor Summary

    Constructors
    Constructor
    Description
    DilithiumKeyPairGenerator()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Creates a new instance of this class.

  • Method Summary

    Modifier and Type
    Method
    Description
    KeyPair
    generateKeyPair()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Generates a CRYSTALS-Dilithium key pair via hardware.
    void
    initialize(int keysize, SecureRandom random)
    Deprecated, for removal: This API element is subject to removal in a future version.
    CRYSTALS-Dilithium does not support key size specifications.
    void
    initialize(AlgorithmParameterSpec params, SecureRandom random)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Initializes this KeyPairGenerator for given parameters and secure random source.

    Methods inherited from class java.lang.Object

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

  • Constructor Details

    • DilithiumKeyPairGenerator

      public DilithiumKeyPairGenerator()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Creates a new instance of this class.

  • Method Details

    • initialize

      public void initialize(int keysize, SecureRandom random)
      Deprecated, for removal: This API element is subject to removal in a future version.
      CRYSTALS-Dilithium does not support key size specifications.
      Specified by:
      initialize in class KeyPairGeneratorSpi

    • initialize

      public void initialize(AlgorithmParameterSpec params, SecureRandom random) throws InvalidAlgorithmParameterException
      Deprecated, for removal: This API element is subject to removal in a future version.
      Initializes this KeyPairGenerator for given parameters and secure random source.
      Overrides:
      initialize in class KeyPairGeneratorSpi
      Parameters:
      params - the AlgorithmParameterSpec for this object.
      random - the SecureRandom object for generating random numbers.
      Throws:
      InvalidAlgorithmParameterException - thrown when parameter set is not recognized.

    • generateKeyPair

      public KeyPair generateKeyPair()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Generates a CRYSTALS-Dilithium key pair via hardware.
      Specified by:
      generateKeyPair in class KeyPairGeneratorSpi
      Returns:
      a KeyPair contains a pair of generated CRYSTALS-Dilithium keys
      Throws:
      IllegalArgumentException - in the key label formal is not valid