Struct X509CertificateParser

pub struct X509CertificateParser { /* private fields */ }

Available on crate feature mtls only.

X.509 Certificate parser

This object is a parser builder, and allows specifying parsing options. Currently, the only option is to control deep parsing of X.509v3 extensions: a parser can decide to skip deep-parsing to be faster (the structure of extensions is still parsed, and the contents can be parsed later using the from_der method from individual extension objects).

This object uses the nom::Parser trait, which must be imported.

Example

To parse a certificate without parsing extensions:

use x509_parser::certificate::X509CertificateParser;
use x509_parser::nom::Parser;

// create a parser that will not parse extensions
let mut parser = X509CertificateParser::new()
    .with_deep_parse_extensions(false);
let res = parser.parse(DER);
match res {
    Ok((_rem, x509)) => {
        let subject = x509.subject();
        let issuer = x509.issuer();
        println!("X.509 Subject: {}", subject);
        println!("X.509 Issuer: {}", issuer);
    },
    _ => panic!("x509 parsing failed: {:?}", res),
}

Implementations

impl X509CertificateParser

pub const fn new() -> X509CertificateParser

pub const fn with_deep_parse_extensions( self, deep_parse_extensions: bool, ) -> X509CertificateParser

Trait Implementations

impl Clone for X509CertificateParser

fn clone(&self) -> X509CertificateParser

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for X509CertificateParser

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'a> Parser<&'a [u8], X509Certificate<'a>, X509Error> for X509CertificateParser

fn parse( &mut self, input: &'a [u8], ) -> Result<(&'a [u8], X509Certificate<'a>), Err<X509Error>>

A parser takes in input type, and returns a Result containing either the remaining input and the output value, or an error

fn map<G, O2>(self, g: G) -> Map<Self, G, O>

where G: Fn(O) -> O2, Self: Sized,

Maps a function over the result of a parser

fn flat_map<G, H, O2>(self, g: G) -> FlatMap<Self, G, O>

where G: FnMut(O) -> H, H: Parser<I, O2, E>, Self: Sized,

Creates a second parser from the output of the first one, then apply over the rest of the input

fn and_then<G, O2>(self, g: G) -> AndThen<Self, G, O>

where G: Parser<O, O2, E>, Self: Sized,

Applies a second parser over the output of the first one

fn and<G, O2>(self, g: G) -> And<Self, G>

where G: Parser<I, O2, E>, Self: Sized,

Applies a second parser after the first one, return their results as a tuple

fn or<G>(self, g: G) -> Or<Self, G>

where G: Parser<I, O, E>, Self: Sized,

Applies a second parser over the input if the first one failed

fn into<O2, E2>(self) -> Into<Self, O, O2, E, E2>

where O2: From<O>, E2: From<E>, Self: Sized,

automatically converts the parser’s output and error values to another type, as long as they implement the From trait

impl Copy for X509CertificateParser