Simple LDAP client library for Ldap3

A ldap client library that wraps ldap3 to make it easy to use.

Usage

Adding simple_ldap as a dependency to your project:

cargo add simple-ldap

Other useful pieces you'll likely need:

cargo add url serde --features serde/derive

Example

There are plenty more examples in the documentation!

Search records

use simple_ldap::{
    LdapClient, LdapConfig,
    filter::EqFilter,
    ldap3::Scope
};
use url::Url;
use serde::Deserialize;
use serde_with::serde_as;
use serde_with::OneOrMany;

// A type for deserializing the search result into.
#[serde_as] // serde_with for multiple values
#[derive(Debug, Deserialize)]
struct User {
    uid: String,
    cn: String,
    sn: String,
    #[serde_as(as = "OneOrMany<_>")]
    addresses: Vec<String>,
}


#[tokio::main]
async fn main(){
    let ldap_config = LdapConfig {
        bind_dn: String::from("cn=manager"),
        bind_password: String::from("password"),
        ldap_url: Url::parse("ldaps://localhost:1389/dc=example,dc=com").unwrap(),
        dn_attribute: None,
        connection_settings: None
    };
    let mut client = LdapClient::new(ldap_config).await.unwrap();
    let name_filter = EqFilter::from("cn".to_string(), "Sam".to_string());
    let user: User = client
        .search::<User>(
        "ou=people,dc=example,dc=com",
        Scope::OneLevel,
        &name_filter,
        &vec!["cn", "sn", "uid","addresses"],
    ).await.unwrap();
}