pkcs8/
version.rs

1//! PKCS#8 version identifier.
2
3use crate::Error;
4use der::{Decode, Encode, FixedTag, Reader, Tag, Tagged, Writer};
5
6/// Version identifier for PKCS#8 documents.
7///
8/// (RFC 5958 designates `0` and `1` as the only valid versions for PKCS#8 documents)
9#[derive(Clone, Debug, Copy, PartialEq, Eq)]
10pub enum Version {
11    /// Denotes PKCS#8 v1: no public key field.
12    V1 = 0,
13
14    /// Denotes PKCS#8 v2: `OneAsymmetricKey` with public key field.
15    V2 = 1,
16}
17
18impl Version {
19    /// Is this version expected to have a public key?
20    #[must_use]
21    pub fn has_public_key(self) -> bool {
22        match self {
23            Version::V1 => false,
24            Version::V2 => true,
25        }
26    }
27}
28
29impl<'a> Decode<'a> for Version {
30    type Error = der::Error;
31
32    fn decode<R: Reader<'a>>(reader: &mut R) -> der::Result<Self> {
33        Version::try_from(u8::decode(reader)?).map_err(|_| reader.error(Self::TAG.value_error()))
34    }
35}
36
37impl Encode for Version {
38    fn encoded_len(&self) -> der::Result<der::Length> {
39        der::Length::from(1u8).for_tlv(self.tag())
40    }
41
42    fn encode(&self, writer: &mut impl Writer) -> der::Result<()> {
43        u8::from(*self).encode(writer)
44    }
45}
46
47impl From<Version> for u8 {
48    fn from(version: Version) -> Self {
49        version as u8
50    }
51}
52
53impl TryFrom<u8> for Version {
54    type Error = Error;
55    fn try_from(byte: u8) -> Result<Version, Error> {
56        match byte {
57            0 => Ok(Version::V1),
58            1 => Ok(Version::V2),
59            _ => Err(Self::TAG.value_error().into()),
60        }
61    }
62}
63
64impl FixedTag for Version {
65    const TAG: Tag = Tag::Integer;
66}
pkcs8/version.rs

pkcs8/
version.rs
