Features: - Able to encode using default/current session key (DEK) or receiving it as a parameter - Manual rotation of default/current session key (DEK) or automatic key generation for each of the request - Provides a public and simple implementation for Ring based AEAD encryption without using KMS. - Opt-in for KMS based secure random generator for GCP and AWS instead of Ring.
Available KMS providers: - Google Cloud Platform KMS - Amazon Web Services KMS
Cargo.toml:
toml
[dependencies]
kms-aead = { version = "0.6", features=["..."] }
See security consideration below about versioning.
gcp-kms-encryption for Google KMS envelope encryption supportaws-kms-encryption for Amazon KMS envelope encryption supportring-aead-encryption using API for Ring AEAD only without any KMS envelope encryptionAll examples available at examples directory.
To use GCP/AWS KMS API for secure random generator you should enable it using options.
For AWS:
rust
providers::AwsKmsProvider::with_options(
&kms_ref,
AwsKmsProviderOptions::new().with_use_kms_random_gen(true),
).await?
For GCP:
rust
providers::GcpKmsProvider::with_options(
&kms_ref,
GcpKmsProviderOptions::new().with_use_kms_random_gen(true),
).await?
Open source code is created through voluntary collaboration of software developers. The original authors license the code so that anyone can see it, modify it, and distribute new versions of it. You should manage all OSS using the same procedures and tools that you use for commercial products. As always, train your employees on cyber security best practices that can help them securely use and manage software products. You should not solely rely on individuals, especially on the projects like this reading sensitive information.
Please don't use broad version dependency management not to include a new version of dependency automatically without auditing the changes.
The library uses random 96 bit nonces
and ChaCha20-Poly1305 algorithm by default.
Depends on your security requirements to avoid nonce collisions it is recommended
to either rotate random DEK frequently using rotate_current_key or
even use a new random DEK per encryption using encrypt_value_with_new_key.
Apache Software License (ASL)
Abdulla Abdurakhmanov