C#操作Active Directory(AD)详解

1. LDAP简介

　　LDAP（轻量级目录访问协议，Lightweight Directory Access Protocol)是实现提供被称为目录服务的信息服务。目录服务是一种特殊的数据库系统，其专门针对读取，浏览和搜索操作进行了特定的优化。目录一般用来包含描述性的，基于属性的信息并支持精细复杂的过滤能力。目录一般不支持通用数据库针对大量更新操作操作需要的复杂的事务管理或回卷策略。而目录服务的更新则一般都非常简单。这种目录可以存储包括个人信息、web链结、jpeg图像等各种信息。为了访问存储在目录中的信息，就需要使用运行在TCP/IP 之上的访问协议—LDAP。

　　LDAP目录中的信息是是按照树型结构组织，具体信息存储在条目(entry)的数据结构中。条目相当于关系数据库中表的记录；条目是具有区别名DN （Distinguished Name）的属性（Attribute），DN是用来引用条目的，DN相当于关系数据库表中的关键字（Primary Key）。属性由类型（Type）和一个或多个值（Values）组成，相当于关系数据库中的字段（Field）由字段名和数据类型组成，只是为了方便检索的需要，LDAP中的Type可以有多个Value，而不是关系数据库中为降低数据的冗余性要求实现的各个域必须是不相关的。LDAP中条目的组织一般按照地理位置和组织关系进行组织，非常的直观。LDAP把数据存放在文件中，为提高效率可以使用基于索引的文件数据库，而不是关系数据库。类型的一个例子就是mail，其值将是一个电子邮件地址。

LDAP的信息是以树型结构存储的，在树根一般定义国家(c=CN)或域名(dc=com)，在其下则往往定义一个或多个组织 (organization)(o=Acme)或组织单元(organizational units) (ou=People)。一个组织单元可能包含诸如所有雇员、大楼内的所有打印机等信息。此外，LDAP支持对条目能够和必须支持哪些属性进行控制，这是有一个特殊的称为对象类别(objectClass)的属性来实现的。该属性的值决定了该条目必须遵循的一些规则，其规定了该条目能够及至少应该包含哪些属性。例如：inetorgPerson对象类需要支持sn(surname)和cn(common name)属性，但也可以包含可选的如邮件，电话号码等属性。

2. LDAP简称对应

  1. o– organization（组织-公司）
  2. ou – organization unit（组织单元-部门）
  3. c - countryName（国家）
  4. dc - domainComponent（域名）
  5. sn – suer name（真实名称）
  6. cn - common name（常用名称）

3.常见的目录服务软件

    • X.500
    • LDAP
    • Actrive Directory，Microsoft公司
    • NIS

4.AD介绍

.Net提供了专用类操作AD，本文详细介绍使用C#操作AD的方法。

一、系统环境

系统环境：Windows Server 2008 R2, VS2010, .Net Framework 4.0

AD Server：LDAP的server IP

基本DN：OU=user，DC=Company，DC=com

用来登录的管理员：Peter

密码：ab#CD%1234

二、程序

1．  引用

.Net操作AD的类在命名空间System.DirectoryServices下，需要将该类引用进来。

2．  连接

要操作AD需首先连接AD，就象要操作数据先要连接数据库一样。

其中ADPath是要查询组织单元的所在的LDAP，其格式为：LDAP:\\ OU=XX部门，OU=XX公司，DC=域名，DC=COM，如果连接到的AD是在服务器上那么格式写成LDAP:\\XX.XX.XX.XX\ OU=XX部门，OU=XX公司，DC=域名，DC=COM（XX.XX.XX.XX为服务器IP）；ADAccount和ADPwd为AD用户的账户和密码，如果是管理员则可以进行任何操作，普通只能进行查询操作。

　　　　 de.Path = "LDAP://AD服务器地址/OU=CompanyA,DC=contoso,DC=com";
　　　　 de.Username = @"contoso\管理员账号";
 　　　　de.Password = "管理员密码";
