Skip navigation links

Oracle® Coherence Java API Reference
Release 3.7.0.0

E18683-01


com.tangosol.net.security
Class ClusterEncryptionFilter

java.lang.Object
  extended by com.tangosol.util.Base
      extended by 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

Oracle® Coherence Java API Reference
Release 3.7.0.0

E18683-01


Copyright © 2000, 2011, Oracle and/or its affiliates. All rights reserved.