Struct yaca::SignContext

pub struct SignContext { /* fields omitted */ }

Context for Sign operations

Implementations

impl SignContext

pub fn initialize(algo: &DigestAlgorithm, prv_key: &Key) -> Result<SignContext>

Initializes a signature context for asymmetric signatures

• algo is a digest algorithm that will be used.
• prv_key is a private key that will be used, algorithm is deduced based on key type, supported key types:
  • KeyType::RsaPrivate,
  • KeyType::DsaPrivate,
  • KeyType::EcPrivate.
• For verification use VerifyContext with matching public key.
• For RSA operations the default padding used is Padding::Pkcs1. It can be changed using CtxPad::set_property_padding().
• For DigestAlgorithm::Sha384 and DigestAlgorithm::Sha512 the RSA key size must be bigger than 512 bits.
• Using DigestAlgorithm::Md5 algorithm for DSA and ECDSA operations is prohibited.
• Using DigestAlgorithm::Md5 or DigestAlgorithm::Sha224 with Padding::X931 is prohibited.

pub fn initialize_hmac(
    algo: &DigestAlgorithm,
    sym_key: &Key
) -> Result<SignContext>

Initializes a signature context for HMAC

• algo is a digest algorithm that will be used.
• sym_key is a key that will be used, supported key types:
  • KeyType::Symmetric,
  • KeyType::Des.
• For verification, calculate message HMAC and compare with received MAC using Yaca::memcmp().

pub fn initialize_cmac(
    algo: &EncryptAlgorithm,
    sym_key: &Key
) -> Result<SignContext>

Initializes a signature context for CMAC

• algo is an encryption algorithm that will be used.
• sym_key is a key that will be used, supported key types:
  • KeyType::Symmetric,
  • KeyType::Des.
• For verification, calculate message CMAC and compare with received MAC using Yaca::memcmp().

pub fn update(&self, message: &[u8]) -> Result<()>

Feeds the message into the digital signature or MAC algorithm

• message is a chunk of data to calculate signature or MAC from.

pub fn finalize(&self) -> Result<Vec<u8>>

Calculates the final signature or MAC

• Returns the calculated signature or MAC.
• Skipping SignContext::update() and calling only SignContext::finalize() will produce a signature or MAC of an empty message.

Trait Implementations

impl ContextWithPadding for SignContext

pub fn set_property_padding(&self, padding: &Padding) -> Result<()>

Sets the Padding property

impl Drop for SignContext

pub fn drop(&mut self)

Executes the destructor for this type.