Struct encrypted_message::EncryptedMessage

pub struct EncryptedMessage<P: Debug + DeserializeOwned + Serialize, S: Strategy, K: KeyConfig> { /* private fields */ }

Used to safely handle & transport encrypted data within your application. It contains an encrypted payload, along with a nonce & tag that are used in the encryption & decryption processes.

Implementations

impl<P: Debug + DeserializeOwned + Serialize, S: Strategy, K: KeyConfig> EncryptedMessage<P, S, K>

pub fn encrypt_with_key_config( payload: P, key_config: &K ) -> Result<Self, EncryptionError>

Creates an EncryptedMessage from a payload, using the AES-256-GCM encryption cipher.

Errors

• Returns an EncryptionError::Serialization error if the payload cannot be serialized into a JSON string. See serde_json::to_value for more information.

pub fn decrypt_with_key_config( &self, key_config: &K ) -> Result<P, DecryptionError>

Decrypts the payload of the EncryptedMessage, trying all available keys in order until it finds one that works.

Errors

• Returns a DecryptionError::Base64Decoding error if the base64-decoding of the payload, nonce, or tag fails.
• Returns a DecryptionError::Decryption error if the payload cannot be decrypted with any of the available keys.
• Returns a DecryptionError::Deserialization error if the payload cannot be deserialized into the expected type. See serde_json::from_slice for more information.

pub fn with_new_payload_and_key_config( self, payload: P, key_config: &K ) -> Result<Self, EncryptionError>

Consumes the EncryptedMessage & returns a new one with the same encryption strategy, but with a new encrypted payload.

See EncryptedMessage::encrypt_with_key_config for more information.

impl<P: Debug + DeserializeOwned + Serialize, S: Strategy, K: KeyConfig + Default> EncryptedMessage<P, S, K>

pub fn encrypt(payload: P) -> Result<Self, EncryptionError>

This method is a shorthand for EncryptedMessage::encrypt_with_key_config, passing &K::default() as the key configuration.

pub fn decrypt(&self) -> Result<P, DecryptionError>

This method is a shorthand for EncryptedMessage::decrypt_with_key_config, passing &K::default() as the key configuration.

pub fn with_new_payload(self, payload: P) -> Result<Self, EncryptionError>

This method is a shorthand for EncryptedMessage::with_new_payload_and_key_config, passing &K::default() as the key configuration.

Trait Implementations

impl<P: Debug + Debug + DeserializeOwned + Serialize, S: Debug + Strategy, K: Debug + KeyConfig> Debug for EncryptedMessage<P, S, K>

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

Formats the value using the given formatter.

impl<'de, P: Debug + DeserializeOwned + Serialize, S: Strategy, K: KeyConfig> Deserialize<'de> for EncryptedMessage<P, S, K>

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<P: PartialEq + Debug + DeserializeOwned + Serialize, S: PartialEq + Strategy, K: PartialEq + KeyConfig> PartialEq for EncryptedMessage<P, S, K>

fn eq(&self, other: &EncryptedMessage<P, S, K>) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

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

impl<P: Debug + DeserializeOwned + Serialize, S: Strategy, K: KeyConfig> Serialize for EncryptedMessage<P, S, K>

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<P: Eq + Debug + DeserializeOwned + Serialize, S: Eq + Strategy, K: Eq + KeyConfig> Eq for EncryptedMessage<P, S, K>

impl<P: Debug + DeserializeOwned + Serialize, S: Strategy, K: KeyConfig> StructuralPartialEq for EncryptedMessage<P, S, K>