Index of /pub/mirrors/ftp.novell.com/forge/ldapcsharp

 Name                               Last modified      Size  Description
 Parent Directory                                        -   
 CHANGELOG.html                     03-Mar-2005 18:32  5.2K  
 DOCUMENTATION.html                 10-Feb-2005 00:00  132   
 README.html                        31-Mar-2005 22:56   20K  
 SAMPLECODE.html                    10-Feb-2005 00:00  132   
 docs/                              27-Aug-2008 01:56    -   
 ldapcsharp/                        27-Aug-2008 01:56    -

LDAP Libraries for C#

1.0 LDAP Libraries for C#

2.0 Dependencies

3.0 Installation

4.0 LDAPv2 and LDAPv3 Support

5.0 LDAP Controls

6.0 LDAP Extensions

7.0 Known Issues and Solutions

8.0 Revision History

8.1 Changes for the June 2004 NDK

8.1.1 New Functionality

8.1.2 New Sample Code

8.2 Changes for the February 2004 NDK

9.0 Legal Notices

1.0 LDAP Libraries for C#

The LDAP Libraries for C# enables you to write applications that access, manage, and update information stored in Novell eDirectory or other LDAP compliant directories.

2.0 Dependencies

You will need the following to take full advantage of the functionality offered in the classes:

Novell eDirectory 8.5 or higher to develop or run applications using the extensions for naming context and replica management.
For Windows:
To use Novell.Directroy.Ldap on the Windows OS, you need to setup your Microsoft .NET project using Novell.Directory.Ldap.

You need the Mono Security Library (Mono.Security.dll).
For Linux:
To use Novell.Directroy.Ldap on Linux, you need to have Mono (compiler, runtime and class libraries) installed on your Linux box. You can download mono from http://www.go-mono.com/download.html.

3.0 Installation

Download Novell.Directory.Ldap and install it.

To use Novell.Directory.Ldap, do the following on Windows:

Copy Novell.Directory.Ldap.dll to an appropriate location in your project
Start Visual Studio .NET
Select File > New > Project
In the Project Type column, select the project type to create C#
In the Template column, select a project template (like Console Application, Windows Application)
Name your project
Click OK to create your new project
Select Project > Add reference > Browse
In Browse select Novell.Directory.Ldap.dll from the location you copied in Step1.
Click OK to Add Reference.
Add the following line to your code:

Using Novell.Directory.Ldap;

To use Novell.Directory.Ldap on Linux, do the following:

Copy Novell.Directory.Ldap.dll to an appropriate location in your project.
Set directory containing Novell.Directory.Ldap.dll in your MONO_PATH variable as follows:
In your project makefile set reference to Novell.Directory.Ldap.dll using

/r:/home/project/lib/Novell.Directory.Ldap.dll
Add the following line to your code:

Using Novell.Directory.Ldap;

4.0 LDAPv2 and LDAPv3 Support

This version of the LDAP Libraries for C# supports mainly LDAPv3. Since the consensus in the LDAP community is to encourage everyone to update to LDAPv3, Novell has not made a commitment to ensure that these libraries support LDAPv2 servers.

5.0 LDAP Controls

LDAP servers may support controls. Query the root DSE to get a list of supported controls.

The LDAP Libraries for C# supply methods to help applications use supported controls.

6.0 LDAP Extensions

eDirectory 8.5 supports the following LDAP extensions for obtaining effective rights, managing replicas and partitions, and refreshing the LDAP server:

2.16.840.1.113719.1.27.100.1   Nds To Ldap Response 
2.16.840.1.113719.1.27.100.2   Nds To Ldap Request 
2.16.840.1.113719.1.27.100.3   Split Partition Request 
2.16.840.1.113719.1.27.100.4   Split Partition Response 
2.16.840.1.113719.1.27.100.5   Merge Partition Request 
2.16.840.1.113719.1.27.100.6   Merge Partition Response 
2.16.840.1.113719.1.27.100.7   Add Replica Request 
2.16.840.1.113719.1.27.100.8   Add Replica Response 
2.16.840.1.113719.1.27.100.9   Refresh Server Request 
 
