Date: June 2002
Version: 1.3.0

SAS/SECURE Java Component Readme

This archive contains the implementations of four cryptography algorithms -
RC2, RC4, DES, and TripleDES - and additional code that integrates the
implementations into Java clients provided by SAS Institute Inc. This is not
a general purpose cryptography solution. It is only useful when used with
SAS Java Clients.

This readme file discusses how to install and use the contents of this
archive. However, please note that more detailed usage information may be
available in the documetation for the Java clients that use the SAS/SECURE
Java component.


Archive Contents

readme.txt - this file.

sas.rutil.jar - a JAR file containing Java classes that implement the four
            cryptography algorithms and make them available to SAS
            Java clients.


SAS Java Clients that Use the SAS/SECURE Java Component

SAS/CONNECT Driver for Java Version 2.0 (or higher)
SAS/SHARE Driver for JDBC Version 2.0 (or higher)
IOM BRIDGE for Java Version 1.0 (or higher)


Installation Instructions for Windows

Assuming you have expanded this archive into the root directory of your C drive,
include the JAR file in your classpath like so:

set CLASSPATH=%CLASSPATH%;C:\sasecjav\sas.rutil.jar


Installation Instructions for UNIX

Assuming you have expanded this archive into your home directoy,
include the JAR file in your classpath like so:

export CLASSPATH=$CLASSPATH%:$HOME/sasecjav/sas.rutil.jar


Installation instructions for applets

Copy sas.rutil.jar into the directory on your webserver that contains
the HTML file for the applet. Edit the HTML file to add rutil.jar
to the ARCHIVE parameter of the APPLET tag. For example:

<APPLET CODE="MyApplet.class" CODEBASE="." ARCHIVE="myapplet.jar,sas.rutil.jar">
</APPLET>


General Usage Instructions

Please note that more detailed usage information may be available in
the documetation for the Java clients that use the SAS/SECURE Java
component.

When instantiating a SAS Java client, you typically have to provide
parameters in the form of a java.util.Properties object. Once you
have installed sas.rutil.jar as described above, you can instruct the SAS
Java client to use one of the cryptography algorithms implemented
in this archive by including the following name/value pairs in the
java.util.Properties object:

Name                 Value
encryptionPolicy     "required" or "optional"
encryptionAlgorithms "RC2", "RC4", "DES", or "TripleDES"