rfc2253-rust
============

A small rust library that parses [RFC2253](https://www.ietf.org/rfc/rfc2253.txt)
encoded distinguished name strings. You can use this to decode the output of
openssl's `x509_NAME_print_ex(..., XN_FLAG_RFC2253)` or nginx's `$ssl_client_s_dn`
and `$ssl_client_i_dn` variables.


Usage
-----

Add this to your `Cargo.toml` file:

    [dependencies]
    rfc2253 = "*"

The example below shows how to parse a RFC2253 encoded distinguished name.

    extern crate rfc2253;

    fn main() {
      let dn_str = "C=DE,CN=Hans Tester,OU=ACME Inc.,O=ACME Inc.,L=Berlin,ST=Berlin";
      let dn = rfc2253::parse_distinguished_name_str(dn_str).unwrap();

      println!("{:?}", dn);
      assert!(dn.attributes.len() == 6);
      assert!(dn.attributes.get("CN").unwrap() == "Hans Tester");
      assert!(dn.attributes.get("C").unwrap() == "DE");
      assert!(dn.attributes.get("L").unwrap() == "Berlin");
      assert!(dn.attributes.get("ST").unwrap() == "Berlin");
      assert!(dn.attributes.get("O").unwrap() == "ACME Inc.");
      assert!(dn.attributes.get("OU").unwrap() == "ACME Inc.");
    }


Build
-----

To build the `rfc2253-rust` library, run `cargo build`:

    $ cd rfc2253-rust
    $ cargo build

After you have made any changes to the code, run the test suite by executing
`cargo test`:

    $ cd rfc2253-rust
    $ cargo test


License
-------

    Copyright © 2018 Nyantec GmbH <oss@nyantec.com>

    Authors:
      Paul Asmuth <asm@nyantec.com>

    Provided that these terms and disclaimer and all copyright notices
    are retained or reproduced in an accompanying document, permission
    is granted to deal in this work without restriction, including un‐
    limited rights to use, publicly perform, distribute, sell, modify,
    merge, give away, or sublicence.

    This work is provided “AS IS” and WITHOUT WARRANTY of any kind, to
    the utmost extent permitted by applicable law, neither express nor
    implied; without malicious intent or gross negligence. In no event
    may a licensor, author or contributor be held liable for indirect,
    direct, other damage, loss, or other issues arising in any way out
    of dealing in the work, even if advised of the possibility of such
    damage or existence of a defect, except proven that it results out
    of said person’s immediate fault when using the work as intended.