Struct dryoc::auth::Auth

pub struct Auth { /* fields omitted */ }

secret-key authentication implementation based on Poly1305, compatible with libsodium’s crypto_Auth_* functions.

Implementations

impl Auth

pub fn compute<Key: ByteArray<CRYPTO_AUTH_KEYBYTES>, Input: Bytes, Output: NewByteArray<CRYPTO_AUTH_BYTES>>(
    key: Key,
    input: &Input
) -> Output

Single-part interface for Auth. Computes (and returns) the message authentication code for input using key. The key is consumed to prevent accidental re-use of the same key.

pub fn compute_to_vec<Key: ByteArray<CRYPTO_AUTH_KEYBYTES>, Input: Bytes>(
    key: Key,
    input: &Input
) -> Vec<u8>

Convience wrapper around Auth::compute. Returns the message authentication code as a Vec. The key is consumed to prevent accidental re-use of the same key.

pub fn compute_and_verify<OtherMac: ByteArray<CRYPTO_AUTH_BYTES>, Key: ByteArray<CRYPTO_AUTH_KEYBYTES>, Input: Bytes>(
    other_mac: &OtherMac,
    key: Key,
    input: &Input
) -> Result<(), Error>

Verifies the message authentication code other_mac matches the expected code for key and input. The key is consumed to prevent accidental re-use of the same key.

pub fn new<Key: ByteArray<CRYPTO_AUTH_KEYBYTES>>(key: Key) -> Self

Returns a new secret-key authenticator for key. The key is consumed to prevent accidental re-use of the same key.

pub fn update<Input: Bytes>(&mut self, input: &Input)

Updates the secret-key authenticator at self with input.

pub fn finalize<Output: NewByteArray<CRYPTO_AUTH_BYTES>>(self) -> Output

Finalizes this secret-key authenticator, returning the message authentication code.

pub fn finalize_to_vec(self) -> Vec<u8>

Finalizes this secret-key authenticator, returning the message authentication code as a Vec. Convenience wrapper around Auth::finalize.

pub fn verify<OtherMac: ByteArray<CRYPTO_AUTH_BYTES>>(
    self,
    other_mac: &OtherMac
) -> Result<(), Error>

Finalizes this authenticator, and verifies that the computed code matches other_mac using a constant-time comparison.