encrypted-message 0.2.0

Safely encrypt & store serializable data using AES-256-GCM.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

# `encrypted-message`
[![crates.io](https://img.shields.io/crates/v/encrypted-message?logo=rust)](https://crates.io/crates/encrypted-message)
[![docs.rs](https://img.shields.io/docsrs/encrypted-message?logo=docs.rs)](https://docs.rs/encrypted-message)
[!["Lint & run tests" workflow](https://img.shields.io/github/actions/workflow/status/RigoOnRails/encrypted-message/development.yml?logo=github)](https://github.com/RigoOnRails/encrypted-message/actions/workflows/development.yml)
[![License](https://img.shields.io/crates/l/encrypted-message)](LICENSE)

Safely encrypt & store serializable data using AES-256-GCM.

## Install

```toml
[dependencies]
encrypted-message = "0.2"
```

## Diesel support

`EncryptedMessage` implements [`FromSql`](https://docs.diesel.rs/2.1.x/diesel/deserialize/trait.FromSql.html) & [`ToSql`](https://docs.diesel.rs/2.1.x/diesel/serialize/trait.ToSql.html).

```toml
[dependencies]
encrypted-message = { version = "0.2", features = ["diesel", "diesel-<mysql|postgres>"] }
```

## Examples

- [`examples/basic.rs`](examples/basic.rs), a basic example of how to use `encrypted-message`.
- [`examples/key_config_with_external_data.rs`](examples/key_config_with_external_data.rs), an example of a `KeyConfig` that depends on external data, like a user-provided key or password.

## Security

This crate uses trusted, pure-Rust encryption using the [`aes_gcm`](https://crates.io/crates/aes_gcm) crate
from the [Rust Crypto][rust-crypto] organization.

Keys are handled safely using the [`secrecy`](https://crates.io/crates/secrecy) crate,
which internally uses the [`zeroize`](https://crates.io/crates/zeroize) crate (also from [Rust Crypto][rust-crypto])
to zero-out the keys in memory when no longer used.

[rust-crypto]: https://github.com/RustCrypto