Struct X509Name
pub struct X509Name<'a> { /* private fields */ }
Expand description
X.509 Name (as used in Issuer
and Subject
fields)
The Name describes a hierarchical name composed of attributes, such as country name, and corresponding values, such as US. The type of the component AttributeValue is determined by the AttributeType; in general it will be a DirectoryString.
Implementations§
§impl<'a> X509Name<'a>
impl<'a> X509Name<'a>
pub const fn new(
rdn_seq: Vec<RelativeDistinguishedName<'a>>,
raw: &'a [u8],
) -> X509Name<'a>
pub const fn new( rdn_seq: Vec<RelativeDistinguishedName<'a>>, raw: &'a [u8], ) -> X509Name<'a>
Builds a new X509Name
from the provided elements.
pub fn to_string_with_registry(
&self,
oid_registry: &OidRegistry<'_>,
) -> Result<String, X509Error>
pub fn to_string_with_registry( &self, oid_registry: &OidRegistry<'_>, ) -> Result<String, X509Error>
Attempt to format the current name, using the given registry to convert OIDs to strings.
Note: a default registry is provided with this crate, and is returned by the
oid_registry()
method.
pub fn as_raw(&self) -> &'a [u8] ⓘ
pub fn iter(&self) -> impl Iterator<Item = &RelativeDistinguishedName<'a>>
pub fn iter(&self) -> impl Iterator<Item = &RelativeDistinguishedName<'a>>
Return an iterator over the RelativeDistinguishedName
components of the name
pub fn iter_rdn(&self) -> impl Iterator<Item = &RelativeDistinguishedName<'a>>
pub fn iter_rdn(&self) -> impl Iterator<Item = &RelativeDistinguishedName<'a>>
Return an iterator over the RelativeDistinguishedName
components of the name
pub fn iter_attributes(
&self,
) -> impl Iterator<Item = &AttributeTypeAndValue<'a>>
pub fn iter_attributes( &self, ) -> impl Iterator<Item = &AttributeTypeAndValue<'a>>
Return an iterator over the attribute types and values of the name
pub fn iter_by_oid(
&self,
oid: &Oid<'a>,
) -> impl Iterator<Item = &AttributeTypeAndValue<'a>>
pub fn iter_by_oid( &self, oid: &Oid<'a>, ) -> impl Iterator<Item = &AttributeTypeAndValue<'a>>
Return an iterator over the components identified by the given OID
The type of the component AttributeValue is determined by the AttributeType; in general it will be a DirectoryString.
Attributes with same OID may be present multiple times, so the returned object is an iterator. Expected number of objects in this iterator are
- 0: not found
- 1: present once (common case)
- 2 or more: attribute is present multiple times
pub fn iter_common_name(
&self,
) -> impl Iterator<Item = &AttributeTypeAndValue<'a>>
pub fn iter_common_name( &self, ) -> impl Iterator<Item = &AttributeTypeAndValue<'a>>
Return an iterator over the CommonName
attributes of the X.509 Name.
Returned iterator can be empty if there are no CommonName
attributes.
If you expect only one CommonName
to be present, then using next()
will
get an Option<&AttributeTypeAndValue>
.
A common operation is to extract the CommonName
as a string.
use x509_parser::x509::X509Name;
fn get_first_cn_as_str<'a>(name: &'a X509Name<'_>) -> Option<&'a str> {
name.iter_common_name()
.next()
.and_then(|cn| cn.as_str().ok())
}
Note that there are multiple reasons for failure or incorrect behavior, for ex. if the attribute is present multiple times, or is not a UTF-8 encoded string (it can be UTF-16, or even an OCTETSTRING according to the standard).
pub fn iter_country(&self) -> impl Iterator<Item = &AttributeTypeAndValue<'a>>
pub fn iter_country(&self) -> impl Iterator<Item = &AttributeTypeAndValue<'a>>
Return an iterator over the Country
attributes of the X.509 Name.
pub fn iter_organization(
&self,
) -> impl Iterator<Item = &AttributeTypeAndValue<'a>>
pub fn iter_organization( &self, ) -> impl Iterator<Item = &AttributeTypeAndValue<'a>>
Return an iterator over the Organization
attributes of the X.509 Name.
pub fn iter_organizational_unit(
&self,
) -> impl Iterator<Item = &AttributeTypeAndValue<'a>>
pub fn iter_organizational_unit( &self, ) -> impl Iterator<Item = &AttributeTypeAndValue<'a>>
Return an iterator over the OrganizationalUnit
attributes of the X.509 Name.
pub fn iter_state_or_province(
&self,
) -> impl Iterator<Item = &AttributeTypeAndValue<'a>>
pub fn iter_state_or_province( &self, ) -> impl Iterator<Item = &AttributeTypeAndValue<'a>>
Return an iterator over the StateOrProvinceName
attributes of the X.509 Name.
pub fn iter_locality(&self) -> impl Iterator<Item = &AttributeTypeAndValue<'a>>
pub fn iter_locality(&self) -> impl Iterator<Item = &AttributeTypeAndValue<'a>>
Return an iterator over the Locality
attributes of the X.509 Name.
pub fn iter_email(&self) -> impl Iterator<Item = &AttributeTypeAndValue<'a>>
pub fn iter_email(&self) -> impl Iterator<Item = &AttributeTypeAndValue<'a>>
Return an iterator over the EmailAddress
attributes of the X.509 Name.
Trait Implementations§
§impl<'a> From<X509Name<'a>> for Vec<RelativeDistinguishedName<'a>>
impl<'a> From<X509Name<'a>> for Vec<RelativeDistinguishedName<'a>>
§fn from(name: X509Name<'a>) -> Vec<RelativeDistinguishedName<'a>>
fn from(name: X509Name<'a>) -> Vec<RelativeDistinguishedName<'a>>
§impl<'a> FromIterator<RelativeDistinguishedName<'a>> for X509Name<'a>
impl<'a> FromIterator<RelativeDistinguishedName<'a>> for X509Name<'a>
§fn from_iter<T>(iter: T) -> X509Name<'a>where
T: IntoIterator<Item = RelativeDistinguishedName<'a>>,
fn from_iter<T>(iter: T) -> X509Name<'a>where
T: IntoIterator<Item = RelativeDistinguishedName<'a>>,
impl<'a> StructuralPartialEq for X509Name<'a>
Auto Trait Implementations§
impl<'a> Freeze for X509Name<'a>
impl<'a> RefUnwindSafe for X509Name<'a>
impl<'a> Send for X509Name<'a>
impl<'a> Sync for X509Name<'a>
impl<'a> Unpin for X509Name<'a>
impl<'a> UnwindSafe for X509Name<'a>
Blanket Implementations§
§impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
§impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
§impl<T> FutureExt for T
impl<T> FutureExt for T
§fn with_context(self, otel_cx: Context) -> WithContext<Self> ⓘ
fn with_context(self, otel_cx: Context) -> WithContext<Self> ⓘ
§fn with_current_context(self) -> WithContext<Self> ⓘ
fn with_current_context(self) -> WithContext<Self> ⓘ
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
§fn in_current_span(self) -> Instrumented<Self> ⓘ
fn in_current_span(self) -> Instrumented<Self> ⓘ
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read more§impl<T> Pointable for T
impl<T> Pointable for T
§impl<T> PolicyExt for Twhere
T: ?Sized,
impl<T> PolicyExt for Twhere
T: ?Sized,
§fn and<P, B, E>(self, other: P) -> And<T, P>
fn and<P, B, E>(self, other: P) -> And<T, P>
Policy
that returns Action::Follow
only if self
and other
return
Action::Follow
. Read more§impl<T, U> RamaTryInto<U> for Twhere
U: RamaTryFrom<T>,
impl<T, U> RamaTryInto<U> for Twhere
U: RamaTryFrom<T>,
type Error = <U as RamaTryFrom<T>>::Error
fn rama_try_into(self) -> Result<U, <U as RamaTryFrom<T>>::Error>
§impl<T, U> RamaTryInto<U> for Twhere
U: RamaTryFrom<T>,
impl<T, U> RamaTryInto<U> for Twhere
U: RamaTryFrom<T>,
type Error = <U as RamaTryFrom<T>>::Error
fn rama_try_into(self) -> Result<U, <U as RamaTryFrom<T>>::Error>
§impl<T> ToSmolStr for T
impl<T> ToSmolStr for T
fn to_smolstr(&self) -> SmolStr
§impl<T> ToStringFallible for Twhere
T: Display,
impl<T> ToStringFallible for Twhere
T: Display,
§fn try_to_string(&self) -> Result<String, TryReserveError>
fn try_to_string(&self) -> Result<String, TryReserveError>
ToString::to_string
, but without panic on OOM.