May 1, 1997 

Welcome to the early access release of the Java Cryptography Extension
package.  Please read this document before using the software.

	1.	Understanding The Export Issues
	2.	Expect Change!
	3.	Send Us Feedback!
	4.	How To Install The JCE
	5. 	Where To Find Documentation


______________________________________________________________________


1.  Understanding the Export Issues

The JCE is available within the U.S. and Canada only.  It may not be
exported outside the U.S. or Canada.  When you downloaded the software
and agreed to the terms of the license, you agreed to comply with all
U.S. laws and regulations concerning export of this software.  Be
aware that if you export this software outside the U.S. or Canada, you
are liable of violating U.S. laws.  For more information on
U.S. encyption policies, refer to these web sites:

	U.S. Dept of Commerce		www.doc.gov
	Export Policy Resource Page	www.crypto.com
	Computer Systems Public Policy  www.cspp.org

Reference sites for more information:

	Bruce Schneier's site		www.counterpane.com
	Gene Spafford's site		www.cs.purdue.edu/coast/coast.html

2.  Expect Change!

The May 1997 release of the Java Cryptography Extension package
is an early access release.  We expect substantial feedback from the
developer community, and we expect to evolve the APIs, the
implementation and the overall content of the JCE, based on your
feedback.  For example, a common question is whether or not we plan to
add other encryption algorithms to the JCE.  The answer is yes, we are
working on other algorithms, such as Diffie-Hellman.  Our web site,
http://java.sun.com/security, is the best place to look for
announcements of changes or enhancements to the JCE.

We encourage everyone to experiment with the software and send us
feedback, but you should expect that the APIs and the implementation
will change between the early access release and the final release.  A final
release date is not yet set.

3.  Send Us Feedback! 

Send feedback to java-security@java.sun.com.  Bug reports with sample
code are highly prized!  

The mailing list java-security@java.sun.com is not a subscription
list.  It is simply a one-way channel that you can use to send
questions to the JavaSoft security group.  A hypermail archive of 
Q & A is online at
http://jeeves.javasoft.com/hypermail/java-security-archive/index.html

Please be aware that we are barred from offering technical support
specifically regarding encryption implementions of the JCE APIs to
people outside the U.S. or Canada, according to U.S. regulations. 

You can also send feedback via ordinary postal mail to 

	JavaSoft Security Group
	Attn:  Li Gong
	JavaSoft
	M/S UCUP02-102
	Sun Microsystems, Inc.
	2550 Garcia Ave.
	Mountain View, CA 94043-1100


4.  How To Install the Java Cryptography Extensions (JCE)

First, download the JCE from http://java.sun.com/products/jdk/1.1/jce.
The simplest method is to save the downloaded file in your JDK base
directory.  You can also save it anywhere on your local hard disk, and
then copy it to your JDK base directory.

Second, invoke the self-extracting archive from your JDK base
directory.

For example, on Solaris, suppose you have JDK 1.1.1 installed in
/usr/java/jdk1.1.1, and you saved the downloaded JCE file in that
directory.  Go to that directory, and run the self-extracting archive.

In a shell window, execute these commands. 

	% chmod a+x jce1.1-ea.sfx
	% ./jce1.1-ea.sfx

On Windows, suppose you have JDK 1.1.1 installed in
C:\usr\java\jdk1.1.1, and that you downloaded the self-extracting
archive to that directory.  Again, go to that directory, and run the
self-extracting archive from there.

	> jce1.1-ea.exe

Once you have installed the JCE, you need to add the zip file to your
CLASSPATH.

On Solaris, 

	% setenv CLASSPATH <your-jdk-directory>/lib/jce.zip

On Windows, 

	% set CLASSPATH=<your-jdk-directory>\lib\jce.zip

The installation guide for JDK explains what the classpath is, and how
it works.  Refer to
http://java.sun.com/products/jdk/1.1/installation-solaris2.html for
Solaris instructions, and to
http://java.sun.com/products/jdk/1.1/installation-win32-x86.html for
Windows instructions.

5.  Where To Find Documentation

Once you have installed JCE, you will be able to read more detailed
information about the software and how to use it.

An overview of the architecture is found in
docs/guide/security/JCESpec.html.

The API documentation is found in docs/jce-api/packages.html.    

For example, if /usr/java/jdk1.1.1 is the name of your jdk1.1.1
installation, you can bring up the JCE API documentation via this URL:

	file:/usr/java/jdk1.1.1/docs/jce-api/packages.html

