com.tencent.kona.sun.security.internal.spec

Class TlsKeyMaterialParameterSpec

java.lang.Object

com.tencent.kona.sun.security.internal.spec.TlsKeyMaterialParameterSpec

All Implemented Interfaces:

java.security.spec.AlgorithmParameterSpec

Deprecated.

Sun JDK internal use only --- WILL BE REMOVED in a future release.

@Deprecated
public class TlsKeyMaterialParameterSpec
extends java.lang.Object
implements java.security.spec.AlgorithmParameterSpec

Parameters for SSL/TLS key material generation. This class is used to initialize KeyGenerator of the type "TlsKeyMaterial". The keys returned by such KeyGenerators will be instances of TlsKeyMaterialSpec.

Instances of this class are immutable.

Since:

1.6

Constructor Summary

Constructors

Constructor and Description
TlsKeyMaterialParameterSpec(javax.crypto.SecretKey masterSecret, int majorVersion, int minorVersion, byte[] clientRandom, byte[] serverRandom, java.lang.String cipherAlgorithm, int cipherKeyLength, int expandedCipherKeyLength, int ivLength, int macKeyLength, java.lang.String prfHashAlg, int prfHashLength, int prfBlockSize) Deprecated. Constructs a new TlsKeyMaterialParameterSpec.

Method Summary

Modifier and Type	Method and Description
java.lang.String	getCipherAlgorithm() Deprecated. Returns the cipher algorithm.
int	getCipherKeyLength() Deprecated. Returns the length in bytes of the encryption key to be generated.
byte[]	getClientRandom() Deprecated. Returns a copy of the client's random value.
int	getExpandedCipherKeyLength() Deprecated. Returns the length in bytes of the expanded encryption key to be generated.
int	getIvLength() Deprecated. Returns the length in bytes of the initialization vector to be generated.
int	getMacKeyLength() Deprecated. Returns the length in bytes of the MAC key to be generated.
int	getMajorVersion() Deprecated. Returns the major version number.
javax.crypto.SecretKey	getMasterSecret() Deprecated. Returns the master secret.
int	getMinorVersion() Deprecated. Returns the minor version number.
int	getPRFBlockSize() Deprecated. Obtains the block size of the PRF hash algorithm.
java.lang.String	getPRFHashAlg() Deprecated. Obtains the PRF hash algorithm to use in the PRF calculation.
int	getPRFHashLength() Deprecated. Obtains the length of the PRF hash algorithm.
byte[]	getServerRandom() Deprecated. Returns a copy of the server's random value.

Methods inherited from class java.lang.Object

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

Constructor Detail

TlsKeyMaterialParameterSpec

public TlsKeyMaterialParameterSpec(javax.crypto.SecretKey masterSecret,
                                   int majorVersion,
                                   int minorVersion,
                                   byte[] clientRandom,
                                   byte[] serverRandom,
                                   java.lang.String cipherAlgorithm,
                                   int cipherKeyLength,
                                   int expandedCipherKeyLength,
                                   int ivLength,
                                   int macKeyLength,
                                   java.lang.String prfHashAlg,
                                   int prfHashLength,
                                   int prfBlockSize)

Deprecated.

Constructs a new TlsKeyMaterialParameterSpec.

Parameters:

masterSecret - the master secret

majorVersion - the major number of the protocol version

minorVersion - the minor number of the protocol version

clientRandom - the client's random value

serverRandom - the server's random value

cipherAlgorithm - the algorithm name of the cipher keys to be generated

cipherKeyLength - if 0, no cipher keys will be generated; otherwise, the length in bytes of cipher keys to be generated for domestic cipher suites; for cipher suites defined as exportable, the number of key material bytes to be generated;

expandedCipherKeyLength - 0 for domestic cipher suites; for exportable cipher suites the length in bytes of the key to be generated.

ivLength - the length in bytes of the initialization vector to be generated, or 0 if no initialization vector is required

macKeyLength - the length in bytes of the MAC key to be generated

prfHashAlg - the name of the TLS PRF hash algorithm to use. Used only for TLS 1.2+. TLS1.1 and earlier use a fixed PRF.

prfHashLength - the output length of the TLS PRF hash algorithm. Used only for TLS 1.2+.

prfBlockSize - the input block size of the TLS PRF hash algorithm. Used only for TLS 1.2+.

Throws:

java.lang.NullPointerException - if masterSecret, clientRandom, serverRandom, or cipherAlgorithm are null

java.lang.IllegalArgumentException - if the algorithm of masterSecret is not TlsMasterSecret, or if majorVersion or minorVersion are negative or larger than 255; or if cipherKeyLength, expandedKeyLength, ivLength, or macKeyLength are negative

Method Detail

getMasterSecret

public javax.crypto.SecretKey getMasterSecret()

Deprecated.

Returns the master secret.

Returns:

the master secret.

getMajorVersion

public int getMajorVersion()

Deprecated.

Returns the major version number.

Returns:

the major version number.

getMinorVersion

public int getMinorVersion()

Deprecated.

Returns the minor version number.

Returns:

the minor version number.

getClientRandom

public byte[] getClientRandom()

Deprecated.

Returns a copy of the client's random value.

Returns:

a copy of the client's random value.

getServerRandom

public byte[] getServerRandom()

Deprecated.

Returns a copy of the server's random value.

Returns:

a copy of the server's random value.

getCipherAlgorithm

public java.lang.String getCipherAlgorithm()

Deprecated.

Returns the cipher algorithm.

Returns:

the cipher algorithm.

getCipherKeyLength

public int getCipherKeyLength()

Deprecated.

Returns the length in bytes of the encryption key to be generated.

Returns:

the length in bytes of the encryption key to be generated.

getExpandedCipherKeyLength

public int getExpandedCipherKeyLength()

Deprecated.

Returns the length in bytes of the expanded encryption key to be generated. Returns zero if the expanded encryption key is not supposed to be generated.

Returns:

the length in bytes of the expanded encryption key to be generated.

getIvLength

public int getIvLength()

Deprecated.

Returns the length in bytes of the initialization vector to be generated. Returns zero if the initialization vector is not supposed to be generated.

Returns:

the length in bytes of the initialization vector to be generated.

getMacKeyLength

public int getMacKeyLength()

Deprecated.

Returns the length in bytes of the MAC key to be generated.

Returns:

the length in bytes of the MAC key to be generated.

getPRFHashAlg

public java.lang.String getPRFHashAlg()

Deprecated.

Obtains the PRF hash algorithm to use in the PRF calculation.

Returns:

the hash algorithm.

getPRFHashLength

public int getPRFHashLength()

Deprecated.

Obtains the length of the PRF hash algorithm.

Returns:

the hash algorithm length.

getPRFBlockSize

public int getPRFBlockSize()

Deprecated.

Obtains the block size of the PRF hash algorithm.

Returns:

the hash algorithm block size