Skip navigation links

com.tangosol.net.security
Class ClusterEncryptionFilter

java.lang.Object
com.tangosol.util.Base
com.tangosol.net.security.ClusterEncryptionFilter

All Implemented Interfaces:

WrapperStreamFactory, XmlConfigurable

Deprecated. As of Coherence 3.7, deprecated replaced by SSL.

@Deprecated
public class ClusterEncryptionFilter

extends Base

implements WrapperStreamFactory, XmlConfigurable

Encryption filter implementation which switches between asymmetric and symmetric encryption based upon the type of data being filtered.

Asymmetric encryption is applied to the cluster service data to protect against untrusted entities joining the cluster. Data for other services is encrypted using a random shared symmetric key which is generated by the cluster's senior member and securely provided to other members via the cluster service. Unlike most cluster service traffic the shared secret is encrypted with both the originator's private key and the recipient's public key.

Custom certificate validation may be provided by extending the AsymmetricEncryptionFilter class, and supplying the alternate implementation as part of this filter's configuration.

Author:

mf 2006.08.08

See Also:

setConfig(com.tangosol.run.xml.XmlElement), AsymmetricEncryptionFilter, SymmetricEncryptionFilter

Nested Class Summary

class	ClusterEncryptionFilter.DemultiplexingInputStream Deprecated. WrapperInputStram which chooses the appropriate wrapper based on the protocol context.
class	ClusterEncryptionFilter.MultiplexingOutputStream Deprecated. WrapperOutputStram which chooses the appropriate wrapper based on the protocol context.

Field Summary

protected int	m_nSharedKeySize Deprecated. Shared key length.
protected java.lang.String	m_sSharedKeyAlgorithm Deprecated. Shared key algorithm.
protected AsymmetricEncryptionFilter	m_wrapperAsymmetric Deprecated. The AsymmetricEncryptionFilter.
protected SymmetricEncryptionFilter	m_wrapperSymmetric Deprecated. The SymmetricEncryptionFilter.

Constructor Summary

ClusterEncryptionFilter()
Deprecated.

Method Summary

XmlElement	getConfig() Deprecated. Determine the current configuration of the object.
java.io.InputStream	getInputStream(java.io.InputStream stream) Deprecated. Requests an InputStream that wraps the passed InputStream.
java.io.OutputStream	getOutputStream(java.io.OutputStream stream) Deprecated. Requests an OutputStream that wraps the passed OutputStream.
javax.crypto.SecretKey	getSharedKey() Deprecated. Return the shared key, or generate one if none exists.
protected void	readSharedKey(java.io.DataInputStream stream) Deprecated. Read the shared key from the InputStream.
protected WrapperStreamFactory	selectWrapper(ProtocolContext context) Deprecated. Select a Filter based on the supplied protocol information.
void	setConfig(XmlElement xml) Deprecated. Configures the ClusterEncryptionFilter.
void	setSharedKey(javax.crypto.SecretKey key) Deprecated. Set the shared key.
protected void	writeSharedKey(java.io.DataOutputStream stream, Member memberTo) Deprecated. Write the shared cluster secret to the supplied OutputStream.

Field Detail

m_sSharedKeyAlgorithm

protected java.lang.String m_sSharedKeyAlgorithm

Deprecated.

Shared key algorithm.

m_nSharedKeySize

protected int m_nSharedKeySize

Deprecated.

Shared key length.

m_wrapperSymmetric

protected SymmetricEncryptionFilter m_wrapperSymmetric

Deprecated.

The SymmetricEncryptionFilter.

m_wrapperAsymmetric

protected AsymmetricEncryptionFilter m_wrapperAsymmetric

Deprecated.

The AsymmetricEncryptionFilter.

Constructor Detail

ClusterEncryptionFilter

public ClusterEncryptionFilter()

Deprecated.

Method Detail

selectWrapper

protected WrapperStreamFactory selectWrapper(ProtocolContext context)

Deprecated.

Select a Filter based on the supplied protocol information.

Parameters:

context - the protocol context

Returns:

the WrapperStreamFactory to use

readSharedKey

protected void readSharedKey(java.io.DataInputStream stream)

Deprecated.

Read the shared key from the InputStream.

Parameters:

stream - the stream to read the secret from

writeSharedKey

protected void writeSharedKey(java.io.DataOutputStream stream,
                              Member memberTo)

Deprecated.

Write the shared cluster secret to the supplied OutputStream. The key will be encrypted using the target members public key.

Parameters:

stream - the stream to write the secret to

memberTo - the member to which the key will be sent

getSharedKey

public javax.crypto.SecretKey getSharedKey()

Deprecated.

Return the shared key, or generate one if none exists.

Returns:

the shared key

setSharedKey

public void setSharedKey(javax.crypto.SecretKey key)

Deprecated.

Set the shared key.

Parameters:

key - the shared key

getInputStream

public java.io.InputStream getInputStream(java.io.InputStream stream)

Deprecated.

Requests an InputStream that wraps the passed InputStream.

Specified by:

getInputStream in interface WrapperStreamFactory

Parameters:

stream - the java.io.InputStream to be wrapped

Returns:

an InputStream that delegates to ("wraps") the passed InputStream

getOutputStream

public java.io.OutputStream getOutputStream(java.io.OutputStream stream)

Deprecated.

Requests an OutputStream that wraps the passed OutputStream.

Specified by:

getOutputStream in interface WrapperStreamFactory

Parameters:

stream - the java.io.OutputStream to be wrapped

Returns:

an OutputStream that delegates to ("wraps") the passed OutputStream

getConfig

public XmlElement getConfig()

Deprecated.

Determine the current configuration of the object.

Specified by:

getConfig in interface XmlConfigurable

Returns:

the XML configuration or null

setConfig

public void setConfig(XmlElement xml)

Deprecated.

Configures the ClusterEncryptionFilter. This supports the same configuration elements as the AsymmetricEncryptionFilter as well as:

<li/> sharedKeyType - the type of shared key, default to DESede <li/> sharedKeySize - the size of shared key, default to 112 <li/> asymmetricFilterClassName - an alternate implementation of AsymmetricEncryptionFilter

Specified by:

setConfig in interface XmlConfigurable

Parameters:

xml - the XML configuration for the object

See Also:

AsymmetricEncryptionFilter.setConfig(com.tangosol.run.xml.XmlElement)

Skip navigation links