iaik.pkcs.pkcs11.params

Class SSL3KeyMaterialOutParams

java.lang.Object

iaik.pkcs.pkcs11.params.SSL3KeyMaterialOutParams

All Implemented Interfaces:

Params

public class SSL3KeyMaterialOutParams
extends Object
implements Params

Objects of this class encapsulates key material output for the mechanism Mechanism.SSL3_KEY_AND_MAC_DERIVE.

Version:

1.0

Author:

Karl Scheibelhofer

Field Summary

Fields

Modifier and Type	Field and Description
protected byte[]	clientIV The initialization vector (IV) created for the client (if any).
protected SecretKey	clientKey The resulting Client Secret key.
protected SecretKey	clientMacSecret The resulting Client MAC Secret key.
protected byte[]	serverIV The initialization vector (IV) created for the server (if any).
protected SecretKey	serverKey The resulting Server Secret key.
protected SecretKey	serverMacSecret The resulting Server MAC Secret key.

Constructor Summary

Constructors

Constructor and Description
SSL3KeyMaterialOutParams(byte[] clientIV, byte[] serverIV) Create a new SSL3KeyMaterialOutParameters object.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object otherObject) Compares all member variables of this object with the other object.
byte[]	getClientIV() Get the resulting client initialization vector.
SecretKey	getClientMacSecret() Get the resulting client MAC secret key.
SecretKey	getClientSecret() Get the resulting client secret key.
Object	getPKCS11ParamsObject() Get this parameters object as an object of the CK_SSL3_KEY_MAT_OUT class.
byte[]	getServerIV() Get the resulting server initialization vector.
SecretKey	getServerMacSecret() Get the resulting server MAC secret key.
SecretKey	getServerSecret() Get the resulting server secret key.
int	hashCode() The overriding of this method should ensure that the objects of this class work correctly in a hashtable.
void	setPKCS11ParamsObject(sun.security.pkcs11.wrapper.CK_SSL3_KEY_MAT_OUT input, Session session) This method takes the key handles from the given input structure, which will be the result after a call to DeriveKey, and creates the SecretKey objects for this object.
String	toString() Returns the string representation of this object.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

clientMacSecret

protected SecretKey clientMacSecret

The resulting Client MAC Secret key.

serverMacSecret

protected SecretKey serverMacSecret

The resulting Server MAC Secret key.

clientKey

protected SecretKey clientKey

The resulting Client Secret key.

serverKey

protected SecretKey serverKey

The resulting Server Secret key.

clientIV

protected byte[] clientIV

The initialization vector (IV) created for the client (if any).

serverIV

protected byte[] serverIV

The initialization vector (IV) created for the server (if any).

Constructor Detail

SSL3KeyMaterialOutParams

public SSL3KeyMaterialOutParams(byte[] clientIV,
                                byte[] serverIV)

Create a new SSL3KeyMaterialOutParameters object. It does not take any parameters, because they user does not need to set any of them. The token sets all of them, after a call to DeriveKey using the mechanism Mechanism.SSL3_KEY_AND_MAC_DERIVE. After the call to deriveKey, the members of this object will hold the generated keys and IVs.

Parameters:

clientIV - The buffer for the client initialization vector.

serverIV - The buffer for the server initialization vector.

Method Detail

getPKCS11ParamsObject

public Object getPKCS11ParamsObject()

Get this parameters object as an object of the CK_SSL3_KEY_MAT_OUT class.

Specified by:

getPKCS11ParamsObject in interface Params

Returns:

This object as a CK_SSL3_KEY_MAT_OUT object.

setPKCS11ParamsObject

public void setPKCS11ParamsObject(sun.security.pkcs11.wrapper.CK_SSL3_KEY_MAT_OUT input,
                                  Session session)
                           throws TokenException

This method takes the key handles from the given input structure, which will be the result after a call to DeriveKey, and creates the SecretKey objects for this object. It also reads the IVs.

Parameters:

input - The structure that holds the necessary key handles and IVs.

session - The session to use for reading attributes. This session must have the appropriate rights; i.e. it must be a user-session, if it is a private object.

Throws:

TokenException - If reading the secret key object attributes fails.

getClientMacSecret

public SecretKey getClientMacSecret()

Get the resulting client MAC secret key.

Returns:

The resulting client MAC secret key.

getServerMacSecret

public SecretKey getServerMacSecret()

Get the resulting server MAC secret key.

Returns:

The resulting server MAC secret key.

getClientSecret

public SecretKey getClientSecret()

Get the resulting client secret key.

Returns:

The resulting client secret key.

getServerSecret

public SecretKey getServerSecret()

Get the resulting server secret key.

Returns:

The resulting server secret key.

getClientIV

public byte[] getClientIV()

Get the resulting client initialization vector.

Returns:

The resulting client initialization vector.

getServerIV

public byte[] getServerIV()

Get the resulting server initialization vector.

Returns:

The resulting server initialization vector.

toString

public String toString()

Returns the string representation of this object. Do not parse data from this string, it is for debugging only.

Overrides:

toString in class Object

Returns:

A string representation of this object.

equals

public boolean equals(Object otherObject)

Compares all member variables of this object with the other object. Returns only true, if all are equal in both objects.

Overrides:

equals in class Object

Parameters:

otherObject - The other object to compare to.

Returns:

True, if other is an instance of this class and all member variables of both objects are equal. False, otherwise.

hashCode

public int hashCode()

The overriding of this method should ensure that the objects of this class work correctly in a hashtable.

Overrides:

hashCode in class Object

Returns:

The hash code of this object.