SmartFrog 3.10.000

org.smartfrog.sfcore.security
Interface SFSecurityEnvironment

All Known Implementing Classes:
SFSecurityEnvironmentImpl

public interface SFSecurityEnvironment

This interface encapsulates JSSE requirements for configuring a secure connection that can be used by RMI.


Method Summary
 java.rmi.server.RMIClientSocketFactory getEmptyRMIClientSocketFactory()
          Gets a RMI wrapper factory to the client's SSL factory (without initialized).
 java.rmi.server.RMIClientSocketFactory getRMIClientSocketFactory()
          Gets a RMI wrapper factory to the client's SSL factory.
 java.rmi.server.RMIServerSocketFactory getRMIServerSocketFactory()
          Gets a RMI wrapper factory to the server's SSL factory.
 java.rmi.server.RMISocketFactory getRMISocketFactory()
          Gets an RMISocketFactory that is "safe" enough for the default case.
 javax.net.ssl.SSLSocketFactory getSSLSocketFactory(boolean useClientMode)
          Returns a socket factory that can be used by RMI to establish a JSSE secure channnel.
 void handleSocket(SFSocket s)
          Handles a SFSocket with a SSL socket attached to it.
 

Method Detail

getSSLSocketFactory

javax.net.ssl.SSLSocketFactory getSSLSocketFactory(boolean useClientMode)
Returns a socket factory that can be used by RMI to establish a JSSE secure channnel.

Parameters:
useClientMode - If the factory generates SSL sockets that initiate the handshake.
Returns:
A socket factory that can be used by RMI to establish a JSSE secure channnel.

getRMIClientSocketFactory

java.rmi.server.RMIClientSocketFactory getRMIClientSocketFactory()
Gets a RMI wrapper factory to the client's SSL factory.

Returns:
A RMI wrapper factory to the client's SSL factory.

getEmptyRMIClientSocketFactory

java.rmi.server.RMIClientSocketFactory getEmptyRMIClientSocketFactory()
Gets a RMI wrapper factory to the client's SSL factory (without initialized).

Returns:
A RMI wrapper factory to the client's SSL factory (without initialized).

getRMIServerSocketFactory

java.rmi.server.RMIServerSocketFactory getRMIServerSocketFactory()
Gets a RMI wrapper factory to the server's SSL factory.

Returns:
A RMI wrapper factory to the server's SSL factory.

getRMISocketFactory

java.rmi.server.RMISocketFactory getRMISocketFactory()
Gets an RMISocketFactory that is "safe" enough for the default case. This will be installed as part of the security initialization. However, this default factory will be overwritten by the one specified in the object reference, so we should not expect that this "minimum security" will always be enforced.

Returns:
An RMISocketFactory that is "safe" enough for the default case, i.e., when the object reference does not specify otherwise.

handleSocket

void handleSocket(SFSocket s)
                  throws java.io.IOException
Handles a SFSocket with a SSL socket attached to it. This process includes configuring it depending on use mode and possibly waiting until the secure session gets established, and take an action according to the resulting peer characteristics.

Parameters:
s - A SFSocket with a SSL socket attached.
Throws:
java.io.IOException - Failure while configuring or establishing secure session.

SmartFrog CORE 3.10.000

(C) Copyright 1998-2006 Hewlett-Packard Development Company, LP