Struct LdapConnectionManager 

pub struct LdapConnectionManager { /* private fields */ }

A bb8::ManageConnection implementation for ldap3 async connections.

Implementations

impl LdapConnectionManager

pub fn new<S: Into<String>>(ldap_url: S) -> Result<Self, LdapError>

Creates a new LdapConnectionManager with the given LDAP URL.

The URL is parsed and validated. Valid schemes are ldap and ldapi.

Note: ldaps:// is not accepted. To use TLS, pass an ldap:// URL and configure StartTLS via LdapConnSettings::set_starttls(true).

Errors

Returns LdapError::UrlParsing if the URL is malformed. Returns LdapError::UnknownScheme if the scheme is not ldap or ldapi.

pub fn with_connection_settings(self, settings: LdapConnSettings) -> Self

Update the LDAP connection settings for this manager.

pub fn with_bind_credentials<S: Into<String>>( self, bind_dn: S, bind_password: S, ) -> Self

Configures a simple bind to be performed when new connections are created.

The bind_dn is the distinguished name to bind as (e.g., "cn=admin,dc=example,dc=org"). The bind_password is the password for the bind DN.

The bind is performed immediately after each connection is established, before the connection is returned from the pool.

pub fn with_validation_timeout(self, timeout: Duration) -> Self

Overrides the timeout used by is_valid health checks.

The timeout specifies the maximum duration to wait for the validation search. The default is 1 second.

pub fn with_validation_search<S: Into<String>>( self, base_dn: S, scope: Scope, filter: S, attributes: Vec<S>, ) -> Self

Overrides the validation search performed by is_valid.

• base_dn: The base DN for the search. Default: "" (root DSE).
• scope: The search scope. Default: Scope::Base.
• filter: The search filter. Default: "(objectClass=*)".
• attributes: The attributes to return. Default: ["1.1"] (no attributes).

pub fn with_connect_timeout(self, timeout: Duration) -> Self

Sets a timeout applied when establishing new connections.

This timeout is applied during connect() on a clone of the configured LdapConnSettings, and overrides any timeout previously set on those settings.

Trait Implementations

impl Clone for LdapConnectionManager

fn clone(&self) -> LdapConnectionManager

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LdapConnectionManager

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl ManageConnection for LdapConnectionManager

Implements bb8::ManageConnection to provide connection pooling for ldap3::Ldap connections.

• connect() establishes a new LDAP connection and optionally performs a simple bind if credentials are configured.
• is_valid() validates a connection by performing a lightweight LDAP search with the configured timeout.
• has_broken() returns true if the underlying channel is closed (though this doesn’t guarantee full bidirectional health).

type Connection = Ldap

The connection type this manager deals with.

type Error = LdapError

The error type returned by Connections.

async fn connect(&self) -> Result<Self::Connection, Self::Error>

Attempts to create a new connection.

async fn is_valid(&self, conn: &mut Self::Connection) -> Result<(), Self::Error>

Determines if the connection is still connected to the database.

fn has_broken(&self, conn: &mut Self::Connection) -> bool

Synchronously determine if the connection is no longer usable, if possible.