1. 程式人生 > >Aras學習筆記 (12) C#程式碼讀取域使用者列表(轉,翻譯)

Aras學習筆記 (12) C#程式碼讀取域使用者列表(轉,翻譯)

Get List of Active Directory Users in C# - 作者原文標題

Introduction 

This tip describes how to list Active Directory users.  介紹如何提取AD域中的使用者列表

Using the Code 

The below code demonstrates how can we fetch Active Directory (AD) using Directory Service. For this, I'm using object array (Users) and here is the structure:

首先建立實體類,使用者儲存使用者資訊。

public class Users
{
    public string Email { get; set; }
    public string UserName { get; set; }
    public string DisplayName { get; set; }
    public bool isMapped { get; set; }
}

The code below shows how to fetch user information from Active Directory.

以下程式碼為如何AD域中的使用者資訊。

public List<Users> GetADUsers()
{
    try
    {
        List<Users> lstADUsers = new List<Users>();  //定義返回列表
        string DomainPath = "LDAP://DC=xxxx,DC=com" //改為自己公司的LDAP訪問地址
        DirectoryEntry searchRoot = new DirectoryEntry(DomainPath); 
        DirectorySearcher search = new
DirectorySearcher(searchRoot); search.Filter = "(&(objectClass=user)(objectCategory=person))"; search.PropertiesToLoad.Add("samaccountname");  //提取samaccountname,mail,usergroup和displayname四個欄位 search.PropertiesToLoad.Add("mail"); search.PropertiesToLoad.Add("usergroup"); search.PropertiesToLoad.Add("displayname");//first name SearchResult result; SearchResultCollection resultCol = search.FindAll();  //執行查詢 if (resultCol != null) { for (int counter = 0; counter < resultCol.Count; counter++)  //迴圈讀取 { string UserNameEmailString = string.Empty; result = resultCol[counter]; if (result.Properties.Contains("samaccountname") && result.Properties.Contains("mail") && result.Properties.Contains("displayname")) { Users objSurveyUsers = new Users(); objSurveyUsers.Email = (String)result.Properties["mail"][0] + "^" + (String)result.Properties["displayname"][0]; objSurveyUsers.UserName = (String)result.Properties["samaccountname"][0]; objSurveyUsers.DisplayName = (String)result.Properties["displayname"][0]; lstADUsers.Add(objSurveyUsers); } } } return lstADUsers;  //返回 } catch (Exception ex) { }
 
 

Let's see what is happening here... 實現原理介紹

The DirectoryEntry class encapsulates an object in Active Directory Domain Services, DirectoryEntry(DomainPath) initializes a new instance of the class that binds this instance to the node in Active Directory Domain Services located at the specified path, i.e., DomainPath.

In DirectorySearcher, create a DirectorySearcher object which searches for all users in a domain. search.Filter = "(&(objectClass=user)(objectCategory=person))" filters the search.

The search filter syntax looks a bit complicated, but basically it filters the search results to only include users - "objectCategory=person" and "objectClass=user" - and excludes disabled user accounts by performing a bitwise AND of the userAccountControl flags and the "account disabled" flag.

NoteSAMAccountName is unique and also indexed. sAMAccountName must be unique among all security principal objects within the domain.

search.FindAll(); retrieves all the elements that match the conditions defined.

Let's see how we get the current login user.

//獲取當前登入域使用者

public string GetCurrentUser()
{
    try
    {
        string userName = HttpContext.Current.User.Identity.Name.Split('\\')[1].ToString();
        string displayName = GetAllADUsers().Where(x => 
          x.UserName == userName).Select(x => x.DisplayName).First();
        return displayName;
    }
    catch (Exception ex)
    { //Exception logic here 
    }
}
 

Let's see what this code snippet does:

  • HttpContext.Current.User.Identity returns the Windows identity object including AuthenticationType ("ntml", "kerberos" etc..), IsAuthenticatedName ("Domain/username").
  • HttpContext.Current.User.Identity.Name returns "Domain\\username" .

Hope this helps you understand how directory service works with AD. //感謝原作者大神