#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

9 stable releases

Uses new Rust 2021

1.5.2 Aug 23, 2022
1.5.1 Jun 27, 2022
1.5.0 Mar 30, 2022
1.3.3 Dec 29, 2021
0.2.1 Mar 8, 2021

#37 in Cryptography

Download history 129385/week @ 2022-06-08 128842/week @ 2022-06-15 142551/week @ 2022-06-22 178711/week @ 2022-06-29 185404/week @ 2022-07-06 205858/week @ 2022-07-13 174450/week @ 2022-07-20 179692/week @ 2022-07-27 181786/week @ 2022-08-03 178334/week @ 2022-08-10 176616/week @ 2022-08-17 182301/week @ 2022-08-24 179872/week @ 2022-08-31 192844/week @ 2022-09-07 205925/week @ 2022-09-14 173016/week @ 2022-09-21

787,759 downloads per month
Used in 545 crates (24 directly)

Apache-2.0 OR MIT

69KB
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.56 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