　　　   private static string DomainName = "VMEX";
        private static string LDAPDomain = "DC=VMEX,DC=local";
        private static string ADPath = "LDAP://DC=VMEX,DC=local";
        //AD管理员帐号
        private static string ADUser = "Administrator";
        //AD管理员密码
        private static string ADPasssWord = "[email protected]";
/// <summary>
        /// 获得DirectoryEntry对象实例,以管理员登陆AD
        /// </summary>
        /// <returns></returns>
        private static DirectoryEntry GetDirectoryObject()
        {
            DirectoryEntry entry = null;
            try
            {
                entry = new DirectoryEntry("LDAP://10.10.10.16", "Peter", " ab#CD%1234", AuthenticationTypes.Secure);
            }
            catch (Exception ex)
            {
            }
            return entry;
        }

3．  查询

根据各种条件获取具体的用户。下例为根据公共名称获取对象。

/// <summary>
        /// 根据用户公共名称取得用户的 对象
        /// </summary>
        /// <param name="commonName">用户公共名称</param>
        /// <returns>如果找到该用户则返回用户的对象,否则返回 null</returns>
        public static DirectoryEntry GetDirectoryEntry(string commonName)
        {
            DirectoryEntry de = GetDirectoryObject();
            DirectorySearcher deSearch = new DirectorySearcher(de);
            deSearch.Filter = "(&(&(objectCategory=person)(objectClass=user))(cn=" + commonName.Replace("\\", "") + "))";
            deSearch.SearchScope = SearchScope.Subtree;
            try
            {
                SearchResult result = deSearch.FindOne();
                de = new DirectoryEntry(result.Path);
                return de;
            }
            catch (Exception ex)
            {
                return null;
            }
        }

4．  修改用户

修改查询到的Entity的值，修改后将修改记录保存到AD。注意有两种保存属性的方式。具体使用哪种请参考帮助。

1)       直接修改属性

2)       通过invoke来触发AD的内置函数

/// <summary>
        /// 修改查询到的用户
        /// </summary>
        /// <param name="CommonName">通用名（displayName,系统中显示的中文字）</param>
        /// <param name="Account">帐户名（如Peter）</param>
        /// <param name="organizeName">组织单元名（资讯中心）</param>
        /// <param name="password">密码</param>
        public static string ChangeADAccount(string CommonName, string Account, string password)
        {
            //获取对应AD实体
            DirectoryEntry user = GetDirectoryEntry( commonName);
            try
            {
                ADHelper.SetProperty(user, " sAMAccountName ", Account);
                user.Invoke("SetPassword", new object[] { password });
                user.CommitChanges();
            }
            catch (Exception e)
            {
                throw e;
            }
            return user.Path;
        }

/// <summary>
        /// 设置指定的属性值
        /// </summary>
        /// <param name="de"></param>
        /// <param name="propertyName">属性名称?</param>
        /// <param name="propertyValue">属性值</param>
        public static void SetProperty(DirectoryEntry de, string propertyName, string propertyValue)
        {
            if (de.Properties.Contains(propertyName))
            {
                if (String.IsNullOrEmpty(propertyValue))
                {
                    de.Properties[propertyName].RemoveAt(0);
                }
                else
                {
                    de.Properties[propertyName][0] = propertyValue;
                }
            }
            else
            {
                if (!String.IsNullOrEmpty(propertyValue))
                {
                    de.Properties[propertyName].Add(propertyValue);
                }
            }
        }

5．  修改OU

1）  获取OU

 DirectoryEntry OUEntry = new DirectoryEntry(GetOrganizeNamePath(OUName), "Peter", " ab#CD%1234", AuthenticationTypes.Secure);
        /// <summary>
        /// 获得OU的Path
        /// </summary>
        /// <param name="organizeUnit">OU名</param>
        /// <returns></returns>
        public static string GetOrganizeNamePath(string organizeUnit)
        {
            StringBuilder sb = new StringBuilder();
            sb.Append(ADPath);
            sb.Append("/");
            return sb.Append(SplitOrganizeNameToDN(organizeUnit)).ToString();
        }

