tss-esapi 8.0.0-alpha.3

Rust-native wrapper around TSS 2.0 Enhanced System API
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79

// Copyright 2024 Contributors to the Parsec project.
// SPDX-License-Identifier: Apache-2.0

use crate::interface_types::algorithm::HashingAlgorithm;

#[cfg(feature = "rustcrypto")]
use {
    crate::{Error, Result, WrapperErrorKind, structures::HashAgile},
    digest::{Output, OutputSizeUser},
};

/// Provides the value of the digest used in this crate for the digest.
pub trait AssociatedHashingAlgorithm {
    /// Value of the digest when interacting with the TPM.
    const TPM_DIGEST: HashingAlgorithm;
}

#[cfg(feature = "sha1")]
impl AssociatedHashingAlgorithm for sha1::Sha1 {
    const TPM_DIGEST: HashingAlgorithm = HashingAlgorithm::Sha1;
}

#[cfg(feature = "sha2")]
impl AssociatedHashingAlgorithm for sha2::Sha256 {
    const TPM_DIGEST: HashingAlgorithm = HashingAlgorithm::Sha256;
}

#[cfg(feature = "sha2")]
impl AssociatedHashingAlgorithm for sha2::Sha384 {
    const TPM_DIGEST: HashingAlgorithm = HashingAlgorithm::Sha384;
}

#[cfg(feature = "sha2")]
impl AssociatedHashingAlgorithm for sha2::Sha512 {
    const TPM_DIGEST: HashingAlgorithm = HashingAlgorithm::Sha512;
}

#[cfg(feature = "sm3")]
impl AssociatedHashingAlgorithm for sm3::Sm3 {
    const TPM_DIGEST: HashingAlgorithm = HashingAlgorithm::Sm3_256;
}

#[cfg(feature = "sha3")]
impl AssociatedHashingAlgorithm for sha3::Sha3_256 {
    const TPM_DIGEST: HashingAlgorithm = HashingAlgorithm::Sha3_256;
}

#[cfg(feature = "sha3")]
impl AssociatedHashingAlgorithm for sha3::Sha3_384 {
    const TPM_DIGEST: HashingAlgorithm = HashingAlgorithm::Sha3_384;
}

#[cfg(feature = "sha3")]
impl AssociatedHashingAlgorithm for sha3::Sha3_512 {
    const TPM_DIGEST: HashingAlgorithm = HashingAlgorithm::Sha3_512;
}

impl HashAgile {
    #[cfg(feature = "rustcrypto")]
    #[expect(
        clippy::unnecessary_fallible_conversions,
        reason = "GenericArray::From<&[T]> will panic if the payload is not the same length"
    )]
    /// Return the hash content of the [`HashAgile`]
    ///
    /// # Errors
    ///
    /// Return an error if the specified [`AssociatedHashingAlgorithm`] is not the
    /// one in the [`HashAgile`].
    pub fn to_output<H: AssociatedHashingAlgorithm + OutputSizeUser>(&self) -> Result<Output<H>> {
        if self.algorithm == H::TPM_DIGEST {
            <&Output<H>>::try_from(self.digest.as_bytes())
                .map_err(|_| Error::local_error(WrapperErrorKind::WrongValueFromTpm))
                .cloned()
        } else {
            Err(Error::local_error(WrapperErrorKind::InvalidParam))
        }
    }
}