mitrid_core 0.9.4

Core library of the Mitrid framework
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

//! # Authenticate
//!
//! `authenticate` is the module providing the trait used to implement cryptographic authentication.

use base::Result;
use base::ConstantSize;
use base::Datable;

/// Trait used by types that implements cryptographic authentication.
pub trait Authenticate<K, T>
    where   K: Datable + ConstantSize,
            T: Datable + ConstantSize
{
    /// Generates an authentication key.
    fn generate_key(&mut self) -> Result<K>;

    /// Authenticates cryptographhically the message using an authentication key
    /// and returning its authentication tag.
    fn authenticate(&mut self, msg: &[u8], key: &K) -> Result<T>;

    /// Verifies an authentication tag against a message using an authentication key.
    fn verify(&mut self, msg: &[u8], key: &K, tag: &T) -> Result<bool>;

    /// Checks an authentication tag against a message using an authentication key.
    fn check(&mut self, msg: &[u8], key: &K, tag: &T) -> Result<()>;
}