|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.apache.avalon.framework.logger.AbstractLogEnabled org.apache.avalon.cornerstone.blocks.sockets.SSLFactoryBuilder
Builds SSLContexts with desired properties. Hides all the gory details of SSLContext productions behind nice Avalon interfaces. Married to Sun JCA implementation.
Configuration looks like:
<ssl-factory> <keystore> <file>conf/keystore</file> <!-- keystore file location --> <password></password> <!-- Key Store file password, only used to check keystore integrity --> <key-password></key-password> <!-- Only required when you need to decrypt a private key --> <type>JKS</type> <!-- Key Store file format, defaults to JKS --> <algorithm>SunX509</algorithm> <!-- Cryptography provider ID, defaults to SunX509 --> </keystore> <!-- SSL protocol to use, defaults to TLS, another possible value is SSL --> <protocol>TLS</protocol> </ssl-factory>
Notes on keystore files. Absolute paths are supported. Relative paths are interpreted relative to .sar base directory. Defaults to conf/keystore. Since keystore usually contains sensitive keys it maybe beneficial to not include the keystores into the .sar files.
Constructor Summary | |
SSLFactoryBuilder()
|
Method Summary | |
javax.net.ssl.SSLServerSocketFactory |
buildServerSocketFactory()
Produces a fresh ssl server socket factory with configured parameters. |
javax.net.ssl.SSLSocketFactory |
buildSocketFactory()
Produces a fresh ssl socket factory with configured parameters. |
void |
configure(Configuration configuration)
Pass the Configuration to the Configurable
class. |
void |
contextualize(Context context)
Requires a BlockContext. |
void |
dispose()
The dispose operation is called at the end of a components lifecycle. |
void |
initialize()
Initialize the component. |
Methods inherited from class org.apache.avalon.framework.logger.AbstractLogEnabled |
enableLogging, getLogger, setupLogger, setupLogger, setupLogger |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public SSLFactoryBuilder()
Method Detail |
public void contextualize(Context context) throws ContextException
contextualize
in interface Contextualizable
context
- the context. Must not be null
.
ContextException
- if context is invalidpublic void configure(Configuration configuration) throws ConfigurationException
Configurable
Configuration
to the Configurable
class.
configure
in interface Configurable
configuration
- the class configurations. Must not be null
.
ConfigurationException
- if an error occurspublic javax.net.ssl.SSLSocketFactory buildSocketFactory()
public javax.net.ssl.SSLServerSocketFactory buildServerSocketFactory()
public void initialize() throws java.io.IOException, java.security.GeneralSecurityException
Initializable
initialize
in interface Initializable
java.io.IOException
java.security.GeneralSecurityException
public void dispose()
Disposable
dispose
in interface Disposable
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |