FrameworkExtKit.DirectoryService 4.2.1

Summary

This library aims to provide an easy solution to read LDAP/AD data. It is not designed to support full LDAP functions.

It allows developers to query LDAP/AD directory using Linq queries without learning LDAP filter syntax. You will be able to master LDAP search within few minutes.

You can also use this library to fetch user/group/policy etc. information from a flat database table without re-work the solution.

Package Dependencies

1. Novell.Directory.Ldap.NETStandard

Usage

1. Configuration

.net framework 4.5

<appSettings>
    
    <add key="DirectoryAccountService.RootEntryPath" value="LDAP://ldap.company.com/o=company,c=an" />
    
    <add key="DirectoryAccountService.RootEntryPath" value="LDAP://activedirectory.sample.com" />
    
    <add key="DirectoryAccountService.RootEntryPath" value="DB://DBDirectoryService" />

</appSettings>
  <connectionStrings>
    <add name="DBDirectoryService" connectionString="data source=(localdb)\MSSQLLocalDB;integrated security=true;initial catalog=DBDirectoryService;" providerName="System.Data.SqlClient" />
  </connectionStrings>

.netcore, appsettings.json

{
  "LdapSettings": {
    "ServerName": "ldap.company.com",
    "ServerPort": 389,
    "UseSSL": false,
    "Bind": {
      "BindDn": "",
      "BindCredentials": ""
    },
    "SearchBase": "o=company,c=an"
  }
}

2. Create Entity Class

Create an entity class to represent the LDAP data structure needed

public partial class DirectoryRole : DirectoryEntity {
        [DirectoryProperty("mail")]
        public virtual string Mail { get; set; }
        [DirectoryProperty("street")]
        public virtual string Street { get; set; }
        [DirectoryProperty("st")]
        public virtual string State { get; set; }
        [DirectoryProperty("postalcode")]
        public virtual string PostalCode { get; set; }
        [DirectoryProperty("manager")]
        public virtual string Manager { get; set; }

        public virtual string[] Proxies { 
	        get {
		        return this.Proxy.Split(";");
	        }
        }
        [DirectoryProperty("proxy")]
        public virtual string Proxy { get; set; }
        [DirectoryProperty("description")]
        public virtual string Description { get; set; }
    }

3. Create DirectoryService

.net core

public void CreateDirectoryService(IConfiguration configuration) {
    var section = configuration.GetSection("LdapSettings");
    LdapSettings settings = new LdapSettings();
    section.Bind(settings);
    service = new LdapDirectoryService<DirectoryRole>(settings);
}

4. Search LDAP

service.FindByIdentifier("user-name");
// linq query
service.First(role => role.Mail == "me@company.com");
service.Where(role => role.manager=="manager1" && role.Mail.Contains("@company.com"))
        .ToList();
// ldap filter
service.Query("(&(mail=*@company.com*)(manager=*manager1*))")