org.ssonet.net
Class MechanismInstance

java.lang.Object
  |
  +--org.ssonet.net.MechanismInstance

public abstract class MechanismInstance

extends java.lang.Object

This class provides a mechanism for unified access to security mechanisms. By calling getMechanismInstance() a security mechanism with the given parameters is returned.

Field Summary

static java.util.Hashtable	config
static boolean	debug

Constructor Summary

MechanismInstance()

Method Summary

static org.ssonet.io.IOStream

getMechanismInstance(int securityGoal, java.lang.String mechanismName, org.ssonet.io.IOStream ioStream, org.ssonet.net.SSONETContext context, org.ssonet.mechanisms.MechanismConfiguration ownMechanismConfiguration, org.ssonet.mechanisms.MechanismConfiguration partnerMechanismConfiguration, org.ssonet.net.KeyExchange keyExchange) Initialize Mechanisms with key exchange for use in a communikation link.

Methods inherited from class java.lang.Object

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

Field Detail

debug

public static boolean debug

config

public static java.util.Hashtable config

Constructor Detail

MechanismInstance

public MechanismInstance()

Method Detail

getMechanismInstance

public static org.ssonet.io.IOStream getMechanismInstance(int securityGoal,
                                                          java.lang.String mechanismName,
                                                          org.ssonet.io.IOStream ioStream,
                                                          org.ssonet.net.SSONETContext context,
                                                          org.ssonet.mechanisms.MechanismConfiguration ownMechanismConfiguration,
                                                          org.ssonet.mechanisms.MechanismConfiguration partnerMechanismConfiguration,
                                                          org.ssonet.net.KeyExchange keyExchange)
                                                   throws ParameterNotCompatibleException,
                                                          java.io.IOException

Initialize Mechanisms with key exchange for use in a communikation link. The keys are taken from the object context

Parameters:

securityGoal - the security goal, for which the mechanism is to be used, @see SSONETConstants

mechanismName - the name of the mechanism

ioStream - the stream, where the mechanism shall be applied to. During initialization this ioStream must not be used to transmit data. Initialization data must be transmitted using the keyExchange object.

context - the SSONETContext object of the connection, for which the mechanism is to be used

ownMechanismConfiguration - the mechanisms configuration from the party calling this method

partnerMechanismConfiguration - the mechanisms configuration from the remote party

keyExchange - the object holding methods for secure key exchange, which is needed during initialization if the mechanisms. This object must allready be initialized.

Returns:

the initialized mechanism

Throws:

ParameterNotCompatibleException - if negotiation between ownMechanismConfiguration and partnerMechanismConfiguration resulted in a conflict, so that the mechanism could not be initialized.

java.io.IOException - if an error occured during initialization of the mechanism