Struct SerialNumber 

pub struct SerialNumber<P = Rfc5280>
where
    P: Profile,
{ /* private fields */ }

[RFC 5280 Section 4.1.2.2.] Serial Number

The serial number MUST be a positive integer assigned by the CA to each certificate. It MUST be unique for each certificate issued by a given CA (i.e., the issuer name and serial number identify a unique certificate). CAs MUST force the serialNumber to be a non-negative integer.

Given the uniqueness requirements above, serial numbers can be expected to contain long integers. Certificate users MUST be able to handle serialNumber values up to 20 octets. Conforming CAs MUST NOT use serialNumber values longer than 20 octets.

Note: Non-conforming CAs may issue certificates with serial numbers that are negative or zero. Certificate users SHOULD be prepared to gracefully handle such certificates.

Implementations

impl<P> SerialNumber<P>

where P: Profile,

pub const MAX_LEN: Length

Maximum length in bytes for a SerialNumber

pub fn new(bytes: &[u8]) -> Result<SerialNumber<P>, Error>

Create a new SerialNumber from a byte slice.

The byte slice must represent a positive integer.

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

Borrow the inner byte slice which contains the least significant bytes of a big endian integer value with all leading zeros stripped.

impl<P> SerialNumber<P>

where P: Profile,

pub fn generate<R>(rng: &mut R) -> SerialNumber<P>

where R: CryptoRng + ?Sized,

Generates a random serial number from RNG.

This follows the recommendation the CAB forum ballot 164 and uses a minimum of 64 bits of output from the CSPRNG. This currently defaults to a 17-bytes long serial number.

pub fn generate_with_prefix<R>( prefix: &[u8], rand_len: usize, rng: &mut R, ) -> Result<SerialNumber<P>, Error>

where R: CryptoRng + ?Sized,

Generates a random serial number from RNG. Include a prefix value.

This follows the recommendation the CAB forum ballot 164 and uses a minimum of 64 bits of output from the CSPRNG.

The specified length does not include the length of the prefix, the maximum length must be equal or below 19 (to account for leading sign disambiguation, and the maximum length of 20).

Trait Implementations

impl<P> Clone for SerialNumber<P>

where P: Clone + Profile,

fn clone(&self) -> SerialNumber<P>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<P> Debug for SerialNumber<P>

where P: Debug + Profile,

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

Formats the value using the given formatter.

impl<'a, P> DecodeValue<'a> for SerialNumber<P>

where P: Profile,

type Error = Error

Type returned in the event of a decoding error.

fn decode_value<R>( reader: &mut R, header: Header, ) -> Result<SerialNumber<P>, Error>

where R: Reader<'a>,

Attempt to decode this value using the provided Reader.

impl Display for SerialNumber

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

Formats the value using the given formatter.

impl<P> EncodeValue for SerialNumber<P>

where P: Profile,

fn value_len(&self) -> Result<Length, Error>

Compute the length of this value (sans [Tag]+Length header) when encoded as ASN.1 DER.

fn encode_value(&self, writer: &mut impl Writer) -> Result<(), Error>

Encode value (sans [Tag]+Length header) as ASN.1 DER using the provided Writer.

fn header(&self) -> Result<Header, Error>

where Self: Tagged,

Get the Header used to encode this value.

impl<P> Eq for SerialNumber<P>

where P: Eq + Profile,

impl<P> FixedTag for SerialNumber<P>

where P: Profile,

const TAG: Tag = <Int as FixedTag>::TAG

ASN.1 tag

impl From<u8> for SerialNumber

fn from(inner: u8) -> SerialNumber

Converts to this type from the input type.

impl From<u16> for SerialNumber

fn from(inner: u16) -> SerialNumber

Converts to this type from the input type.

impl From<u32> for SerialNumber

fn from(inner: u32) -> SerialNumber

Converts to this type from the input type.

impl From<u64> for SerialNumber

fn from(inner: u64) -> SerialNumber

Converts to this type from the input type.

impl From<usize> for SerialNumber

fn from(inner: usize) -> SerialNumber

Converts to this type from the input type.

impl<P> Ord for SerialNumber<P>

where P: Ord + Profile,

fn cmp(&self, other: &SerialNumber<P>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl<P> PartialEq for SerialNumber<P>

where P: PartialEq + Profile,

fn eq(&self, other: &SerialNumber<P>) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl<P> PartialOrd for SerialNumber<P>

where P: PartialOrd + Profile,

fn partial_cmp(&self, other: &SerialNumber<P>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<P> StructuralPartialEq for SerialNumber<P>

where P: PartialEq + Profile,

impl<P> ValueOrd for SerialNumber<P>

where P: Profile,

fn value_cmp(&self, other: &SerialNumber<P>) -> Result<Ordering, Error>

Return an Ordering between value portion of TLV-encoded self and other when serialized as ASN.1 DER.