httpsig 0.0.24

Implementation of IETF RFC 9421 of http message signatures
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

mod asymmetric;
mod symmetric;

use crate::error::{HttpSigError, HttpSigResult};

pub use asymmetric::{PublicKey, SecretKey};
pub use symmetric::SharedKey;

#[derive(Debug, PartialEq, Eq)]
/// Algorithm names
pub enum AlgorithmName {
  HmacSha256,
  EcdsaP256Sha256,
  EcdsaP384Sha384,
  Ed25519,
  #[cfg(feature = "rsa-signature")]
  RsaV1_5Sha256,
  #[cfg(feature = "rsa-signature")]
  RsaPssSha512,
}

impl AlgorithmName {
  pub fn as_str(&self) -> &'static str {
    match self {
      AlgorithmName::HmacSha256 => "hmac-sha256",
      AlgorithmName::EcdsaP256Sha256 => "ecdsa-p256-sha256",
      AlgorithmName::EcdsaP384Sha384 => "ecdsa-p384-sha384",
      AlgorithmName::Ed25519 => "ed25519",
      #[cfg(feature = "rsa-signature")]
      AlgorithmName::RsaV1_5Sha256 => "rsa-v1_5-sha256",
      #[cfg(feature = "rsa-signature")]
      AlgorithmName::RsaPssSha512 => "rsa-pss-sha512",
    }
  }
}

impl std::fmt::Display for AlgorithmName {
  fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
    write!(f, "{}", self.as_str())
  }
}

impl core::str::FromStr for AlgorithmName {
  type Err = HttpSigError;

  fn from_str(s: &str) -> Result<Self, Self::Err> {
    match s {
      "hmac-sha256" => Ok(Self::HmacSha256),
      "ecdsa-p256-sha256" => Ok(Self::EcdsaP256Sha256),
      "ecdsa-p384-sha384" => Ok(Self::EcdsaP384Sha384),
      "ed25519" => Ok(Self::Ed25519),
      #[cfg(feature = "rsa-signature")]
      "rsa-v1_5-sha256" => Ok(Self::RsaV1_5Sha256),
      #[cfg(feature = "rsa-signature")]
      "rsa-pss-sha512" => Ok(Self::RsaPssSha512),
      _ => Err(HttpSigError::InvalidAlgorithmName(s.to_string())),
    }
  }
}

/// SigningKey trait
pub trait SigningKey {
  fn sign(&self, data: &[u8]) -> HttpSigResult<Vec<u8>>;
  fn key_id(&self) -> String;
  fn alg(&self) -> AlgorithmName;
}

/// VerifyingKey trait
pub trait VerifyingKey {
  fn verify(&self, data: &[u8], signature: &[u8]) -> HttpSigResult<()>;
  fn key_id(&self) -> String;
  fn alg(&self) -> AlgorithmName;
}