Class KyberKeyParameterSpec

java.lang.Object

com.ibm.crypto.hdwrCCA.provider.KyberKeyParameterSpec

All Implemented Interfaces:

AlgorithmParameterSpec

public class KyberKeyParameterSpec
extends Object
implements AlgorithmParameterSpec

This class provides means for specifying the parameters for a CRYSTALS-Kyber key pair to be generated via the KyberKeyPairGenerator class. These parameters are:

type, which is either KeyHWAttrubuteValues.PKDS, KeyHWAttributeValues.MASTER, or KeyHWAttributeValues.CLEAR;

usage must be KeyHWAttributeValues.SIGNATURE;

name, the name or OID of the desired algorithm. Acceptable OIDs: "1.3.6.1.4.1.2.267.5.4.4" - CRYSTALS-Kyber 1024 Round 2 Acceptable names: "kyber1024r2" - CRYSTALS-Kyber 1024 Round 2

keylabel which is the label associated with the generated private key.

This class is immutable.

Constructor Summary

Constructors

Constructor	Description
KyberKeyParameterSpec(String name)	Creates a parameter set.
KyberKeyParameterSpec(String name, byte type)	Creates a parameter set.
KyberKeyParameterSpec(String name, byte type, byte usage)	Creates a parameter set.
KyberKeyParameterSpec(String name, byte type, byte usage, String label)	Creates a parameter set.

Method Summary

Modifier and Type	Method	Description
KyberKeyAttributes	getAttributes()	Returns the key pair attributes.
String	getLabelString()	Returns the key label that will be used to store the private key.
String	getName()	Returns the name

Methods inherited from class Object

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

Constructor Details

KyberKeyParameterSpec

public KyberKeyParameterSpec(String name)
                      throws IllegalArgumentException

Creates a parameter set. The type is defaulted to KeyHWAttributeValues.MASTER. The usage is defaulted to KeyHWAttributeValues.KEYMANAGEMENT.

Parameters:

name - the standard name or OID of the algorithm parameters

Throws:

IllegalArgumentException - for any parameter values outside the bounds for that parameter.

KyberKeyParameterSpec

public KyberKeyParameterSpec(String name,
 byte type)
                      throws IllegalArgumentException

Creates a parameter set. The usage is defaulted to KeyHWAttributeValues.KEYMANAGEMENT.

Parameters:

name - the standard name or OID of the algorithm parameters

type - the hardware key type determined from KeyHWAttributeValues PKDS (key storage), MASTER (encrypted under ICSF master key), or CLEAR.

Throws:

IllegalArgumentException - for any parameter values outside the bounds for that parameter.

KyberKeyParameterSpec

public KyberKeyParameterSpec(String name,
 byte type,
 byte usage)
                      throws IllegalArgumentException

Creates a parameter set.

Parameters:

name - the standard name or OID of the algorithm parameters

type - the hardware key type determined from KeyHWAttributeValues PKDS (key storage), MASTER (encrypted under ICSF master key), or CLEAR.

usage - the way that the key will be used, must be KEYMANAGEMENT

Throws:

IllegalArgumentException - for any parameter values outside the bounds for that parameter.

KyberKeyParameterSpec

public KyberKeyParameterSpec(String name,
 byte type,
 byte usage,
 String label)
                      throws IllegalArgumentException

Creates a parameter set.

Parameters:

name - the standard name or OID of the algorithm parameters

type - the hardware key type determined from KeyHWAttributeValues PKDS (key storage), MASTER (encrypted under ICSF master key), or CLEAR.

usage - the way that the key will be used, must be KEYMANAGEMENT

label - if a KeyHWAttributeValues.PKDS key, the label used to identify the key. If a KeyHWAttributeValues.CLEAR key, label is ignored.

Throws:

IllegalArgumentException - for any parameter values outside the bounds for that parameter.

Method Details

getName

public String getName()

Returns the name

Returns:

the name

getAttributes

public KyberKeyAttributes getAttributes()

Returns the key pair attributes.

Returns:

the key pair attributes.

getLabelString

public String getLabelString()

Returns the key label that will be used to store the private key.

Returns:

the key label. Returns null if no label is associated with this parameter spec.