Novell SecretStore Developer Kit for Java

1.0 Introduction
2.0 What's New
3.0 Installing the SDK
3.1 Documentation
3.2 Sample Code
4.0 Component Installation
4.1 Java CLASSPATHS
4.2 JSSO Core Installation
5.0 Legal Notices


1.0 Introduction

Novell SecretStore Developer Kit for Java service provides the ability for applications to gain single sign-On access based on the user's authenticated NDS connection. As a result, the user gains automatic access to the enabled applications once those applications are launched, rather than having to type additional passwords or present other credentials.

The Novell SecretStore Development Kit for Java (JSSO) library provides Java classes that enable network applications to securely access user authentication information. The JSSO library comprises one .jar file (jsso.jar) that is logically split into two sections: the API and two implementations (NCP and JNDI). Additional implementations may be added in the future.


2.0 What's New


3.0 Installing the SDK

The Novell Developer Kit provides the following JSSO components: software, documentation, and sample code. These components may be downloaded together or separately at Novell SecretStore Developer Kit for Java.

To install the NSSOJ components, follow these steps:

  1. Click on the InstallShield Wizard button for the desired component (software, documentation, sample code, or all).

  2. Choose "Install now," "Install now and save setup files," or "Download only" then click "Next." If you chose "Install now and save setup files" or "Download only," you will be prompted for the location to store the downloaded files.

  3. If you chose "Install now" or "Install now and save setup files," the component installation will then begin automatically. If you chose "Download only," then you must execute the file setup.exe, found in the directory you specified in the previous step.

  4. Complete the NDK installation wizard. At one point you must select the destination where you want to install the NSSOJ components (the default is C:\Novell).


3.1 Documentation

The documentation for the Novell SecretStore Developer Kit for Java is installed to [install location]\ndk\doc\nssoj\ssoj_enu.

After you have installed the documentation, you can view it by clicking the "Novell SecretStore Developer Kit for Java" entry under the "NDK Documents" item on your Start menu.


3.2 Sample Code

The sample code delivered with Novell SecretStore Developer Kit for Java is installed in [install location]\NDK\samples\nssoj_sample.


4.0 Component Installation

The installation depends on which implementation of JSSO is used. The installation entails the core installation in addition to the installation for the implementation.


4.1 Java CLASSPATHS

For the September 2002 NDK release, the resulting install directory structure was changed slightly. If you previously installed this component, you will need to update your CLASSPATH.

The new directory structure will be similar to c:\novell\ndk\nssoj.


4.2 JSSO Core Installation

In order to setup a SSL connection with eDirectory (the LDAP server where SecretStore resides) it is required to place the Trusted Root Certificate of the server in the trust store that can be used by the JSSE when it seeks to establish this connection.

The server's Trusted Root Certificate may be exported by using ConsoleOne, an administration tool that Novell provides. The certificate may be imported into the trust store by using keytool, a program provided by Sun Microsystems that is shipped with the JDK. See Sun Microsystems' documentation on how to create a trust store and how to import a Trusted Root Certificate.

See the documentation on the Novell Web site for information on how to export a Trusted Root Certificate.


5.0 Legal Notices

Novell, Inc. makes no representations or warranties with respect to the contents or use of this download, 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 use, 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 License Agreement, which can be found in the license.txt file provided in this download.

Copyright © 2005 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.

AppNotes is a registered trademark of Novell, Inc.

AppTester is a registered trademark of Novell, Inc. in the United States.

ASM is a trademark of Novell, Inc.

BorderManager is a registered trademark of Novell, Inc.

BrainShare is a registered service mark of Novell, Inc. in the United States and other countries.

C3PO is a trademark of Novell, Inc.

Certified Novell Engineer is a service mark of Novell, Inc.

Client32 is a trademark of Novell, Inc.

CNE is a registered service mark of Novell, Inc.

ConsoleOne is a registered trademark of Novell, Inc.

Controlled Access Printer is a trademark of Novell, Inc.

Custom 3rd-Party Object is a trademark of Novell, Inc.

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

DirXML is a registered trademark of Novell, Inc.

eDirectory is a trademark of Novell, Inc.

