Appendix C. JSTK Tools
The author developed a number of simple command line tools and sample applications in the course of writing this book to explore various Java security capabilities and APIs. The discussion of these tools appears along with the relevant concepts throughout the book, with a suggestion to look at the source code for complete working programs. This appendix provides comprehensive user level documentation on these tools at one place. Hopefully, these tools will prove to be useful to you in better understanding and utilizing the power of the security capabilities inherent in the Java platform.
These tools and applications have been packaged, along with source files and documentation, as an integrated toolkit and given a name—JSTK (Java Security Tool Kit). The directory structure of this package is shown in Figure C-1.
Figure C-1. JSTK installation directory structure.
Follow the steps below to download, install and check successful installation of JSTK on a MS Windows machine.
1. | |
2. |
Get JSTK.
Download the JSTK distribution file, jstk-1_0.zip, from http://www.j2ee-security.net, the companion website to this book. |
3. |
Install.
Unzip the distribution file. One way of doing so is to issue the command "%JAVA_HOME%injar xvf jstk-1_0.zip" in the directory where the downloaded file jstk-1_0.zip is saved. This should create the subdirectory jstk-1.0 and place all source, binary and data files within the appropriate directory tree. This directory is referred to as the JSTK installation or home directory. |
4. |
Build.
This is an optional step and is required only if you modify one or more source files for the JSTK tools. To be able to compile the sources, you must have Apache Ant installed on your machine and its bin directory in the PATH. To perform the build, simply issue the command "ant" from the JSTK installation directory. This command will create the jar file jstk.jar in the build subdirectory. To remove compiled classes and jar files, issue the command "ant clean". |
5. |
Instructions for UNIX and Linux machines are quite similar and can be obtained by performing following substitutions in the above instructions:
Replace %JAVA_HOME% by $JAVA_HOME.
Replace backslash with forward slash in the pathnames.
Add .sh to command file names. For example: crypttool.sh.
The rest of the appendix explains the individual JSTK tools and various commands and options supported by them. As you go through these tools, you will notice that almost all JSTK tools share the following structure: A JSTK tool takes a command and zero or more options as command line arguments. You can get a list of all the commands supported by the tool by specifying help command as in "bincrypttool help". Help on individual commands are obtained by placing help after the command as in "bincrypttool listp help".
It is best to invoke these tools from the JSTK installation directory, specifying the pathname of the script file.