Struct LdapConnection

pub struct LdapConnection<Stream, BindState = Unbound>
where
    Stream: Read + Write,
{ /* private fields */ }

Implementations

impl<Stream: Read + Write + Safe, OldBindState> LdapConnection<Stream, OldBindState>

pub fn bind_simple_anonymously( self, ) -> Result<LdapConnection<Stream, BoundAnonymously>, SimpleBindError>

Binds the connection anonymously, aka without a password or username

For most servers, this leads to limited privileges

For unencrypted streams the “unsafe_” version of this function is available

pub fn bind_simple_unauthenticated( self, name: &str, ) -> Result<LdapConnection<Stream, BoundUnauthenticated>, UnauthenticatedBindError>

Binds the connection in the unauthenticated mode.

Default is for servers to reject this, but some may implement privileges for these kinds of connections

An empty username is invalid, use bind_simple_anonymously instead

For unencrypted streams the “unsafe_” version of this function is available

pub fn bind_simple_authenticated( self, name: &str, password: &[u8], ) -> Result<LdapConnection<Stream, BoundAuthenticated>, AuthenticatedBindError>

Binds the connection with simple auth

An empty username or password is invalid, use bind_simple_anonymously or bind_simple_unauthenticated instead

For unencrypted streams the “unsafe_” version of this function is available

impl<Stream: Read + Write, B: Bound> LdapConnection<Stream, B>

pub fn get_bind_diagnostics_message(&self) -> &str

impl<Stream, Bind> LdapConnection<Stream, Bind>

where Stream: Read + Write,

pub fn search<'connection, Output>( &'connection mut self, base: &str, scope: SearchRequestScope, deref_aliases: SearchRequestDerefAliases, filter: Filter, ) -> Result<SearchResults<'connection, Stream, Bind, Output>, Error>

where Output: FromEntry,

impl<Stream, Bind> LdapConnection<Stream, Bind>

where Stream: Read + Write,

pub fn unbind(self) -> Result<(), UnbindError>

impl LdapConnection<TcpStream, Unbound>

pub fn connect( addr: impl ToSocketAddrs, ) -> Result<LdapConnection<TcpStream, Unbound>, Error>

impl<Stream: Read + Write> LdapConnection<Stream, Unbound>

pub fn new_unbound(stream: Stream) -> LdapConnection<Stream, Unbound>

Start an LDAP connection over a custom stream.

If Stream is safe for transmitting passwords in cleartext, e.g. because it’s not interceptable or encrypted, the Safe trait will enable safe binding operations