IceSSL

Interface Plugin

All Superinterfaces:

Plugin

public interface Plugin
extends Plugin

Interface that allows applications to interact with the IceSSL plug-in.

Field Summary

Fields inherited from interface Ice.Plugin

serialVersionUID

Method Summary

Modifier and Type	Method and Description
void	addSeedStream(java.io.InputStream stream) Adds an input stream for the random number seed.
CertificateVerifier	getCertificateVerifier() Returns the certificate verifier.
javax.net.ssl.SSLContext	getContext() Returns the SSL context.
PasswordCallback	getPasswordCallback() Returns the password callback.
void	setCertificateVerifier(CertificateVerifier verifier) Establishes the certificate verifier.
void	setContext(javax.net.ssl.SSLContext context) Establishes the SSL context.
void	setKeystoreStream(java.io.InputStream stream) Supplies an input stream for the keystore.
void	setPasswordCallback(PasswordCallback callback) Establishes the password callback.
void	setTruststoreStream(java.io.InputStream stream) Supplies an input stream for the truststore.

Methods inherited from interface Ice.Plugin

destroy, initialize

Method Detail

setContext

void setContext(javax.net.ssl.SSLContext context)

Establishes the SSL context. The context must be established before plug-in is initialized. Therefore, the application must set the property Ice.InitPlugins to zero, call setContext to set the context, and finally invoke PluginManager.initializePlugins().

If an application supplies its own SSL context, the plug-in skips its normal property-based configuration.

Parameters:

context - The SSL context for the plug-in.

getContext

javax.net.ssl.SSLContext getContext()

Returns the SSL context. Use caution when modifying the returned value: changes made to this value do not affect existing connections.

Returns:

The SSL context for the plug-in.

setCertificateVerifier

void setCertificateVerifier(CertificateVerifier verifier)

Establishes the certificate verifier. This must be done before any connections are established.

Parameters:

verifier - The certificate verifier.

getCertificateVerifier

CertificateVerifier getCertificateVerifier()

Returns the certificate verifier.

Returns:

The certificate verifier (null if not set).

setPasswordCallback

void setPasswordCallback(PasswordCallback callback)

Establishes the password callback. This must be done before the plug-in is initialized.

Parameters:

callback - The password callback.

getPasswordCallback

PasswordCallback getPasswordCallback()

Returns the password callback.

Returns:

The password callback (null if not set).

setKeystoreStream

void setKeystoreStream(java.io.InputStream stream)

Supplies an input stream for the keystore. Calling this method causes IceSSL to ignore the IceSSL.Keystore property.

Parameters:

stream - The input stream for the keystore.

setTruststoreStream

void setTruststoreStream(java.io.InputStream stream)

Supplies an input stream for the truststore. Calling this method causes IceSSL to ignore the IceSSL.Truststore property. It is legal to supply the same input stream as the one for setKeystoreStream(java.io.InputStream), in which case IceSSL uses the certificates contained in the keystore.

Parameters:

stream - The input stream for the truststore.

addSeedStream

void addSeedStream(java.io.InputStream stream)

Adds an input stream for the random number seed. You may call this method multiple times if necessary.

Parameters:

stream - The input stream for the random number seed.