2）  修改OU项

OUEntry.Rename("OU=" + newOUName);

        OUEntry.CommitChanges();

3）  删除OU

DirectoryEntry OUParent = OUEntry.Parent;

        OUParent.Children.Remove(OUEntry);

        OUParent.CommitChanges();

6．  修改组

1）  获取组

 /// <summary>
        /// 获取AD组
        /// </summary>
        /// <param name="groupName"></param>
        /// <param name="organizeUnit"></param>
        /// <returns></returns>
        public static DirectoryEntry GetADGroupInOU(string groupName, string organizeUnit)
        {
            if (!String.IsNullOrEmpty(groupName))
            {
                DirectoryEntry de = new DirectoryEntry(GetOrganizeNamePath(organizeUnit) , "Peter", " ab#CD%1234", AuthenticationTypes.Secure); ;
                DirectorySearcher deSearch = new DirectorySearcher(de);
                deSearch.Filter = "(&(objectClass=group)(cn=" + groupName.Replace("\\", "") + "))";
                deSearch.SearchScope = SearchScope.Subtree;
                try
                {
                    SearchResult result = deSearch.FindOne();
                    if (result != null)
                    {
                        de = new DirectoryEntry(result.Path, adminName, adminPassword);
                    }
                    else
                    {
                        return null;
                    }
                    return de;
                }
                catch (Exception ex)
                {
                    return null;
                }
            }
            else
            {
                return null;
            }
        }

2）  管理组成员

group.Properties["member"].Add(user.Properties["distinguishedName"].Value);

group.Properties["member"].Remove(user.Properties["distinguishedName"].Value);

三、查看AD User属性结果

在程序中修改了User属性后我们要检验一下是否被修改了，有三种方式查看AD中User属性：

1．  Active Directory Users and Computers

打开Active Directory Users and Computers，选择一个用户，右键单击该用户选择属性显示如下图所示的属性页。在该属性页只能看到一些常用的属性。

2．  Exchange Management Console

打开Exchange Management Console，选择一个用户，右键单击该用户选择属性显示如下图所示的属性页。单击Customer Attributes按钮可以查看自定义的属性。

3．  adsiedit.msc

以上两种方式所看到的属性都不全，要看到所有属性需使用adsiedit.msc工具。

在运行窗口中输入adsiedit.msc后打开本工具。选择一个用户，右键单击该用户选择属性显示如下图所示的属性页。

时间： 2024-10-24 08:02:02

C#操作Active Directory(AD)详解的相关文章

python3列表操作大全 列表操作方法详解

1 #!/usr/bin/env python 2 # -*- coding:utf-8 -*- 3 #Author:SKING 4 #python3列表操作大全 列表操作方法详解 5 6 #创建列表 7 list = ['a', 'b', 'c', 'd', 'e', 'f'] 8 #取出列表 9 print(list[0], list[5]) #a f 10 #列表切片 11 print(list[1:3]) #['b', 'c'] 12 print(list[-3:-1]) #['d',

操作Active Directory C#

