Struct AuthenticationTag

pub struct AuthenticationTag(/* private fields */);

The authentication tag produced by the encryption process to verify message integrity.

An AuthenticationTag is a 16-byte value generated during ChaCha20-Poly1305 authenticated encryption. It serves as a message authentication code (MAC) that verifies both the authenticity and integrity of the encrypted message.

During decryption, the tag is verified to ensure:

• The message has not been tampered with (integrity)
• The message was encrypted by someone who possesses the encryption key (authenticity)

This implementation follows the Poly1305 MAC algorithm as specified in RFC-8439.

Implementations

impl AuthenticationTag

pub const AUTHENTICATION_TAG_SIZE: usize = 16usize

pub const fn from_data(data: [u8; 16]) -> Self

Restore an AuthenticationTag from a fixed-size array of bytes.

pub fn from_data_ref(data: impl AsRef<[u8]>) -> Result<Self>

Restore an AuthenticationTag from a reference to an array of bytes.

pub fn data(&self) -> &[u8; 16]

Get a reference to the fixed-size array of bytes.

Trait Implementations

impl AsRef<AuthenticationTag> for AuthenticationTag

Implements AsRef<AuthenticationTag> to allow self-reference.

fn as_ref(&self) -> &AuthenticationTag

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for AuthenticationTag

fn clone(&self) -> AuthenticationTag

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AuthenticationTag

Implements Debug formatting to display the tag in hexadecimal format.

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<&[u8]> for AuthenticationTag

Implements conversion from a byte slice to an AuthenticationTag.

fn from(data: &[u8]) -> Self

Converts to this type from the input type.

impl<'a> From<&'a AuthenticationTag> for &'a [u8; 16]

Implements conversion from an AuthenticationTag reference to a byte array reference.

fn from(value: &'a AuthenticationTag) -> Self

Converts to this type from the input type.

impl From<[u8; 16]> for AuthenticationTag

Implements conversion from a fixed-size byte array to an AuthenticationTag.

fn from(data: [u8; 16]) -> Self

Converts to this type from the input type.

impl From<AuthenticationTag> for CBOR

Implements conversion from AuthenticationTag to CBOR for serialization.

fn from(value: AuthenticationTag) -> Self

Converts to this type from the input type.

impl From<Rc<AuthenticationTag>> for AuthenticationTag

Implements conversion from a reference-counted AuthenticationTag to an owned AuthenticationTag.

fn from(value: Rc<AuthenticationTag>) -> Self

Converts to this type from the input type.

impl From<Vec<u8>> for AuthenticationTag

Implements conversion from a byte vector to an AuthenticationTag.

fn from(data: Vec<u8>) -> Self

Converts to this type from the input type.

impl PartialEq for AuthenticationTag

fn eq(&self, other: &AuthenticationTag) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl TryFrom<CBOR> for AuthenticationTag

Implements conversion from CBOR to AuthenticationTag for deserialization.

type Error = Error

The type returned in the event of a conversion error.

fn try_from(cbor: CBOR) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for AuthenticationTag

impl StructuralPartialEq for AuthenticationTag