Crate ldap_utils

ldap-utils

Implements some LDAP utility functionality around OpenLDAP config files and the ldap3 Rust library

Structs

ConnectParameters

a set of parameters for connecting to an LDAP server, including client-side certificate auth support

ConnectParametersBuilder

Builder for ConnectParameters.

OIDError

an error type in case parsing an OID fails when querying the RootDSE from ldap3 during the parsing of supported controls, extensions and features

Enums

ConnectError

errors which can happen when connecting to an LDAP server

ConnectParametersBuilderError

Error type for ConnectParametersBuilder

LdapOperationError

an error during normal ldap operations (search, add, modify, update, delete,…)

LdapSchemaError

error which can happen while retrieving and parsing the LDAP schema

OpenLdapConnectParameterError

errors which can happen when trying to retrieve connect parameters from openldap config

ScopeParserError

error which can occur while parsing a scope

TomlConfigError

error which can happen while reading connect parameters from a file

Functions

apply_ldap_operations

apply the LDAP operations on a given LDAP server.

connect

try to connect to an LDAP server using ldap3 using the OpenLDAP config files supplemented by hardcoded default values

connect_with_parameters

connect to an LDAP server using ldap3 with the given set of default parameters

default_connect_parameters

fill the builder with hardcoded default parameters

delete_recursive

delete an LDAP entry recursively using ldap3

diff_entries

diff two sets of LDAPEntries which had their base DNs removed and generates LDAP operations (add, update, delete) to apply to the destination to make it identical to the source

ldap_search

perform an LDAP search via ldap3, logging a proper error message if it fails and returning an iterator to already unwrapped search entries

mod_value

generate an ldap3::Mod if there is a DN-valued attribute in the source entry that needs its base DN translated to the destination base DN

mods_as_bin_mods

of the same modify operation because otherwise we might successfully apply the textual modifications and then fail on the binary ones, leaving behind a half-modified object

noop_control

creates a noop_control object for use with ldap3

openldap_connect_parameters

try to detect OpenLDAP connect parameters from its config files (ldap.conf in /etc/ldap or /etc/openldap and .ldaprc in the user home dir)

parse_scope

parse an ldap3::Scope from the string one would specify to use the same scope with OpenLDAP’s ldapsearch -s parameter

query_ldap_schema

Retrieve the LDAP schema from an LDAP server using ldap3

query_root_dse

retrieve the RootDSE from an LDAP server using ldap3

search_entries

helper function to search an LDAP server and generate LDAPEntry values with the base DN removed to make them server-independent

success_or_noop_success

check if an ldap3::LdapResult is either a success or the success code returned by an operation using the noop_control

toml_connect_parameters

load ldap connect parameters from a toml file