#base64 #pem #private-key #phc #avoid

no-std base64ct

Pure Rust implementation of Base64 (RFC 4648) which avoids any usages of data-dependent branches/LUTs and thereby provides portable "best effort" constant-time operation and embedded-friendly no_std support

11 stable releases

1.6.0 Feb 26, 2023
1.5.3 Oct 18, 2022
1.5.2 Aug 23, 2022
1.5.1 Jun 27, 2022
0.2.1 Mar 8, 2021

#11 in Encoding

Download history 661342/week @ 2024-02-14 697499/week @ 2024-02-21 716926/week @ 2024-02-28 734911/week @ 2024-03-06 725266/week @ 2024-03-13 732399/week @ 2024-03-20 684759/week @ 2024-03-27 788538/week @ 2024-04-03 760354/week @ 2024-04-10 768498/week @ 2024-04-17 767681/week @ 2024-04-24 731407/week @ 2024-05-01 743700/week @ 2024-05-08 802550/week @ 2024-05-15 783045/week @ 2024-05-22 837864/week @ 2024-05-29

3,317,491 downloads per month
Used in 2,832 crates (116 directly)

Apache-2.0 OR MIT

72KB
1.5K SLoC

RustCrypto: Constant-Time Base64

crate Docs Build Status Apache2/MIT licensed Rust Version Project Chat

Pure Rust implementation of Base64 (RFC 4648).

Implements multiple Base64 alphabets without data-dependent branches or lookup tables, thereby providing portable "best effort" constant-time operation.

Supports no_std environments and avoids heap allocations in the core API (but also provides optional alloc support for convenience).

Documentation

About

This crate implements several Base64 alphabets in constant-time for sidechannel resistance, aimed at purposes like encoding/decoding the "PEM" format used to store things like cryptographic private keys (i.e. in the pem-rfc7468 crate).

The paper Util::Lookup: Exploiting key decoding in cryptographic libraries demonstrates how the leakage from non-constant-time Base64 parsers can be used to practically extract RSA private keys from SGX enclaves.

The padded variants require (=) padding. Unpadded variants expressly reject such padding.

Whitespace is expressly disallowed, with the exception of the Decoder::new_wrapped and Encoder::new_wrapped modes which provide fixed-width line wrapping.

Supported Base64 variants

  • Standard Base64: [A-Z], [a-z], [0-9], +, /
  • URL-safe Base64: [A-Z], [a-z], [0-9], -, _
  • bcrypt Base64: ., /, [A-Z], [a-z], [0-9]
  • crypt(3) Base64: ., -, [0-9], [A-Z], [a-z]

Minimum Supported Rust Version

This crate requires Rust 1.60 at a minimum.

We may change the MSRV in the future, but it will be accompanied by a minor version bump.

License

Licensed under either of:

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.

No runtime deps