#ldap #async #high-level

simple-ldap

A high-level LDAP client for Rust

8 releases (4 major breaking)

5.1.0 Feb 26, 2025
4.0.0 Feb 4, 2025
3.1.0 Feb 4, 2025
2.1.1 Nov 26, 2024
0.0.4 Jun 4, 2023

#184 in Authentication

Download history 44/week @ 2024-11-28 24/week @ 2024-12-05 26/week @ 2024-12-12 19/week @ 2024-12-26 15/week @ 2025-01-02 95/week @ 2025-01-09 28/week @ 2025-01-16 23/week @ 2025-01-23 385/week @ 2025-01-30 145/week @ 2025-02-06 241/week @ 2025-02-13 114/week @ 2025-02-20 108/week @ 2025-02-27 32/week @ 2025-03-06 15/week @ 2025-03-13

277 downloads per month

MIT/Apache

81KB
1K SLoC

Simple LDAP client library for Ldap3

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

CI Crates.io Documentation

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;

// A type for deserializing the search result into.
#[derive(Debug, Deserialize)]
struct User {
    uid: String,
    cn: String,
    sn: 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"],
    ).await.unwrap();
}

Dependencies

~7–23MB
~344K SLoC