Novell SecretStore Command Beans

1.0 Introduction
2.0 What's New
3.0 Documentation
4.0 Bean Dependencies
5.0 CLASSPATH Variable
6.0 Sample Programs
6.1 Running the Sample Programs on a NetWare 6.0 Server
6.2 Running the Sample Programs on a NetWare 6.5 Server
7.0 Legal Notices

1.0 Introduction

The Novell SecretStore Command Beans provide easy to use Java components to integrate Web applications with the Novell SecretStore for single sign-on capability. These components enable management and usage of the SecretStore over the Web with features such as creating enhanced protected Secrets, repairing, and unlocking the SecretStore.

Novell provides the following SecretStore components:

The SecretStore beans are mainly meant for the application developers, to create single sign-on enabled applications and tools for SecretStore management.

The Novell Developer Web site provides information about the updates to the JavaBeans. Visit this site to download new beans and view updated versions of the documentation and component features.


2.0 What's New


3.0 Documentation

After you have installed the documentation, use the NDK Documents entry on your Start menu to quickly locate and access NDK documentation.

The documentation for the beans consists of html files and graphics files in several different directories.

To view the documentation, locate the index.html file in the install directory\doc directory and open that file in your Web browser.


4.0 Bean Dependencies

For all beans, the following are required:


5.0 CLASSPATH Variable

Add the following libraries to your CLASSPATH:

Add the following LDAP Command Beans libraries to the CLASSPATH.

Add the Novell SecretStore Developer Kit for Java library - jsso.jar, to the CLASSPATH.


6.0 Sample Programs

Sample programs are provided to demonstrate the usage of the beans in JSPs. They are bundled with the software package. By default, the SecretStore Command Beans samples are copied to c:\novell\ndk\samples\beans\bns_sscmd_sample directory.


6.1 Running the Sample Programs on a NetWare 6.0 Server

  1. Copy the bns_sscmd_sample directory from the installed location to tomcat_home\webapps directory on the NetWare server.

    NOTE:  tomcat_home is the directory in which Apache Tomcat is installed.

  2. Copy the jar files, ecb.jar, ecbldap.jar, ecbss.jar, and jsso.jar listed in the section 5.0 CLASSPATH Variable to tomcat_home\webapps\bns_sscmd_sample\WEB-INF\lib directory.

  3. Restart Tomcat server to save the settings.

  4. To run the sample from the Web browser, use the following URL:

    http://server_name:8080/bns_sscmd_sample


6.2 Running the Sample Programs on a NetWare 6.5 Server

  1. Copy the bns_sscmd_sample directory from the installed location to tomcat_home\webapps directory on the NetWare server.

    NOTE:  tomcat_home is the directory in which Apache Tomcat is installed.

  2. Copy the jar files, ecb.jar, ecbldap.jar, ecbss.jar, and jsso.jar listed in the section 5.0 CLASSPATH Variable to tomcat_home\webapps\bns_sscmd_sample\WEB-INF\lib directory.

  3. Create a configuration file similar to beans-apache.conf provided under tomcat_home\conf directory and replace all occurrences of /ecb by /bns_sscmd_sample.

  4. Add an Include statement for your new configuration file at the end of Apache conf file, httpd.conf found in apache_home\conf directory, e.g.Include sys:/tomcat/4/conf/beans-Apache.conf. This step makes Apache aware of this application.

    NOTE:  Apache_home is the directory where Apache is installed.

  5. Restart Tomcat server to save the settings.

  6. To run the sample from the Web browser, use the following URL:

    http://server_name:/bns_sscmd_sample


7.0 Legal Notices

Novell, Inc. makes no representations or warranties with respect to the contents or use of this documentation, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to revise this publication and to make changes to its content, at any time, without obligation to notify any person or entity of such revisions or changes.

Further, Novell, Inc. makes no representations or warranties with respect to any software, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to make changes to any and all parts of Novell software, at any time, without any obligation to notify any person or entity of such changes.

You may not export or re-export this product in violation of any applicable laws or regulations including, without limitation, U.S. export regulations or the laws of the country in which you reside.

All files provided in this release are subject to the Novell Developer Kit license Agreement and Separate Limited Warranty, which can be found in the license.txt file provided in this download.

Copyright © 2003-2004 Novell, Inc. All rights reserved. No part of this publication may be reproduced, photocopied, stored on a retrieval system, or transmitted without the express written consent of the publisher.

Novell is a registered trademark of Novell, Inc. in the United States and other countries.

All third-party products are the property of their respective owners.