JCSI - Installation

These are the steps required to configure the Java development and deployment environment to use the JCSI security provider classes and com.dstc.security.* packages.

Step 1.   Configure the environment variables:
$JCSI Directory where JCSI has been installed.  
[eg. C:\JCSI (Windows)  or   /usr/local/jcsi (Unix) ]
$JAVAHOME JDK/JRE 1.2.x or 1.3.x root directory
Step 2. 

Copy the $JCSI/lib/*.jar files into the $JAVAHOME/jre/lib/ext directory.
The $JAVAHOME/jre/lib/ext directory may need to be created if it does not already exist. 

Step 3a. 

Edit $JAVAHOME/jre/lib/security/java.security and add the JCSI security providers in the following sequence: 

#
# List of providers and their preference orders (see above):
security.provider.1=sun.security.provider.Sun

# DSTC Providers
security.provider.2=com.dstc.security.provider.DSTC
security.provider.3=com.dstc.security.keymanage.keystore.DSTC
security.provider.4=com.dstc.security.x509.DSTC

Note that the base Sun provider sun.security.provider.Sun is preserved.

JDK/JRE 1.3.x also includes the new provider com.sun.rsajca.Provider.  
If you include the rsajca provider we suggest you place it after the jcsi to avoid a bug in the rsajca provider

Step 3b. Edit $JAVAHOME/jre/lib/security/java.security to change the default keystore format from "jks" to "pkcs12":
#
# Default keystore type.
#
# keystore.type=jks
keystore.type=pkcs12