Jive Messenger 2.2.2 Javadoc

org.jivesoftware.messenger.net
Class SSLJiveTrustManagerFactory

java.lang.Object
  extended by org.jivesoftware.messenger.net.SSLJiveTrustManagerFactory

public class SSLJiveTrustManagerFactory
extends Object

A custom TrustManagerFactory that creates a trust manager list using the default trust manager or a standard keystore as specified in jive_config.xml. There is no default trust keystore provided with the Jive distribution as most clients will not need to be authenticated with the server.

The Java Keystore (JKS) takes a single password which must apply to both the keystore and the key itself. Users may specify another keystore type and keystore location. Alternatively, don't set a keystore type to use the JVM defaults and configure your JVMs security files (see your JVM documentation) to plug in any TrustManagerFactory provider.

Author:
Iain Shigeoka

Constructor Summary
SSLJiveTrustManagerFactory()
           
 
Method Summary
static com.sun.net.ssl.TrustManager[] getTrustManagers(String storeType, String truststore, String trustpass)
          Creates a TrustManager list which is null if the storeType is null, or is a standard TrustManager that uses a KeyStore of type storeType, located at 'keystore' location under home, and uses 'keypass' as the password for the keystore password and key password (note that trust managers typically don't need a key password as public keys are stored in the clear and can be obtained without a key password).
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SSLJiveTrustManagerFactory

public SSLJiveTrustManagerFactory()
Method Detail

getTrustManagers

public static com.sun.net.ssl.TrustManager[] getTrustManagers(String storeType,
                                                              String truststore,
                                                              String trustpass)
                                                       throws NoSuchAlgorithmException,
                                                              KeyStoreException,
                                                              IOException,
                                                              CertificateException
Creates a TrustManager list which is null if the storeType is null, or is a standard TrustManager that uses a KeyStore of type storeType, located at 'keystore' location under home, and uses 'keypass' as the password for the keystore password and key password (note that trust managers typically don't need a key password as public keys are stored in the clear and can be obtained without a key password). The default Jive distribution doesn't ship with a trust keystore as it is not needed (the server does not require client authentication).

Parameters:
storeType - The type of keystore (e.g. "JKS") to use or null to indicate no keystore should be used
truststore - The relative location of the keystore under home
trustpass - The password for the keystore and key
Returns:
An array of relevant KeyManagers (may be null indicating a default KeyManager should be created)
Throws:
NoSuchAlgorithmException - If the keystore type doesn't exist (not provided or configured with your JVM)
KeyStoreException - If the keystore is corrupt
IOException - If the keystore could not be located or loaded
CertificateException - If there were no certificates to be loaded or they are invalid

Jive Messenger 2.2.2 Javadoc

Copyright © 1999-2004 Jive Software.