#
Novell SecretStore Development Kit for C

1.0 Overview
2.0 What's New
3.0 Documentation
4.0 Prerequisites
4.1 Server Prerequisites
4.2 Workstation Prerequisites
5.0 Sample Code
6.0 Legal Notices

##
1.0 Overview

Novell SecretStoreTM Development Kit for C enables eDirectoryTM authenticated users of software applications, such as single sign-on, to utilize SecretStore, such as single sign-on (a service of eDirectory) to securely store and retrieve secrets using this service. As a result, the user gains automatic access to the secrets stored in SecretStore and, in the case of single sign-on, the enabled applications upon launch can grant access to the user without requiring application level authentication such as prompting for user ID and password.

As a component in the eDirectoryTM infrastructure, the Novell® SecretStoreTM service is designed to securely store sensitive data such as user IDs, passwords, biometrics, and other credentials---all commonly called secrets.

Once secrets are safely stored in eDirectory, single sign-on services (such as Novell SecureLoginTM, Novell iChainTM, and Novell Portal ServicesTM, and third-party applications) can access and use these credentials on behalf of the authenticated user. SecretStore also protects the methods of storing, accessing, and retrieving these secrets.

Novell SecretStore Developer Kit for C (SSOCOMP) provides C functions that enable network applications to securely access user secrets.

##
2.0 What's New

- Fixed an encryption problem in the Advanced Encryption Standard (AES) algorithm on the client and server that caused SecretStore errors on Solaris and AIX.
- SecretStore 3.3.5 or later operating on Windows* has been upgraded by building with the Microsoft* Visual C 7.x compiler (a component of MS Visual Studio .NET 2003).
- To see what was changed in the software, sample code, and documentation since previous releases, see the Novell SecretStore Developer Kit for C Update Log.
- Revised software to coincide with the development of the API functionality.
- To see the specific documentation changes that were made, see the Revision History.

##
3.0 Documentation

We've enabled Start menu documentation entries. After you have installed the documentation, use the "NDK Documents" entry on your Start menu to quickly locate and access NDK documentation.

To read or print the documentation, you need Adobe Acrobat Reader 4.0.

The document in this download was created as a standalone file; therefore, links to files in other downloads will not resolve.

The download includes a single file: ssocomp_enu.pdf in the [install directory]\NDK\doc\ssocomp directory.

##
4.0 Prerequisites

###
4.1 Server Prerequisites

To run the code developed with the NDK, make certain that this product is installed on an available server.

- NetWare 6.x with the latest Support Packs.
- Novell eDirectory 8.7.3 or newer on Windows NT/2000/XP, Linux, Solaris, AIX, or HP-UX server platforms.
- NICI 2.6.7 or newer is required on the target platform for SecretStore client and server to operate.

###
4.2 Workstation Prerequisites

- The Novell SecretStore Developer Kit for C consists of a self-extracting archive (ssocomp.exe) that will extract files to "C:\Novell\Ndk\ssocomp" by default (can be modified to the preferred directory). It is necessary to run SecretStoreClientInstall.exe on Windows from C:\Novell\Ndk\ssocomp\SecStore\Client\Windows\SecretStoreClient or copy "nsss.nlm" and "nssldp.nlm" files from the mentioned directory to a system directory on your target NetWare file sever.
- Copy the server install files from the related platform under C:\Novell\Ndk\ssocomp\SecStore\Server to your target server and follow the instructions in the C:\Novell\Ndk\ssocomp\SecStore\Docs\en\nssadm30.pdf to install and configure your SecretStore server.
- You must set as your primary tree the eDirectory tree containing the user that will store the secrets. To set the tree as the primary tree:
  - Right-click the Network Neighborhood icon.
  - Select NetWare Connections.
  - In the NetWare Connections dialog box, highlight the desired tree and click Set Primary.

##
5.0 Sample Code

To view the available sample code files, see the Novell SecretStore Developer Kit for C Sample Code Page.

##
6.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.