Scram-rs

v 0.13

A SCRAM-SHA1, SCRAM-SHA256, SCRAM-SHA512, SCRAM-SHA256-PLUS client and server.

License:

MPL-2.0

Supports:

• SHA-1 hasher
• SHA-256 hasher (tested with Postfix Dovecot SASL)
• SHA-512 hasher
• Client/Server sync
• Server Channel Binding 256 untested (user must implement the trait to provide necessary data)
• Client Channel Binding 256 untested
• A support of async which allows to integrate it in async code or use with async
• Client/Server key (custom)
• Error handling server-error RFC5802 (e=server-error-value)
• Dynamic server instance i.e store the instance as dyn object instead of the generic struct
• Initialize the Scram Client/Server with borrowed or consumed instances.
• NO_STD support (untested)

Does not support:

• authzid (a=)
• Channel binding SHA-1 which is unsafe.

What is not implemented by design

This crate does not open a remote connection to host for you. It does not contain a code to open a connection to any remote target. This crate contains only a SCRAM-SHA logic. Your program manages the connection itself, reception of the data itself and transmitting it back to client/server on its own. This crated performs only logical operaions on received data and retrns the result to your program. This appreoach inreases a flexibility. This crate also implements a signalling so there is no need to implement a special error handling.

Based on crates:

• pbkdf2
• sha2
• sha-1
• hmac
• md-5
• base64
• getrandom
• ring

Features:

By default the following crates: [pbkdf2], [hmac], [sha2], [sha1] are included with this crate and a trait objects are available.

• use_ring - adds crate: [ring] to the crate and a trait objects becomes available.

• exclude_sha1 - excludes the sha1 alg.

• without_async - excludes/masks the async code

• std - use std lib

Warnings:

• This crate does not open network connection to anywhere. And must never!
• This crate has never been audited, only static tests proofs the correctness of its operation.
• This crate uses unverified cryptography crates. There is no warranty that the operaion of those crates is correct all the time.

Author of this crate is not responsible for anything which may happen.

Issues tracker:

Issues tracket is here

Usage:

see ./examples/ there

Test based benchmarks:

scram_sha256_server() sync/async tests (DEBUG)

scram_sha256_works() async tests (DEBUG)

Examples:

Init:

Generic struct (borrow intances):

  let authdb = AuthDB::new();
  let scramtype = SCRAM_TYPES.get_scramtype("SCRAM-SHA-256").unwrap();

  let mut server = 
      SyncScramServer::<ScramSha256RustNative, &AuthDB, &AuthDB>::new(&authdb, &authdb, ScramNonce::none(), scramtype).unwrap();

Dynamic:

  let authdb = AuthDB::new();
  let authdbcb = AuthDBCb{};
  let scramtype = SCRAM_TYPES.get_scramtype("SCRAM-SHA-256").unwrap();

  let server = 
      SyncScramServer
          ::<ScramSha256RustNative, AuthDB, AuthDBCb>
          ::new(authdb, authdbcb, ScramNonce::none(), scramtype).unwrap();


  let mut server_dyn = server.make_dyn();

Custom (consume the instances):

  let authdb = AuthDB::new();
  let conninst = ConnectionInst::new();
  let scramtype = SCRAM_TYPES.get_scramtype("SCRAM-SHA-256").unwrap();

  let mut server = 
      SyncScramServer
          ::<ScramSha256RustNative, AuthDB, ConnectionInst>
          ::<ScramSha256RustNative, AuthDB, AuthDBCb>
          ::new(authdb, conninst, ScramNonce::none(), scramtype).unwrap();

          .unwrap();