Struct rustls::anchors::RootCertStore

source ·
pub struct RootCertStore {
    pub roots: Vec<OwnedTrustAnchor>,
}
Expand description

A container for root certificates able to provide a root-of-trust for connection authentication.

Fields§

§roots: Vec<OwnedTrustAnchor>

The list of roots.

Implementations§

source§

impl RootCertStore

source

pub fn empty() -> Self

Make a new, empty RootCertStore.

source

pub fn is_empty(&self) -> bool

Return true if there are no certificates.

source

pub fn len(&self) -> usize

Say how many certificates are in the container.

source

pub fn add(&mut self, der: &Certificate) -> Result<(), Error>

Add a single DER-encoded certificate to the store.

This is suitable for a small set of root certificates that are expected to parse successfully. For large collections of roots (for example from a system store) it is expected that some of them might not be valid according to the rules rustls implements. As long as a relatively limited number of certificates are affected, this should not be a cause for concern. Use RootCertStore::add_parsable_certificates in order to add as many valid roots as possible and to understand how many certificates have been diagnosed as malformed.

source

pub fn add_trust_anchors( &mut self, trust_anchors: impl Iterator<Item = OwnedTrustAnchor>, )

Adds all the given TrustAnchors anchors. This does not fail.

source

pub fn add_server_trust_anchors( &mut self, trust_anchors: impl Iterator<Item = OwnedTrustAnchor>, )

👎Deprecated since 0.21.6: Please use add_trust_anchors instead

Adds all the given TrustAnchors anchors. This does not fail.

source

pub fn add_parsable_certificates( &mut self, der_certs: &[impl AsRef<[u8]>], ) -> (usize, usize)

Parse the given DER-encoded certificates and add all that can be parsed in a best-effort fashion.

This is because large collections of root certificates often include ancient or syntactically invalid certificates.

Returns the number of certificates added, and the number that were ignored.

source

fn add_internal(&mut self, der: &[u8]) -> Result<(), Error>

Trait Implementations§

source§

impl Clone for RootCertStore

source§

fn clone(&self) -> RootCertStore

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl Debug for RootCertStore

source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.