#crypto #base64 #pem #phc

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

#186 in Cryptography

Download history 202189/week @ 2022-11-30 204548/week @ 2022-12-07 205906/week @ 2022-12-14 142601/week @ 2022-12-21 123706/week @ 2022-12-28 217956/week @ 2023-01-04 221224/week @ 2023-01-11 230788/week @ 2023-01-18 245495/week @ 2023-01-25 245721/week @ 2023-02-01 244347/week @ 2023-02-08 253875/week @ 2023-02-15 283799/week @ 2023-02-22 291838/week @ 2023-03-01 309195/week @ 2023-03-08 268537/week @ 2023-03-15

1,199,376 downloads per month
Used in 931 crates (48 directly)

Apache-2.0 OR MIT

71KB
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