Struct SerialNumber 

pub struct SerialNumber { /* private fields */ }

A Certificate serial number, potentially non-unique, set by the certificate issuer.

X509 serial numbers are variable length byte arrays defined in RFC 5280 as up to 20 bytes (“octets”):

Certificate users MUST be able to handle serialNumber values up to 20 octets. Conforming CAs MUST NOT use serialNumber values longer than 20 octets.

This implementation accepts a serial number of arbitrary length as a byte array (as apposed to a using a fixed sized integer) up to a maximum of the specified 20 bytes. Users of this type MUST account for the variable length nature when storing or transmitting this value.

When rendered to a string (with Display or SerialNumber::as_hex_str()) this type formats the serial number as a colon delimited, lowercase hex string following the convention of the OpenSSL representation of serial numbers (example: cc:cb:0f:63:f1:63:5e:f1:0e:26:e8:82:f7:7a:6e:f9).

Not Uniquely Identifying

Serial numbers are set by the certificate issuer. A certificate issuer SHOULD use a unique serial number for each certificate it issues, but code MUST NOT rely on a SerialNumber to uniquely identify a specific certificate as it can be re-used if the issuer is compromised.

Implementations

impl SerialNumber

pub fn as_hex_str(&self) -> &str

Render the SerialNumber as a lowercase hex string delimited by colons in the style of OpenSSL.

Example: cc:cb:0f:63:f1:63:5e:f1:0e:26:e8:82:f7:7a:6e:f9

This value is lazily rendered and cached for reuse.

pub fn as_bytes(&self) -> &[u8]

Return the raw serial number bytes.

Trait Implementations

impl Clone for SerialNumber

fn clone(&self) -> SerialNumber

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SerialNumber

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

Formats the value using the given formatter.

impl Display for SerialNumber

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

Formats the value using the given formatter.

impl<'a> From<&'a SerialNumber> for SerialNumber

fn from(value: &'a SerialNumber) -> Self

Converts to this type from the input type.

impl<'a> From<&'a X509Certificate<'a>> for SerialNumber

fn from(cert: &'a X509Certificate<'a>) -> Self

Converts to this type from the input type.

impl Valuable for SerialNumber

Render a SerialNumber as an encoded string in structured logging.

fn as_value(&self) -> Value<'_>

Converts self into a Value instance.

fn visit(&self, visit: &mut dyn Visit)

Calls the relevant method on Visit to extract data from self.

fn visit_slice(slice: &[Self], visit: &mut dyn Visit)

where Self: Sized,

Calls Visit::visit_primitive_slice() with self.