info.pppc.base.plugin.security

Class ExchangeSemantic

java.lang.Object

info.pppc.base.plugin.security.ExchangeSemantic

All Implemented Interfaces:

IExtension, IDispatcher, IPlugin, ISemantic

public class ExchangeSemantic
extends java.lang.Object
implements ISemantic

A semantic plug-in that implements a Diffie Hellmann key exchange on top of a secure three way handshake that is authenticated using certificates.

Author:

Mac

Field Summary

Fields

Modifier and Type	Field and Description
static short	PLUGIN_ABILITY The ability of the plug-in. [5][2].

Fields inherited from interface info.pppc.base.system.IExtension

EXTENSION_COMPRESSION, EXTENSION_DISCOVERY, EXTENSION_ENCRYPTION, EXTENSION_ROUTING, EXTENSION_SEMANTIC, EXTENSION_SERIALIZATION, EXTENSION_TRANSCEIVER

Constructor Summary

Constructors

Constructor and Description
ExchangeSemantic(IKeyStore store) Creates a new exchange semantic plug-in, uses the SECP160R1 curve to perform the key exchange.
ExchangeSemantic(java.lang.String curveID, IKeyStore store) Creates a new exchange semantic plug-in with the given ECC curveID.

Method Summary

Methods

Modifier and Type	Method and Description
void	deliverIncoming(IStreamConnector connector, ISession session) Called whenever an incoming connection is forwarded.
PluginDescription	getPluginDescription() Returns the plug-in description of the exchange semantic.
void	performOutgoing(Invocation invocation, ISession session) Called whenever an outgoing invocation shall be delivered.
boolean	prepareSession(PluginDescription d, NFCollection c, ISession s) Negotiates the configuration for the plug-in.
void	setSemanticManager(ISemanticManager manager) Sets the semantic manager.
void	start() Stops the plug-in.
void	stop() Starts the plug-in.

Methods inherited from class java.lang.Object

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

Field Detail

PLUGIN_ABILITY

public static final short PLUGIN_ABILITY

The ability of the plug-in. [5][2].

See Also:

Constant Field Values

Constructor Detail

ExchangeSemantic

public ExchangeSemantic(IKeyStore store)

Creates a new exchange semantic plug-in, uses the SECP160R1 curve to perform the key exchange.

Parameters:

store - The key store that should be used to retrieve and store keys and certificates

ExchangeSemantic

public ExchangeSemantic(java.lang.String curveID,
                IKeyStore store)

Creates a new exchange semantic plug-in with the given ECC curveID. Use null to use DH for key-exchange.

Parameters:

curveID - The ECC curve that should be used for the key exchange, can be null to use DH for the key-exchange.

store - The key store that should be used to retrieve and store keys and certificates

Method Detail

prepareSession

public boolean prepareSession(PluginDescription d,
                     NFCollection c,
                     ISession s)

Negotiates the configuration for the plug-in.

Specified by:

prepareSession in interface ISemantic

Parameters:

d - The description of the remote plug-in.

c - The nf collection with requirements.

s - The session object to store the configuration.

Returns:

False if the specified context cannot be fulfilled.

deliverIncoming

public void deliverIncoming(IStreamConnector connector,
                   ISession session)

Called whenever an incoming connection is forwarded.

Specified by:

deliverIncoming in interface IDispatcher

Parameters:

connector - The connector for the new connection.

session - The session of the new connection.

performOutgoing

public void performOutgoing(Invocation invocation,
                   ISession session)

Called whenever an outgoing invocation shall be delivered.

Specified by:

performOutgoing in interface ISemantic

Parameters:

invocation - The invocation.

session - The session configuration.

setSemanticManager

public void setSemanticManager(ISemanticManager manager)

Sets the semantic manager.

Specified by:

setSemanticManager in interface ISemantic

Parameters:

manager - The manager of the plug-in.

start

public void start()

Stops the plug-in.

Specified by:

start in interface IPlugin

stop

public void stop()

Starts the plug-in.

Specified by:

stop in interface IPlugin

getPluginDescription

public PluginDescription getPluginDescription()

Returns the plug-in description of the exchange semantic.

Specified by:

getPluginDescription in interface IPlugin

Returns:

The description of the plug-in.