Novell.Directory.Ldap.NETStandard 使用教程

2024-09-14 13:31:32作者：齐冠琰

Novell.Directory.Ldap.NETStandard

.NET LDAP client library for .NET Standard >= 2.0, .NET Core >=1.0, NET5/NET6/NET7/NET8 - works with any LDAP protocol compatible directory server (including Microsoft Active Directory).

项目地址：https://gitcode.com/gh_mirrors/no/Novell.Directory.Ldap.NETStandard

1. 项目介绍

1.1 项目概述

Novell.Directory.Ldap.NETStandard 是一个基于 .NET Standard 的 LDAP 客户端库，适用于 .NET Core、.NET Framework 和其他支持 .NET Standard 的平台。该项目允许开发者通过 LDAP 协议与任何兼容的目录服务器（包括 Microsoft Active Directory）进行交互。

1.2 项目背景

该库最初来源于 Novell 的 LDAP 库，经过多次迭代和改进，现已支持 .NET Standard 2.0 及以上版本。它不仅保留了原始库的功能，还增加了对现代 .NET 平台的支持，使其在跨平台开发中表现出色。

1.3 主要功能

支持 LDAP v3 协议
兼容多种目录服务器，包括 Microsoft Active Directory
提供丰富的 API 用于连接、查询、修改和删除 LDAP 条目
支持多线程操作，适用于高并发场景

2. 项目快速启动

2.1 环境准备

确保你已经安装了以下环境：

.NET Core SDK 2.0 或更高版本
支持 .NET Standard 2.0 的开发环境（如 Visual Studio 或 Visual Studio Code）

2.2 安装依赖

通过 NuGet 安装 Novell.Directory.Ldap.NETStandard 包：

dotnet add package Novell.Directory.Ldap.NETStandard --version 3.6.0

2.3 基本使用示例

以下是一个简单的示例，展示如何使用 Novell.Directory.Ldap.NETStandard 连接到 LDAP 服务器并进行用户认证。

using System;
using Novell.Directory.Ldap;

class Program
{
    static void Main(string[] args)
    {
        string host = "ldap.example.com";
        int port = 389;
        string userDn = "cn=admin,dc=example,dc=com";
        string password = "adminpassword";

        try
        {
            using (var connection = new LdapConnection())
            {
                // 连接到 LDAP 服务器
                connection.Connect(host, port);

                // 绑定用户
                connection.Bind(userDn, password);

                // 检查绑定是否成功
                if (connection.Bound)
                {
                    Console.WriteLine("成功绑定到 LDAP 服务器");
                }
                else
                {
                    Console.WriteLine("绑定失败");
                }
            }
        }
        catch (LdapException e)
        {
            Console.WriteLine($"LDAP 错误: {e.Message}");
        }
        catch (Exception e)
        {
            Console.WriteLine($"一般错误: {e.Message}");
        }
    }
}