#boring-ssl #tls #boring #api-bindings #rust

superboring

A reimplementation of the 'boring' crate in pure Rust

4 releases

0.1.3 Sep 17, 2024
0.1.2 Dec 17, 2023
0.1.1 Dec 17, 2023
0.1.0 Dec 17, 2023

#514 in Cryptography

Download history 14529/week @ 2024-07-18 15545/week @ 2024-07-25 15060/week @ 2024-08-01 16621/week @ 2024-08-08 18433/week @ 2024-08-15 18396/week @ 2024-08-22 18187/week @ 2024-08-29 20378/week @ 2024-09-05 21225/week @ 2024-09-12 20349/week @ 2024-09-19 19407/week @ 2024-09-26 19844/week @ 2024-10-03 16648/week @ 2024-10-10 21315/week @ 2024-10-17 20746/week @ 2024-10-24 22023/week @ 2024-10-31

84,318 downloads per month
Used in 19 crates (2 directly)

ISC license

200KB
886 lines

Superboring

A Boring(SSL)-compatible API abstraction for Rust cryptographic implementations.

What is Superboring?

Superboring hides the complexity, diversity and instability of cryptographic implementations written in Rust behind an emulation of the boring API (Rust excellent wrappers for BoringSSL).

This allows applications written using the boring API to be able to also use pure Rust implementations without having to maintain two code bases.

Why use emulation instead of always using boring?

Here are valid reasons why using boring may sometimes not be an option.

All of them are just features that haven't been implemented in the boring crate yet, and that the boring maintainers would probably love getting help with, rather than people finding workarounds.

WebAssembly

While BoringSSL itself can be compiled to WebAssembly, the boring crate currently doesn't support this.

Symbol collisions with OpenSSL

OpenSSL and BoringSSL share a lot of symbols, which can cause collisions.

BoringSSL has the ability to prefix symbols in order to avoid this. But the boring crate currently doesn't support this.

Static builds

The real boring crate supports static builds using musl, so emulation is not required. Just use cargo-zigbuild:

cargo zigbuild --target=x86_64-unknown-linux-musl

What is currently implemented?

Superboring currently implements pretty much everything required to handle RSA signatures.

Dependencies

~0–1MB
~19K SLoC