2.16.840.1.113719.1.27.100.10  Refresh Server Response 
2.16.840.1.113719.1.27.100.11  Remove Replica Request 
2.16.840.1.113719.1.27.100.12  Remove Replica Response 
2.16.840.1.113719.1.27.100.13  Partition Entry Count Request 
2.16.840.1.113719.1.27.100.14  Partition Entry Count Response 
2.16.840.1.113719.1.27.100.15  Change Replica Type Request 
2.16.840.1.113719.1.27.100.16  Change Replica Type Response 
2.16.840.1.113719.1.27.100.17  Get Replica Info Request 
2.16.840.1.113719.1.27.100.18  Get Replica Info Response 
2.16.840.1.113719.1.27.100.19  List Replica Request 
2.16.840.1.113719.1.27.100.20  List Replica Response 
2.16.840.1.113719.1.27.100.21  Receive All Updates Request 
2.16.840.1.113719.1.27.100.22  Receive All Updates Response 
2.16.840.1.113719.1.27.100.23  Send All Updates Request 
2.16.840.1.113719.1.27.100.24  Send All Updates Response 
2.16.840.1.113719.1.27.100.25  Request Partition Sync Request 
2.16.840.1.113719.1.27.100.26  Request Partition Sync Response 
2.16.840.1.113719.1.27.100.27  Request Schema Sync Request 
2.16.840.1.113719.1.27.100.28  Request Schema Sync Response 
2.16.840.1.113719.1.27.100.29  Abort Partition Operation Request 
2.16.840.1.113719.1.27.100.30  Abort Partition Operation Response

2.16.840.1.113719.1.27.100.31  Get Bind DN Request 
2.16.840.1.113719.1.27.100.32  Get Bind DN Response 
2.16.840.1.113719.1.27.100.33  Get Effective Privileges Request 
2.16.840.1.113719.1.27.100.34  Get Effective Privileges Response 
2.16.840.1.113719.1.27.100.35  Set Replication Filter Request 
2.16.840.1.113719.1.27.100.36  Set Replication Filter Response 
2.16.840.1.113719.1.27.100.37  Get Replication Filter Request 
2.16.840.1.113719.1.27.100.38  Get Replication Filter Response 
2.16.840.1.113719.1.27.100.39  Create Orphan Partition Request 
2.16.840.1.113719.1.27.100.40  Create Orphan Partition Response 
2.16.840.1.113719.1.27.100.41  Remove Orphan Partition Request 
2.16.840.1.113719.1.27.100.42  Remove Orphan Partition Response

Extensions to trigger NDS background processes:

2.16.840.1.113719.1.27.100.43  Trigger Backlinker Request 
2.16.840.1.113719.1.27.100.44  Trigger Backlinker Response 
2.16.840.1.113719.1.27.100.47  Trigger Janitor Request 
2.16.840.1.113719.1.27.100.48  Trigger Janitor Response 
2.16.840.1.113719.1.27.100.49  Trigger Limber Request 
2.16.840.1.113719.1.27.100.50  Trigger Limber Response 
2.16.840.1.113719.1.27.100.51  Trigger Skulker Request 
2.16.840.1.113719.1.27.100.52  Trigger Skulker Response 
2.16.840.1.113719.1.27.100.53  Trigger Schema Synch Request 
2.16.840.1.113719.1.27.100.54  Trigger Schema Synch Response 
2.16.840.1.113719.1.27.100.55  Trigger Partition Purge Request 
2.16.840.1.113719.1.27.100.56  Trigger Partition Purge Response

Extensions for eDirectory events. These extensions are considered "early access" and are not yet supported.

2.16.840.1.113719.1.27.100.79  Monitor Events Request 
2.16.840.1.113719.1.27.100.80  Monitor Events Response 
2.16.840.1.113719.1.27.100.81  Event Notification

To use any of these Novell extensions, the LDAP server must be running on eDirectory version 8.5 or higher.

To obtain a copy, see Novell's download site:

http://www.novell.com/download/

The LDAP Libraries for C# includes functions to help applications use these extensions.

If you have an early beta version of eDirectory 8.5, be aware that the OIDs for the extensions changed in beta 5.

The Novell Import Convert Export utility uses the following extensions. These are not general extensions designed for developer use, but are designed to support the LDAP Bulk Update Replication Protocol (LBURP).

2.16.840.1.113719.1.142.100.1 startFramedProtocolRequest 
2.16.840.1.113719.1.142.100.2 startFramedProtocolResponse 
2.16.840.1.113719.1.142.100.4 endFramedProtocolRequest 
2.16.840.1.113719.1.142.100.5 endFramedProtocolResponse 
2.16.840.1.113719.1.142.100.6 lburpOperationRequest 
2.16.840.1.113719.1.142.100.7 lburpOperationResponse

7.0 Known Issues and Solutions

SSL based operations may not work on Windows due to some issues with the Mono.Security.dll. This works fine on Linux.

8.0 Revision History

8.1 Changes for the June 2004 NDK

8.1.1 New Functionality

Support for SSL/TLS
Support to dynamically register an extendedOperation Response which will enable external an developer to write their own extension and plug it into the dll.

8.1.2 New Sample Code

Sample programs demonstrating the use of new and existing APIs.

8.2 Changes for the February 2004 NDK

Initial release.

9.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.

Copyright ^© 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 trademarks are the property of their respective owners.