A pure-Rust LDAP client library using the Tokio stack.
Version 0.10 gets a dependencies update, move to Edition 2021, and an experimental API update which lets the user pass either owned or borrowed attribute lists. This is a breaking change, especially if you've used or written your own search adapters, although type inference should cover most cases. If the change is too disruptive, the dual attribute list support could be removed in a future release.
Version 0.9 is unchanged, although it may get bug fixes for a while.
The library is client-only. One cannot make an LDAP server or a proxy with it. It supports only version 3 of the protocol over connection-oriented transports.
The library can be used either synchronously or asynchronously. The aim is to offer essentially the same call interface for both flavors, with the necessary differences in interaction and return values according to the nature of I/O.
Add this to your Cargo.toml:
toml
[dependencies.ldap3]
version = "0.9"
The following two examples perform exactly the same operation and should produce identical
results. They should be run against the example server in the data subdirectory of the crate source.
Other sample programs expecting the same server setup can be found in the examples subdirectory.
```rust use ldap3::{LdapConn, Scope, SearchEntry}; use ldap3::result::Result;
fn main() -> Result<()> { let mut ldap = LdapConn::new("ldap://localhost:2389")?; let (rs, _res) = ldap.search( "ou=Places,dc=example,dc=org", Scope::Subtree, "(&(objectClass=locality)(l=ma*))", vec!["l"] )?.success()?; for entry in rs { println!("{:?}", SearchEntry::construct(entry)); } Ok(ldap.unbind()?) } ```
```rust use ldap3::{LdapConnAsync, Scope, SearchEntry}; use ldap3::result::Result;
async fn main() -> Result<()> { let (conn, mut ldap) = LdapConnAsync::new("ldap://localhost:2389").await?; ldap3::drive!(conn); let (rs, _res) = ldap.search( "ou=Places,dc=example,dc=org", Scope::Subtree, "(&(objectClass=locality)(l=ma*))", vec!["l"] ).await?.success()?; for entry in rs { println!("{:?}", SearchEntry::construct(entry)); } Ok(ldap.unbind().await?) } ```
The following features are available at compile time:
sync (enabled by default): Synchronous API support.
tls (enabled by default): TLS support, backed by the native-tls crate, which uses
a platform-specific TLS backend. This is an alias for tls-native.
tls-rustls (disabled by default): TLS support, backed by the Rustls library.
Without any features, only plain TCP connections (and Unix domain sockets on Unix-like platforms) are available. For TLS support, tls and tls-rustls are mutually exclusive: choosing both will produce a compile-time error.
Licensed under either of:
at your option.