.Net平台操作活动目录Active Directory,使用System.DirectoryServices.ActiveDirectory,主要是User OU 和Group的操作. 代码运行了一年多,还没有出现问题,应该算是经过了验证. 更新的代码在www.codeplex.com/ADBlock /* * Copyright [2008]. Sherwin Zhu. [email protected] * * http://www.gnu.org/licenses/lgpl-3.0.tx

datazen Active Directory AD 配置

今天苦心经营的datazen 链接AD,文档已经无法吐槽了简单的几句话,根本不够用. 先说一下链接AD 的好处吧, 1 首先免去设置密码的麻烦,因为直接用AD账号的密码. 2 更安全,因为客户可不想自己的自己的系统,开发人员随便一个测试账号都能进入.(其实我是参加一个银行类项目,被客户发现投产了,我居然还可以用他们系统,被催着用AD的.) 直接上修改步奏: 原文链接:https://msdn.microsoft.com/en-us/library/mt404694.aspx 加工后的中文版 在c

Linux基础命令，目录文件操作，vi编辑器详解

一.linux基础命令 linux命令的执行必须依赖于shell命令解释器.shell实际上是在linux系统中运行的一种特殊程序,它位于操作系统内核与用户之间,负责接收用户输入的命令并进行解释,将需要执行的操作传递给系统内核执行,shell在用户和内核之间充当了一个"翻译官"的角色.当用户登录到linux系统时,会自动加载一个shell程序,以便给用户提供可以输入命令的操作系统. 1.首先介绍一下快捷键 Tab键:用来补齐命令字或文件.目录名,例如输入"ifcon"

jQuery操作属性和样式详解

我们可以使用 javascript 中的getAttribute和setAttribute来操作元素的"元素属性".在 jQuery 中给你提供了attr()包装集函数, 能够同时操作包装集中所有元素的属性: 虽然我们可以使用removeAttr(name)删除元素属性,但是对应的 DOM 属性是不会被删除的, 只会影响 DOM 属性的值.比如将一个input元素的readonly元素属性去掉,会导致对应的 DOM 属性变成false(即input变成可编辑状态). ?修改 CSS 类

thinkphp框架中“关联操作”的完整定义详解

在复杂的关联操作中,如果要给关联定义增加可选的属性,我们可以采用完整定义的方式. 完整定义的格式是: protected $_link = array( '关联表名1'  =>  array( '该表的关联方式的属性1' => '定义', '该表的关联方式的属性N' => '定义', ), '关联表名2'  =>  array( '该表的关联方式的属性1' => '定义', '该表的关联方式的属性N' => '定义', ), ... ); 在上面的格式描述中,对于属性我

Python文件操作及seek偏移详解

本文和大家分享的主要是python中文件操作及seek偏移相关内容,一起来看看吧,希望对大家学习python有所帮助. 一.Python文件操作中的编码 本次测试是基于Python 2.7.12  OS:Ubuntu 16.04  pycharm环境,以及Win7下2.7.12; 首先说下汉字在文件中占用的字节数,这个先看以下实验(Win7)下 因为Linux下不支持gbk,本文不讲utf-8 ,gbk编码具体知识.本次实验只讲解python在使用utf-8和gbk编码时,对汉字占用的字节有所不

帝国CMS【操作类型】说明详解

看标签的参数时候,一般最后一个参数是操作类型说明,可是后面写的是:"操作类型说明 具体看操作类型说明", 这个操作类型说明在什么地方看啊 操作类型 说明 操作类型 说明 0 各栏目最新 1 各栏目热门 2 各栏目推荐 9 各栏目评论排行 12 各栏目头条信息 15 各栏目下载排行 25 各栏目评分排行 26 各栏目投票排行 3 所有信息最新(默认表) 4 所有信息热门(默认表) 5 所有信息推荐(默认表) 10 所有信息评论排行(默认表) 13 所有信息头条(默认表) 16 所有信息下

Linux Shell字符串操作(长度\查找\替换)详解

在做shell批处理程序时候,经常会涉及到字符串相关操作.有很多命令语句,如:awk,sed都可以做字符串各种操作. 其实shell内置一系列操作符号,可以达到类似效果,大家知道,使用内部操作符会省略启动外部程序等时间,因此速度会非常的快. 一.判断读取字符串值 表达式 含义 ${var} 变量var的值, 与$var相同 ${var-DEFAULT} 如果var没有被声明, 那么就以$DEFAULT作为其值 * ${var:-DEFAULT} 如果var没有被声明, 或者其值为空, 那么就以$