Embassy
embassy-stm32

Crates

git

Versions

stm32n657x0

Flavors

Skip to main content

AesGmac

embassy_stm32::saes

Struct AesGmac 

Source 
pub struct AesGmac<'c, const KEY_SIZE: usize> { /* private fields */ }
Expand description

AES-GMAC Cipher Mode (Galois Message Authentication Code)

GMAC provides message authentication without encryption. The data remains in plaintext but any tampering is detected via the authentication tag.

Implementations§

Source§

impl<'c, const KEY_SIZE: usize> AesGmac<'c, KEY_SIZE>

Source

pub fn new(key: &'c [u8; KEY_SIZE], iv: &'c [u8; 12]) -> Self

Constructs a new AES-GMAC cipher for message authentication. The IV should be 12 bytes long (96 bits) and unique per message.

Trait Implementations§

Source§

impl<'c, const KEY_SIZE: usize> Cipher<'c> for AesGmac<'c, KEY_SIZE>

Source§

const REQUIRES_PADDING: bool = false

Indicates whether the cipher requires the application to provide padding.
Source§

fn key(&self) -> &[u8]

Returns the symmetric key.
Source§

fn iv(&self) -> &[u8]

Returns the initialization vector.
Source§

fn chmod_bits(&self) -> u8

Returns the raw CHMOD field value for this cipher mode.
Source§

fn uses_gcm_phases(&self) -> bool

Indicates whether this cipher mode uses GCM/CCM phases (init, header, payload, final).
Source§

const BLOCK_SIZE: usize = AES_BLOCK_SIZE

Processing block size (always 16 bytes for AES).
Source§

fn key_size(&self) -> KeySize

Returns the key size.
Source§

fn datatype(&self) -> u8

Returns the data type setting for this cipher mode. Read more
Source§

fn is_ccm_mode(&self) -> bool

Indicates whether this is CCM mode (which has different final phase handling).
Source§

fn ccm_aad_header(&self) -> ([u8; 10], usize)

CCM only: the encoded associated-data length that precedes the associated data in the first header block (NIST SP 800-38C A.2.2), and its size. Empty for other modes and when there is no associated data.
Source§

impl<'c, const KEY_SIZE: usize> CipherAuthenticated<16> for AesGmac<'c, KEY_SIZE>

Source§

const TAG_SIZE: usize = TAG_SIZE

Defines the authentication tag size.
Source§

impl<'c> CipherSized for AesGmac<'c, { _ }>

Source§

impl<'c> CipherSized for AesGmac<'c, { _ }>

Source§

impl<'c> CipherSized for AesGmac<'c, { _ }>

Available on cryp only.
Source§

impl<'c, const KEY_SIZE: usize> IVSized for AesGmac<'c, KEY_SIZE>

Auto Trait Implementations§

§

impl<'c, const KEY_SIZE: usize> Freeze for AesGmac<'c, KEY_SIZE>
where &'c [u8; KEY_SIZE]: Freeze,

§

impl<'c, const KEY_SIZE: usize> RefUnwindSafe for AesGmac<'c, KEY_SIZE>
where &'c [u8; KEY_SIZE]: RefUnwindSafe,

§

impl<'c, const KEY_SIZE: usize> Send for AesGmac<'c, KEY_SIZE>
where &'c [u8; KEY_SIZE]: Send,

§

impl<'c, const KEY_SIZE: usize> Sync for AesGmac<'c, KEY_SIZE>
where &'c [u8; KEY_SIZE]: Sync,

§

impl<'c, const KEY_SIZE: usize> Unpin for AesGmac<'c, KEY_SIZE>
where &'c [u8; KEY_SIZE]: Unpin,

§

impl<'c, const KEY_SIZE: usize> UnsafeUnpin for AesGmac<'c, KEY_SIZE>
where &'c [u8; KEY_SIZE]: UnsafeUnpin,

§

impl<'c, const KEY_SIZE: usize> UnwindSafe for AesGmac<'c, KEY_SIZE>
where &'c [u8; KEY_SIZE]: UnwindSafe,

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<'c, C> Cipher<'c> for C
where C: Cipher<'c>,

Source§

const BLOCK_SIZE: usize = const BLOCK_SIZE: usize = <C as crate::crypto::Cipher::<'c>>::BLOCK_SIZE;

Processing block size. Determined by the processor and the algorithm.
Source§

const REQUIRES_PADDING: bool = const REQUIRES_PADDING: bool = <C as crate::crypto::Cipher::<'c>>::REQUIRES_PADDING;

Indicates whether the cipher requires the application to provide padding. If true, no partial blocks will be accepted (a panic will occur).
Source§

fn key(&self) -> &[u8]

Returns the symmetric key.
Source§

fn iv(&self) -> &[u8]

Returns the initialization vector.
Source§

fn set_algomode(&self, p: Cryp)

Sets the processor algorithm mode according to the associated cipher.
Source§

fn prepare_key(&self, p: Cryp, dir: Direction)

Performs any key preparation within the processor, if necessary.
Source§

fn init_phase_blocking<T, M>(&self, p: Cryp, _cryp: &Cryp<'_, T, M>)
where T: Instance, M: Mode,

Performs any cipher-specific initialization.
Source§

async fn init_phase<T>(&self, p: Cryp, cryp: &mut Cryp<'_, T, Async>)
where T: Instance,

Performs any cipher-specific initialization.
Source§

fn pre_final(&self, p: Cryp, dir: Direction, _padding_len: usize) -> [u32; 4]

Called prior to processing the last data block for cipher-specific operations.
Source§

fn post_final_blocking<T, M>( &self, p: Cryp, cryp: &Cryp<'_, T, M>, dir: Direction, int_data: &mut [u8; 16], temp1: [u32; 4], padding_mask: [u8; 16], )
where T: Instance, M: Mode,

Called after processing the last data block for cipher-specific operations.
Source§

async fn post_final<T>( &self, p: Cryp, cryp: &mut Cryp<'_, T, Async>, dir: Direction, int_data: &mut [u8; 16], temp1: [u32; 4], padding_mask: [u8; 16], )
where T: Instance,

Called after processing the last data block for cipher-specific operations.
Source§

fn get_header_block(&self) -> ([u8; 10], usize)

Returns the AAD header block as required by the cipher.
Source§

fn ccm_ctr0(&self) -> Option<[u8; 16]>

CCM only: the counter block with the counter at zero, which the final phase feeds to the core instead of the GCM lengths block.
Source§

impl<const TAG_SIZE: usize, C> CipherAuthenticated<TAG_SIZE> for C
where C: CipherAuthenticated<TAG_SIZE>,

Source§

const TAG_SIZE: usize = TAG_SIZE

Defines the authentication tag size.
Source§

impl<C> CipherSized for C
where C: CipherSized,

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<C> IVSized for C
where C: IVSized,

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.