using System;
using System.DirectoryServices;
namespace SystemFrameworks.Helper
{
///
///
活动目录辅助类。封装一系列活动目录操作相关的方法。
///
public
sealed
class
ADHelper
{
///
///
域名
///
private
static
string
DomainName = "MyDomain";
///
///
LDAP
地址
///
private
static
string
LDAPDomain = "DC=MyDomain,DC=local";
///
///
LDAP
绑定路径
///
private
static
string
ADPath = "LDAP://brooks.mydomain.local";
///
///
登录帐号
///
private
static
string
ADUser = "Administrator";
///
///
登录密码
///
private
static
string
ADPassword = "password";
///
///
扮演类实例
///
private
static
IdentityImpersonation impersonate = new
IdentityImpersonation(ADUser, ADPassword, DomainName);
///
///
用户登录验证结果
///
public
enum
LoginResult
{
///
///
正常登录
///
LOGIN_USER_OK = 0,
///
///
用户不存在
///
LOGIN_USER_DOESNT_EXIST,
///
///
用户帐号被禁用
///
LOGIN_USER_ACCOUNT_INACTIVE,
///
///
用户密码不正确
///
LOGIN_USER_PASSWORD_INCORRECT
}
///
///
用户属性定义标志
///
public
enum
ADS_USER_FLAG_ENUM
{
///
///
登录脚本标志。如果通过 ADSI LDAP 进行读或写操作时，该标志失效。如果通过 ADSI WINNT，该标志为只读。
///
ADS_UF_SCRIPT = 0X0001,
///
///
用户帐号禁用标志
///
ADS_UF_ACCOUNTDISABLE = 0X0002,
///
///
主文件夹标志
///
ADS_UF_HOMEDIR_REQUIRED = 0X0008,
///
///
过期标志
///
ADS_UF_LOCKOUT = 0X0010,
///
///
用户密码不是必须的
///
ADS_UF_PASSWD_NOTREQD = 0X0020,
///
///
密码不能更改标志
///
ADS_UF_PASSWD_CANT_CHANGE = 0X0040,
///
///
使用可逆的加密保存密码
///
ADS_UF_ENCRYPTED_TEXT_PASSWORD_ALLOWED = 0X0080,
///
///
本地帐号标志
///
ADS_UF_TEMP_DUPLICATE_ACCOUNT = 0X0100,
///
///
普通用户的默认帐号类型
///
ADS_UF_NORMAL_ACCOUNT = 0X0200,
///
///
跨域的信任帐号标志
///
ADS_UF_INTERDOMAIN_TRUST_ACCOUNT = 0X0800,
///
///
工作站信任帐号标志
///
ADS_UF_WORKSTATION_TRUST_ACCOUNT = 0x1000,
///
///
服务器信任帐号标志
///
ADS_UF_SERVER_TRUST_ACCOUNT = 0X2000,
///
///
密码永不过期标志
///
ADS_UF_DONT_EXPIRE_PASSWD = 0X10000,
///
///
MNS
帐号标志
///
ADS_UF_MNS_LOGON_ACCOUNT = 0X20000,
///
///
交互式登录必须使用智能卡
///
ADS_UF_SMARTCARD_REQUIRED = 0X40000,
///
///
当设置该标志时，服务帐号（用户或计算机帐号）将通过 Kerberos 委托信任
///
ADS_UF_TRUSTED_FOR_DELEGATION = 0X80000,
///
///
当设置该标志时，即使服务帐号是通过 Kerberos 委托信任的，敏感帐号不能被委托
///
ADS_UF_NOT_DELEGATED = 0X100000,
///
///
此帐号需要 DES 加密类型
///
ADS_UF_USE_DES_KEY_ONLY = 0X200000,
///
///
不要进行 Kerberos 预身份验证
///
ADS_UF_DONT_REQUIRE_PREAUTH = 0X4000000,
///
///
用户密码过期标志
///
ADS_UF_PASSWORD_EXPIRED = 0X800000,
///
///
用户帐号可委托标志
///
ADS_UF_TRUSTED_TO_AUTHENTICATE_FOR_DELEGATION = 0X1000000
}
public
ADHelper()
{
//
}
#region
GetDirectoryObject
///
///
获得DirectoryEntry对象实例,以管理员登陆AD
///
///
private
static
DirectoryEntry GetDirectoryObject()
{
DirectoryEntry entry = new
DirectoryEntry(ADPath, ADUser, ADPassword, AuthenticationTypes.Secure);
return
entry;
}
///
///
根据指定用户名和密码获得相应DirectoryEntry实体
///
///
///
///
private
static
DirectoryEntry GetDirectoryObject(string
userName, string
password)
{
DirectoryEntry entry = new
DirectoryEntry(ADPath, userName, password, AuthenticationTypes.None);
return
entry;
}
///
///
i.e. /CN=Users,DC=creditsights, DC=cyberelves, DC=Com
///
///
///
private
static
DirectoryEntry GetDirectoryObject(string
domainReference)
{
DirectoryEntry entry = new
DirectoryEntry(ADPath + domainReference, ADUser, ADPassword, AuthenticationTypes.Secure);
return
entry;
}
///
///
获得以UserName,Password创建的DirectoryEntry
///
///
///
///
///
private
static
DirectoryEntry GetDirectoryObject(string
domainReference, string
userName, string
password)
{
DirectoryEntry entry = new
DirectoryEntry(ADPath + domainReference, userName, password, AuthenticationTypes.Secure);
return
entry;
}
#endregion
#region
GetDirectoryEntry
///
///
根据用户公共名称取得用户的
对象
///
///
用户公共名称
///
如果找到该用户，则返回用户的
对象；否则返回 null
public
static
DirectoryEntry GetDirectoryEntry(string
commonName)
{
DirectoryEntry de = GetDirectoryObject();
DirectorySearcher deSearch = new
DirectorySearcher(de);
deSearch.Filter = "(&(&(objectCategory=person)(objectClass=user))(cn=" + commonName + "))";
deSearch.SearchScope = SearchScope.Subtree;
try
{
SearchResult result = deSearch.FindOne();
de = new
DirectoryEntry(result.Path);
return
de;
}
catch
{
return
null
;
}
}
///
///
根据用户公共名称和密码取得用户的
对象。
///
///
用户公共名称
///
用户密码
///
如果找到该用户，则返回用户的
对象；否则返回 null
public
static
DirectoryEntry GetDirectoryEntry(string
commonName, string
password)
{
DirectoryEntry de = GetDirectoryObject(commonName, password);
DirectorySearcher deSearch = new
DirectorySearcher(de);
deSearch.Filter = "(&(&(objectCategory=person)(objectClass=user))(cn=" + commonName + "))";
deSearch.SearchScope = SearchScope.Subtree;
try
{
SearchResult result = deSearch.FindOne();
de = new
DirectoryEntry(result.Path);
return
de;
}
catch
{
return
null
;
}
}
///
///
根据用户帐号称取得用户的
对象
///
///
用户帐号名
///
如果找到该用户，则返回用户的
对象；否则返回 null
public
static
DirectoryEntry GetDirectoryEntryByAccount(string
sAMAccountName)
{
DirectoryEntry de = GetDirectoryObject();
DirectorySearcher deSearch = new
DirectorySearcher(de);
deSearch.Filter = "(&(&(objectCategory=person)(objectClass=user))(sAMAccountName=" + sAMAccountName + "))";
deSearch.SearchScope = SearchScope.Subtree;
try
{
SearchResult result = deSearch.FindOne();
de = new
DirectoryEntry(result.Path);
return
de;
}
catch
{
return
null
;
}
}
///
///
根据用户帐号和密码取得用户的
对象
///
///
用户帐号名
///
用户密码
///
如果找到该用户，则返回用户的
对象；否则返回 null
public
static
DirectoryEntry GetDirectoryEntryByAccount(string
sAMAccountName, string
password)
{
DirectoryEntry de = GetDirectoryEntryByAccount(sAMAccountName);
if
(de != null
)
{
string
commonName = de.Properties["cn"][0].ToString();
if
(GetDirectoryEntry(commonName, password) != null
)
return
GetDirectoryEntry(commonName, password);
else
return
null
;
}
else
{
return
null
;
}
}
///
///
根据组名取得用户组的
对象
///
///
组名
///
public
static
DirectoryEntry GetDirectoryEntryOfGroup(string
groupName)
{
DirectoryEntry de = GetDirectoryObject();
DirectorySearcher deSearch = new
DirectorySearcher(de);
deSearch.Filter = "(&(objectClass=group)(cn=" + groupName + "))";
deSearch.SearchScope = SearchScope.Subtree;
try
{
SearchResult result = deSearch.FindOne();
de = new
DirectoryEntry(result.Path);
return
de;
}
catch
{
return
null
;
}
}
#endregion
#region
GetProperty
///
///
获得指定
指定属性名对应的值
///
///
///
属性名称
///
属性值
public
static
string
GetProperty(DirectoryEntry de, string
propertyName)
{
if
(de.Properties.Contains(propertyName))
{
return
de.Properties[propertyName][0].ToString() ;
}
else
{
return
string
.Empty;
}
}
///
///
获得指定搜索结果
中指定属性名对应的值
///
///
///
属性名称
///
属性值
public
static
string
GetProperty(SearchResult searchResult, string
propertyName)
{
if
(searchResult.Properties.Contains(propertyName))
{
return
searchResult.Properties[propertyName][0].ToString() ;
}
else
{
return
string
.Empty;
}
}
#endregion
///
///
设置指定
的属性值
///
///
///
属性名称
///
属性值
public
static
void
SetProperty(DirectoryEntry de, string
propertyName, string
propertyValue)
{
if
(propertyValue != string
.Empty || propertyValue != "" || propertyValue != null
)
{
if
(de.Properties.Contains(propertyName))
{
de.Properties[propertyName][0] = propertyValue;
}
else
{
de.Properties[propertyName].Add(propertyValue);
}
}
}
///
///
创建新的用户
///
///
DN
位置。例如：OU=共享平台 或 CN=Users
///
公共名称
///
帐号
///
密码
///
public
static
DirectoryEntry CreateNewUser(string
ldapDN, string
commonName, string
sAMAccountName, string
password)
{
DirectoryEntry entry = GetDirectoryObject();
DirectoryEntry subEntry = entry.Children.Find(ldapDN);
DirectoryEntry deUser = subEntry.Children.Add("CN=" + commonName, "user");
deUser.Properties["sAMAccountName"].Value = sAMAccountName;
deUser.CommitChanges();
ADHelper.EnableUser(commonName);
ADHelper.SetPassword(commonName, password);
deUser.Close();
return
deUser;
}
///
///
创建新的用户。默认创建在 Users 单元下。
///
///
公共名称
///
帐号
///
密码
///
public
static
DirectoryEntry CreateNewUser(string
commonName, string
sAMAccountName, string
password)
{
return
CreateNewUser("CN=Users", commonName, sAMAccountName, password);
}
///
///
判断指定公共名称的用户是否存在
///
///
用户公共名称
///
如果存在，返回 true；否则返回 false
public
static
bool
IsUserExists(string
commonName)
{
DirectoryEntry de = GetDirectoryObject();
DirectorySearcher deSearch = new
DirectorySearcher(de);
deSearch.Filter = "(&(&(objectCategory=person)(objectClass=user))(cn=" + commonName + "))";
// LDAP
查询串
SearchResultCollection results = deSearch.FindAll();
if
(results.Count == 0)
return
false
;
else
return
true
;
}
///
///
判断用户帐号是否激活
///
///
用户帐号属性控制器
///
如果用户帐号已经激活，返回 true；否则返回 false
public
static
bool
IsAccountActive(int
userAccountControl)
{
int
userAccountControl_Disabled = Convert.ToInt32(ADS_USER_FLAG_ENUM.ADS_UF_ACCOUNTDISABLE);
int
flagExists = userAccountControl & userAccountControl_Disabled;
if
(flagExists > 0)
return
false
;
else
return
true
;
}
///
///
判断用户与密码是否足够以满足身份验证进而登录
///
///
用户公共名称
///
密码
///
如能可正常登录，则返回 true；否则返回 false
public
static
LoginResult Login(string
commonName, string
password)
{
DirectoryEntry de = GetDirectoryEntry(commonName);
if
(de != null
)
{
//
必须在判断用户密码正确前，对帐号激活属性进行判断；否则将出现异常。
int
userAccountControl = Convert.ToInt32(de.Properties["userAccountControl"][0]);
de.Close();
if
(!IsAccountActive(userAccountControl))
return
LoginResult.LOGIN_USER_ACCOUNT_INACTIVE;
if
(GetDirectoryEntry(commonName, password) != null
)
return
LoginResult.LOGIN_USER_OK;
else
return
LoginResult.LOGIN_USER_PASSWORD_INCORRECT;
}
else
{
return
LoginResult.LOGIN_USER_DOESNT_EXIST;
}
}
///
///
判断用户帐号与密码是否足够以满足身份验证进而登录
///
///
用户帐号
///
密码
///
如能可正常登录，则返回 true；否则返回 false
public
static
LoginResult LoginByAccount(string
sAMAccountName, string
password)
{
DirectoryEntry de = GetDirectoryEntryByAccount(sAMAccountName);
if
(de != null
)
{
//
必须在判断用户密码正确前，对帐号激活属性进行判断；否则将出现异常。
int
userAccountControl = Convert.ToInt32(de.Properties["userAccountControl"][0]);
de.Close();
if
(!IsAccountActive(userAccountControl))
return
LoginResult.LOGIN_USER_ACCOUNT_INACTIVE;
if
(GetDirectoryEntryByAccount(sAMAccountName, password) != null
)
return
LoginResult.LOGIN_USER_OK;
else
return
LoginResult.LOGIN_USER_PASSWORD_INCORRECT;
}
else
{
return
LoginResult.LOGIN_USER_DOESNT_EXIST;
}
}
///
///
设置用户密码，管理员可以通过它来修改指定用户的密码。
///
///
用户公共名称
///
用户新密码
public
static
void
SetPassword(string
commonName, string
newPassword)
{
DirectoryEntry de = GetDirectoryEntry(commonName);
//
模拟超级管理员，以达到有权限修改用户密码
impersonate.BeginImpersonate();
de.Invoke("SetPassword", new
object
[]{newPassword});
impersonate.StopImpersonate();
de.Close();
}
///
///
设置帐号密码，管理员可以通过它来修改指定帐号的密码。
///
///
用户帐号
///
用户新密码
public
static
void
SetPasswordByAccount(string
sAMAccountName, string
newPassword)
{
DirectoryEntry de = GetDirectoryEntryByAccount(sAMAccountName);
//
模拟超级管理员，以达到有权限修改用户密码
IdentityImpersonation impersonate = new
IdentityImpersonation(ADUser, ADPassword, DomainName);
impersonate.BeginImpersonate();
de.Invoke("SetPassword", new
object
[]{newPassword});
impersonate.StopImpersonate();
de.Close();
}
///
///
修改用户密码
///
///
用户公共名称
///
旧密码
///
新密码
public
static
void
ChangeUserPassword (string
commonName, string
oldPassword, string
newPassword)
{
// to-do:
需要解决密码策略问题
DirectoryEntry oUser = GetDirectoryEntry(commonName);
oUser.Invoke("ChangePassword", new
Object[]{oldPassword, newPassword});
oUser.Close();
}
///
///
启用指定公共名称的用户
///
///
用户公共名称
public
static
void
EnableUser(string
commonName)
{
EnableUser(GetDirectoryEntry(commonName));
}
///
///
启用指定
的用户
///
///
public
static
void
EnableUser(DirectoryEntry de)
{
impersonate.BeginImpersonate();
de.Properties["userAccountControl"][0] =
ADHelper.ADS_USER_FLAG_ENUM.ADS_UF_NORMAL_ACCOUNT |
ADHelper.ADS_USER_FLAG_ENUM.ADS_UF_DONT_EXPIRE_PASSWD;
de.CommitChanges();
impersonate.StopImpersonate();
de.Close();
}
///
///
禁用指定公共名称的用户
///
///
用户公共名称
public
static
void
DisableUser(string
commonName)
{
DisableUser(GetDirectoryEntry(commonName));
}
///
///
禁用指定
的用户
///
///
public
static
void
DisableUser(DirectoryEntry de)
{
impersonate.BeginImpersonate();
de.Properties["userAccountControl"][0]=ADHelper.ADS_USER_FLAG_ENUM.ADS_UF_NORMAL_ACCOUNT
| ADHelper.ADS_USER_FLAG_ENUM.ADS_UF_DONT_EXPIRE_PASSWD |
ADHelper.ADS_USER_FLAG_ENUM.ADS_UF_ACCOUNTDISABLE;
de.CommitChanges();
impersonate.StopImpersonate();
de.Close();
}
///
///
将指定的用户添加到指定的组中。默认为 Users 下的组和用户。
///
///
用户公共名称
///
组名
public
static
void
AddUserToGroup(string
userCommonName, string
groupName)
{
DirectoryEntry oGroup = GetDirectoryEntryOfGroup(groupName);
DirectoryEntry oUser = GetDirectoryEntry(userCommonName);
impersonate.BeginImpersonate();
oGroup.Properties["member"].Add(oUser.Properties["distinguishedName"].Value);
oGroup.CommitChanges();
impersonate.StopImpersonate();
oGroup.Close();
oUser.Close();
}
///
///
将用户从指定组中移除。默认为 Users 下的组和用户。
///
///
用户公共名称
///
组名
public
static
void
RemoveUserFromGroup(string
userCommonName, string
groupName)
{
DirectoryEntry oGroup = GetDirectoryEntryOfGroup(groupName);
DirectoryEntry oUser = GetDirectoryEntry(userCommonName);
impersonate.BeginImpersonate();
oGroup.Properties["member"].Remove(oUser.Properties["distinguishedName"].Value);
oGroup.CommitChanges();
impersonate.StopImpersonate();
oGroup.Close();
oUser.Close();
}
}
///
///
用户模拟角色类。实现在程序段内进行用户角色模拟。
///
public
class
IdentityImpersonation
{
[DllImport("advapi32.dll", SetLastError=true
)]
public
static
extern
bool
LogonUser(String lpszUsername, String lpszDomain, String lpszPassword, int
dwLogonType, int
dwLogonProvider, ref
IntPtr phToken);
[DllImport("advapi32.dll", CharSet=CharSet.Auto, SetLastError=true
)]
public
extern
static
bool
DuplicateToken(IntPtr ExistingTokenHandle, int
SECURITY_IMPERSONATION_LEVEL, ref
IntPtr DuplicateTokenHandle);
[DllImport("kernel32.dll", CharSet=CharSet.Auto)]
public
extern
static
bool
CloseHandle(IntPtr handle);
//
要模拟的用户的用户名、密码、域(机器名)
private
String _sImperUsername;
private
String _sImperPassword;
private
String _sImperDomain;
//
记录模拟上下文
private
WindowsImpersonationContext _imperContext;
private
IntPtr _adminToken;
private
IntPtr _dupeToken;
//
是否已停止模拟
private
Boolean _bClosed;
///
///
构造函数
///
///
所要模拟的用户的用户名
///
所要模拟的用户的密码
///
所要模拟的用户所在的域
public
IdentityImpersonation(String impersonationUsername, String impersonationPassword, String impersonationDomain)
{
_sImperUsername = impersonationUsername;
_sImperPassword = impersonationPassword;
_sImperDomain = impersonationDomain;
_adminToken = IntPtr.Zero;
_dupeToken = IntPtr.Zero;
_bClosed = true
;
}
///
///
析构函数
///
~IdentityImpersonation()
{
if
(!_bClosed)
{
StopImpersonate();
}
}
///
///
开始身份角色模拟。
///
///
public
Boolean BeginImpersonate()
{
Boolean bLogined = LogonUser(_sImperUsername, _sImperDomain, _sImperPassword, 2, 0, ref
_adminToken);
if
(!bLogined)
{
return
false
;
}
Boolean bDuped = DuplicateToken(_adminToken, 2, ref
_dupeToken);
if
(!bDuped)
{
return
false
;
}
WindowsIdentity fakeId = new
WindowsIdentity(_dupeToken);
_imperContext = fakeId.Impersonate();
_bClosed = false
;
return
true
;
}
///
///
停止身分角色模拟。
///
public
void
StopImpersonate()
{
_imperContext.Undo();
CloseHandle(_dupeToken);
CloseHandle(_adminToken);
_bClosed = true
;
}
}
}
来源：https://www.cnblogs.com/yefengmeander/archive/2010/08/03/2887816.html