Crate aead

RustCrypto: Authenticated Encryption with Additional Data Traits

This crate provides an abstract interface for AEAD ciphers, which guarantee both confidentiality and integrity, even from a powerful attacker who is able to execute chosen-ciphertext attacks. The resulting security property, ciphertext indistinguishability, is considered a basic requirement for modern cryptographic implementations.

See RustCrypto/AEADs for cipher implementations which use this trait.

Documentation

Minimum Supported Rust Version

Rust 1.65 or higher.

Minimum supported Rust version can be changed in the future, but it will be done with a minor version bump.

SemVer Policy

• All on-by-default features of this library are covered by SemVer
• MSRV is considered exempt from SemVer as noted above

License

Licensed under either of:

• Apache License, Version 2.0
• MIT license

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Re-exports

• pub use crypto_common::array;
• pub use arrayvec;
  arrayvec
• pub use bytes;
  bytes
• pub use heapless;
  heapless
• pub use crypto_common::rand_core;
  rand_core

Modules

• consts
  Type aliases for many constants.
• devdev
  Development-related functionality
• streamstream
  Streaming AEAD support.

Macros

• new_testdev
  Define AEAD test

Structs

• Error
  Error type.
• OsRnggetrandom
  A random number generator that retrieves randomness from the operating system.
• Payloadalloc
  AEAD payloads (message + AAD).

Traits

• Aeadalloc
  Authenticated Encryption with Associated Data (AEAD) algorithm.
• AeadCore
  Authenticated Encryption with Associated Data (AEAD) algorithm core trait.
• AeadInPlace
  In-place stateless AEAD trait.
• AeadMutalloc
  Stateful Authenticated Encryption with Associated Data algorithm.
• AeadMutInPlace
  In-place stateful AEAD trait.
• Buffer
  In-place encryption/decryption byte buffers.
• KeyInit
  Types which can be initialized from key.
• KeySizeUser
  Types which use key for initialization.

Type Aliases

• Key
  Key used by KeySizeUser implementors.
• Nonce
  Nonce: single-use value for ensuring ciphertexts are unique
• Result
  Result type alias with Error.
• Tag
  Tag: authentication code which ensures ciphertexts are authentic