
Steps to configure ITIM utilities with SSL enabled for LDAP Server:

1.  Copy itim_server.jar, itim_api.jar, and api_ejb.jar from <WAS_HOME>/installedApps/<machine_name>/enRole.ear directory
    to <ITIM_HOME>/lib directory prior to doing the next tasks.
    
2.  Update the ITIMs enRoleLDAPConnections.properties file to use SSL.
     
     a. Edit <ITIM_HOME>/data/enRoleLDAPConnection.properties file. 
     b. Set the value of java.naming.security.protocol to ssl. i.e java.naming.security.protocol=ssl. 
        Alternately you can change the protocol in java.naming.provider.url from ldap to ldaps i.e 
        java.naming.provider.url=ldaps://localhost:636.
     c. Set the port in java.naming.provider.url to SSL port. i.e.
        java.naming.provider.url=ldap://localhost:<SSL port>
     d. Save the changes.
    
3. To execute ldapConfig, ldapUpdate and test directory connection during runConfig.
    
     a. Verify that enRoleLDAPConnections.properties, has java.naming.security.protocol set to ssl 
     b. If the CA certificate ( which is required to verify the authenticity of authority 
        that  has issued a LDAP server certificate) is installed in the trustStore of the 
        JVM  that is used by ldapConfig/runConfig, skip this step.
     
        - Edit <ITIM_HOME>/bin/ldapConfig.lax and <ITIM_HOME>/bin/runConfig.lax.
           Add the following property:-
                lax.nl.java.option.additional=-Djavax.net.ssl.trustStore=<trustStore location>-
                Djava.net.ssl.trustStorePassword=<trust store password if changed>- 
                Djavax.net.ssl.keyStore=<keyStore location>-
                Djavax.net.ssl.keyStorePassword=<KeyStore password if changed>
                
        All the properties need not be specified. Please refer the description of each 
        of the four properties listed below:

4. To execute ITIM utilities that access LDAP Server.

        The following utilities :-
         addindex
         addintegrity
         config_remote_services
         createLinks
         ldapClean
         remove_service_profiles
         serviceability
         present in <ITIM_HOME>/bin/<platform>, folder access LDAP. 
      
 Perform the following steps to execute above utilities, when SSL is configured:
     a.  Open the respective file (e.g. addindex.sh or addindex.cmd) in any editor.            
     b.  Specify appropriate security certificate location and password as java command line options. Please refer
         the description of each of the four properties listed below:-

         For example, to specify the trustStore location in addindex.cmd, modify the last line as  set CMD="%JAVA_HOME%\bin\java" -Djavax.net.ssl.trustStore=c:\Progra~1\WebSphere\AppServer\java\jre\lib\security\cacerts -cp "%CLASSPATH%" %EXEC% 
     c.  Save the file.
  
 Replace the following files to execute loadDSMLSchema utility :- 
         <ITIM_HOME>/bin/win/loadDSMLSchema.cmd  for Windows.
         <ITIM_HOME>/bin/unix/loadDSMLSchema.sh  for Unix

 Properties Description:- 

 1. Property Name
    javax.net.ssl.trustStore.
    
    Description:-
    File path of the truststore file. You can use the truststore to install CA certificates and client certificates. If
    you do not use javax.net.ssl.keyStore to specify a client certificate, you must use this truststore.        
        
    Default Value:-
    jre_install_dir\lib\security\cacertsExample: c:\ProgramFiles\WebSphere\AppServer\java\jre\lib\security\cacerts
        
     
 2. Property Name:-
    javax.net.ssl.trustStorePassword.
    
    Description:-
    Password that protects thetruststore.
    
    Default Value:-
    changeit (This is the defaultpassword for the JVM defaulttruststore.)
    
 3. Property Name:-
    javax.net.ssl.keyStore.
    
    Description:-
    File path of the keystore file. The keystore contains the certificate used by the Tivoli Identity Manager Server. The
    certificate must be present either in the keystore or thetruststore if the applicationoperating as an SSL server (for
    example, an ADK-based adapter) is set to require client authentication. If this property is not defined, the
    truststore must contain the certificate when client authentication is required.     

    Default Value:-
    None. The truststore file path is searched by default.
    
 4. Property Name:-
    javax.net.ssl.keyStorePassword      

    Description:-
    Password that protects the keystore.

    Default Value:-
    changeit (This is the defaultpassword for the JVM defaultkeystore.)