7 unstable releases

0.4.0 Feb 29, 2024
0.3.0 May 30, 2022
0.2.0 Sep 13, 2021
0.1.3 Feb 8, 2021
0.1.2 Nov 29, 2020

#2110 in Parser implementations

Download history 24/week @ 2024-02-05 174/week @ 2024-02-26 16/week @ 2024-03-04 31/week @ 2024-03-11 129/week @ 2024-04-01

162 downloads per month

MIT/Apache

75KB
1K SLoC

License: MIT Apache License 2.0 docs.rs crates.io Github CI Minimum rustc version

LDAP Parser

A Lightweight Directory Access Protocol (LDAP) (RFC4511) parser, implemented with the nom parser combinator framework.

It is written in pure Rust, fast, and makes extensive use of zero-copy. A lot of care is taken to ensure security and safety of this crate, including design (recursion limit, defensive programming), tests, and fuzzing. It also aims to be panic-free.

The code is available on Github and is part of the Rusticata project.

Examples

Parsing an LDAP message (in BER format):

use ldap_parser::parse_ldap_message;
use ldap_parser::ldap::{MessageID, ProtocolOp, ProtocolOpTag};

static DATA: &[u8] = include_bytes!("../assets/message-search-request-01.bin");

let res = parse_ldap_message(DATA);
match res {
    Ok((rem, msg)) => {
        assert!(rem.is_empty());
        //
        assert_eq!(msg.message_id, MessageID(4));
        assert_eq!(msg.protocol_op.tag(), ProtocolOpTag::SearchRequest);
        match msg.protocol_op {
            ProtocolOp::SearchRequest(req) => {
                assert_eq!(req.base_object.0, "dc=rccad,dc=net");
            },
            _ => panic!("Unexpected message type"),
        }
    },
    _ => panic!("LDAP parsing failed: {:?}", res),
}

Changes

See CHANGELOG.md

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~1.7–2.4MB
~48K SLoC