JCSI - Installation for Examples

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 Java JDK1.2.x or 1.3.x root directory.
Step 2. 

Copy the $JCSI/lib/*.jar files into $JAVAHOME/jre/lib/ext .
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 1.3.x also includes the new provider com.sun.rsajca.Provider.  
If you include this you will need to renumber the JCSI properties to security.provider.3 ... security.provider.5

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