info.pppc.base.plugin.security

Class SecureModifier

java.lang.Object

info.pppc.base.plugin.security.SecureModifier

All Implemented Interfaces:

IExtension, IModifier, IPlugin

public class SecureModifier
extends java.lang.Object
implements IModifier

The security plug-in provides authentication and encryption. The plug-in can be configured for each session to use authentication only mode or authentication and encryption mode. This is controlled via the

Author:

Marcus Handte

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	SecureModifier.StreamConnector The stream connector provides AES encrypted input and output streams depending on the implementation of the underlying stream connector.

Field Summary

Fields

Modifier and Type	Field and Description
static short	PLUGIN_ABILITY The ability of the plug-in. [2][0].
static java.lang.String	PROPERTY_SYSTEM The property in the plug-in description that contains a system id.

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
SecureModifier(IKeyStore keyStore) Creates a new secure modifier.

Method Summary

Methods

Modifier and Type	Method and Description
PluginDescription	getPluginDescription() Returns the plug-in description of this plug-in.
IStreamConnector	openSession(IStreamConnector connector, ISession context) Determines whether the plugin is in a valid state.
boolean	prepareSession(PluginDescription description, NFCollection collection, ISession session) Negotiates the session properties of a connection with a remote target.
void	setPluginManager(IPluginManager manager) Sets the plug-in manager that is used to retrieve remote plug-in descriptions.
void	start() Called to start the plug-in.
void	stop() Called to stop the plug-in.

Methods inherited from class java.lang.Object

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

Field Detail

PROPERTY_SYSTEM

public static java.lang.String PROPERTY_SYSTEM

The property in the plug-in description that contains a system id.

PLUGIN_ABILITY

public static final short PLUGIN_ABILITY

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

See Also:

Constant Field Values

Constructor Detail

SecureModifier

public SecureModifier(IKeyStore keyStore)

Creates a new secure modifier.

Method Detail

prepareSession

public boolean prepareSession(PluginDescription description,
                     NFCollection collection,
                     ISession session)

Negotiates the session properties of a connection with a remote target. Since this plug-in has only one mode of operation, negotiation is not necessary.

Specified by:

prepareSession in interface IModifier

Parameters:

collection - The non-functional parameters.

session - The session data used to create a connector.

description - The plug-in description of the remote plug-in.

Returns:

Always true, since this plug-in does not deal with nonfunctional parameters.

openSession

public IStreamConnector openSession(IStreamConnector connector,
                           ISession context)
                             throws java.io.IOException

Determines whether the plugin is in a valid state. If the plugin has been started and initialized properly, the result of a call to this method will be a new stream connector that supports secure input and output streams.

Specified by:

openSession in interface IModifier

Parameters:

connector - The connector used to create the connector.

context - The session data used to communicate with a remote plugin.

Returns:

A stream connector that is connected to the specified stream connector.

Throws:

java.io.IOException - Thrown if the connector could not be created.

start

public void start()

Called to start the plug-in. This method initializes the plug-in and enables the creation of connectors. All open calls will fail before this method has been called.

Specified by:

start in interface IPlugin

stop

public void stop()

Called to stop the plug-in. After this method has been called, all open calls will fail.

Specified by:

stop in interface IPlugin

setPluginManager

public void setPluginManager(IPluginManager manager)

Sets the plug-in manager that is used to retrieve remote plug-in descriptions.

Specified by:

setPluginManager in interface IModifier

Parameters:

manager - The plug-in manager.

getPluginDescription

public PluginDescription getPluginDescription()

Returns the plug-in description of this plug-in. There will be only one instance of the plug-in description per instance of this plug-in.

Specified by:

getPluginDescription in interface IPlugin

Returns:

The plug-in description of this plug-in.