Excelerator is a trademark of Novell, Inc.

exteNd is a trademark of Novell, Inc.

exteNd Director is a trademark of Novell, Inc.

exteNd Workbench is a trademark of Novell, Inc.

FAN-OUT FAILOVER is a trademark of Novell, Inc.

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

Hardware Specific Module is a trademark of Novell, Inc.

Hot Fix is a trademark of Novell, Inc.

iChain is a registered trademark of Novell, Inc.

Internetwork Packet Exchange is a trademark of Novell, Inc.

IPX is a trademark of Novell, Inc.

IPX/SPX is a trademark of Novell, Inc.

jBroker is a trademark of Novell, Inc.

Link Support Layer is a trademark of Novell, Inc.

LSL is a trademark of Novell, Inc.

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

Mirrored Server Link is a trademark of Novell, Inc.

Mono is a registered trademark of Novell, Inc.

MSL is a trademark of Novell, Inc.

My World is a registered trademark of Novell, Inc. in the United States.

NCP is a trademark of Novell, Inc.

NDPS is a registered trademark of Novell, Inc.

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

NDS Manager is a trademark of Novell, Inc.

NE2000 is a trademark of Novell, Inc.

NetMail is a registered trademark of Novell, Inc.

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

NetWare/IP is a trademark of Novell, Inc.

NetWare Core Protocol is a trademark of Novell, Inc.

NetWare Loadable Module is a trademark of Novell, Inc.

NetWare Management Portal is a trademark of Novell, Inc.

NetWare Name Service is a trademark of Novell, Inc.

NetWare Peripheral Architecture is a trademark of Novell, Inc.

NetWare Requester is a trademark of Novell, Inc.

NetWare SFT and NetWare SFT III are trademarks of Novell, Inc.

NetWare SQL is a trademark of Novell, Inc.

NetWire is a registered service mark of Novell, Inc. in the United States and other countries.

NLM is a trademark of Novell, Inc.

NMAS is a trademark of Novell, Inc.

NMS is a trademark of Novell, Inc.

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

Novell Application Launcher is a trademark of Novell, Inc.

Novell Authorized Service Center is a service mark of Novell, Inc.

Novell Certificate Server is a trademark of Novell, Inc.

Novell Client is a trademark of Novell, Inc.

Novell Cluster Services is a trademark of Novell, Inc.

Novell Directory Services is a registered trademark of Novell, Inc.

Novell Distributed Print Services is a trademark of Novell, Inc.

Novell iFolder is a registered trademark of Novell, Inc.

Novell Labs is a trademark of Novell, Inc.

Novell SecretStore is a registered trademark of Novell, Inc.

Novell Security Attributes is a trademark of Novell, Inc.

Novell Storage Services is a trademark of Novell, Inc.

Novell, Yes, Tested & Approved logo is a trademark of Novell, Inc.

Nsure is a registered trademark of Novell, Inc.

Nterprise is a trademark of Novell, Inc.

Nterprise Branch Office is a trademark of Novell, Inc.

ODI is a trademark of Novell, Inc.

Open Data-Link Interface is a trademark of Novell, Inc.

Packet Burst is a trademark of Novell, Inc.

PartnerNet is a registered service mark of Novell, Inc. in the United States and other countries.

Printer Agent is a trademark of Novell, Inc.

QuickFinder is a trademark of Novell, Inc.

Red Box is a trademark of Novell, Inc.

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

Sequenced Packet Exchange is a trademark of Novell, Inc.

SFT and SFT III are trademarks of Novell, Inc.

SPX is a trademark of Novell, Inc.

Storage Management Services is a trademark of Novell, Inc.

SUSE is a registered trademark of SUSE AG, a Novell business.

System V is a trademark of Novell, Inc.

Topology Specific Module is a trademark of Novell, Inc.

Transaction Tracking System is a trademark of Novell, Inc.

TSM is a trademark of Novell, Inc.

TTS is a trademark of Novell, Inc.

Universal Component System is a registered trademark of Novell, Inc.

Virtual Loadable Module is a trademark of Novell, Inc.

VLM is a trademark of Novell, Inc.

Yes Certified is a trademark of Novell, Inc.

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

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