Configuring Security Provider Classes

How to:

iWay Service Manager is certified to run with JVM Versions 1.4 or 1.3, which require the installation of several Security Provider classes provided through Java archive (.jar) files on your system.

JVM Version

Java Archive (jar) Files Required

1.4

bcmail-jdk14-128.jar

bcprov-jdk14-128.jar

local_policy.jar

us_export_policy.jar

Note: Download local_policy.jar and us_export_policy.jar from Java.Sun.com.

1.3

bcmail-jdk13-128.jar

bcprov-jdk13-128.jar

jce-jdk13-128.jar

Download the remaining .jar files for your release from

ftp://ftp.bouncycastle.org/pub/release1.28

and register them in the Java Library Files PreClassPath section.



x
Procedure: How to Add Java Libraries on Windows
  1. Open the iWay Service Manager Administration Console.
  2. Click Server in the top pane, then click Path Settings in the Settings section.

    The Path Settings pane opens.

    Here you can register additional Java classes and libraries for PreClassPath or PostClassPath destinations.

  3. Provide the location of the security provider required client file, for example, a bouncy castle .jar file, in the PreClassPath or PostClassPath field.
  4. Click Add.
  5. Repeat the previous steps for each required file you want to add.
  6. You must completely stop iWay Service Manager, and then restart it, for class path entries to take effect.

Top of page

x
Procedure: How to Add Java Libraries on UNIX

To register libraries or other files on UNIX, edit the script used to start iWay Service Manager and add files to the CLASSPATH variable. Be sure to add the full path including the file name.

If you run iWay Service Manager as a service (daemon), edit iWay61/bin/startservice.sh.

If you run iWay Service Manager as a non-service, edit iWay61/iWay61sm.sh.

  1. Open startservice.sh or iWay61sm.sh in a text editor and find the CLASSPATH lines. The relevant lines are the same in both startservice.sh and iWay61sm.sh:
    CLASSPATH='echo $IWAY61/lib/*.jar | tr ' ' ':' 
    if [ -f $IWAY61/etc/manager/extensions/*.jar ]
    then
            CLASSPATH=$CLASSPATH:'echo
    $IWAY61/etc/manager/extensions/*.jar | tr ' ' ':'`
    fi
    echo CLASSPATH set to: $CLASSPATH
  2. On the first CLASSPATH line, add the path to any files (including the file name), you wish to register and separate the files using a colon.

    To load files before any iWay files, add the files you are registering after CLASSPATH= and place a colon after each file.

    CLASSPATH=/home/myjars/broker.jar:/home/myjars/jsse.jar:'echo
    $IWAY61/lib/*.jar | tr ' ' ':''

    To load files after any iWay files, add a colon at the end of the line, followed by the path to the files you wish to register, separated by colons.

    CLASSPATH='echo $IWAY61/lib/*.jar | tr ' '
    ':'':/home/myjars/broker.jar:/home/myjars/jsse.jar

    Note: Be sure to add the full path to the files, including the file names. Adding the directory containing the files is not sufficient.


iWay Software