ldap-client 0.6.0

Async LDAPv3 client for Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

// SPDX-License-Identifier: MIT OR Apache-2.0

use ldap_client_proto::ResultCode;

#[derive(Debug, thiserror::Error)]
pub enum Error {
    #[error("I/O error: {0}")]
    Io(#[from] std::io::Error),

    #[error("BER error: {0}")]
    Ber(#[from] ldap_client_ber::BerError),

    #[error("protocol error: {0}")]
    Proto(#[from] ldap_client_proto::ProtoError),

    #[error("TLS error: {0}")]
    Tls(#[from] rustls::Error),

    #[error("invalid URL: {0}")]
    InvalidUrl(String),

    #[error("LDAP error: {code} - {message}")]
    Ldap {
        code: ResultCode,
        message: String,
        matched_dn: String,
    },

    #[error("referral to {}", urls.join(", "))]
    Referral {
        result: ldap_client_proto::LdapResult,
        urls: Vec<String>,
    },

    #[error("connection closed")]
    ConnectionClosed,

    #[error("timeout")]
    Timeout,

    #[error("StartTLS failed: {0}")]
    StartTls(String),

    #[error("search returned multiple results when at most one was expected")]
    MultipleResults,

    #[error("referral hop limit exceeded")]
    ReferralHopLimitExceeded,

    #[error("search result entry limit exceeded ({0})")]
    SearchEntryLimitExceeded(usize),
}

impl Error {
    pub fn ldap(result: &ldap_client_proto::LdapResult) -> Self {
        Self::Ldap {
            code: result.code,
            message: result.diagnostic_message.clone(),
            matched_dn: result.matched_dn.clone(),
        }
    }

    pub fn result_code(&self) -> Option<ResultCode> {
        match self {
            Self::Ldap { code, .. } => Some(*code),
            Self::Referral { result, .. } => Some(result.code),
            _ => None,
        }
    }
}