Google Git
Sign in
android / platform / external / rust / crates / mls-rs / b949a1b6a7ab428f2ea696b42434caa59d72a661
commitb949a1b6a7ab428f2ea696b42434caa59d72a661[log] [tgz]
authorMartin Geisler <[email protected]>Fri May 10 17:17:20 2024 +0000
committerAutomerger Merge Worker <[email protected]>Fri May 10 17:17:20 2024 +0000
tree5d119aad3e2c426ccb0bcd2bc4f9342b7a980f87
parent00c2d402a7380a3eabe73dde6716fb66c246b45e [diff]
parentcabca9807769ad409dcb3cdfccd11c5497b72474 [diff]
Build with mls_build_async am: 11b3e45ea7 am: cabca98077

Original change: https://android-review.googlesource.com/c/platform/external/rust/crates/mls-rs/+/3071124

Change-Id: I2aba2d396f3a6df0c1a8fb12d6ddccf622facea4
Signed-off-by: Automerger Merge Worker <[email protected]>
tree: 5d119aad3e2c426ccb0bcd2bc4f9342b7a980f87
  1. .cargo/
  2. benches/
  3. examples/
  4. src/
  5. test_utils/
  6. tests/
  7. LICENSE ⇨ LICENSE-apache
  8. .cargo_vcs_info.json
  9. Android.bp
  10. Cargo.lock
  11. Cargo.toml
  12. cargo_embargo.json
  13. LICENSE-apache
  14. LICENSE-mit
  15. METADATA
  16. MODULE_LICENSE_APACHE2
  17. OWNERS
  18. README.md
  19. webdriver.json
README.md

mls-rs   Build Status Latest Version API Documentation codecov

An implementation of the IETF Messaging Layer Security end-to-end encryption (E2EE) protocol.

What is MLS?

MLS is a new IETF end-to-end encryption standard that is designed to provide transport agnostic, asynchronous, and highly performant communication between a group of clients.

MLS Protocol Features

  • Multi-party E2EE group evolution via a propose-then-commit mechanism.
  • Asynchronous by design with pre-computed key packages, allowing members to be added to a group while offline.
  • Customizable credential system with built in support for X.509 certificates.
  • Extension system allowing for application specific data to be negotiated via the protocol.
  • Strong forward secrecy and post compromise security.
  • Crypto agility via support for multiple cipher suites.
  • Pre-shared key support.
  • Subgroup branching.
  • Group reinitialization for breaking changes such as protocol upgrades.

Features

  • Easy to use client interface that can manage multiple MLS identities and groups.
  • 100% RFC 9420 conformance with support for all default credential, proposal, and extension types.
  • Support for WASM builds.
  • Configurable storage for key packages, secrets and group state via traits along with provided “in memory” and SQLite implementations.
  • Support for custom user proposal and extension types.
  • Ability to create user defined credentials with custom validation routines that can bridge to existing credential schemes.
  • OpenSSL and Rust Crypto based cipher suite implementations.
  • Crypto agility with support for user defined cipher suite.
  • Extensive test suite including security and interop focused tests against pre-computed test vectors.

Crypto Providers

For cipher suite descriptions see the RFC documentation here

NameCipher SuitesX509 Support
OpenSSL1-7Stable
AWS-LC1,2,3,5,7Stable
Rust Crypto1,2,3⚠️ Experimental
Web Crypto⚠️ Experimental 2,5,7Unsupported

Security Notice

This library has been validated for conformance to the RFC 9420 specification but has not yet received a full security audit by a 3rd party.

License

This library is licensed under the Apache-2.0 or the MIT License.