daxpeddaandKevin Lewi
e491c1b533
* Initial P256 implementation * Add P256 VOPRF test vectors * Fix implementation * Forgot `Cargo.toml` and CI * Fix MSRV * Fix MSRV tests * Remove accidental leftovers * Document constants * Use included constant time checks * Add P-256 VOPRF test vector checks * Remove unnecessary bound on `CipherSuite::Group` * P-256 improvement and fixes * Add OPAQUE test vectors for P-256 * Remove fixed key size for 3DH * Hide P-256 test vectors behind feature flag * Split `Group` into modules * Fix `hash_to_scalar` * Point to source * Move constants to `once_cell` Co-authored-by: Kevin Lewi <[email protected]>
34 lines
1.5 KiB
Rust
34 lines
1.5 KiB
Rust
// Copyright (c) Facebook, Inc. and its affiliates.
|
|
//
|
|
// This source code is licensed under the MIT license found in the
|
|
// LICENSE file in the root directory of this source tree.
|
|
|
|
//! Defines the CipherSuite trait to specify the underlying primitives for OPAQUE
|
|
|
|
use crate::{
|
|
hash::Hash, key_exchange::traits::KeyExchange, map_to_curve::GroupWithMapToCurve,
|
|
slow_hash::SlowHash,
|
|
};
|
|
|
|
/// Configures the underlying primitives used in OPAQUE
|
|
/// * `Group`: a finite cyclic group along with a point representation, along
|
|
/// with an extension trait PasswordToCurve that allows some customization on
|
|
/// how to hash a password to a curve point. See `group::Group` and
|
|
/// `map_to_curve::GroupWithMapToCurve`.
|
|
/// * `KeyExchange`: The key exchange protocol to use in the login step
|
|
/// * `Hash`: The main hashing function to use
|
|
/// * `SlowHash`: A slow hashing function, typically used for password hashing
|
|
pub trait CipherSuite {
|
|
/// A finite cyclic group along with a point representation along with
|
|
/// an extension trait PasswordToCurve that allows some customization on
|
|
/// how to hash a password to a curve point. See `group::Group` and
|
|
/// `map_to_curve::GroupWithMapToCurve`.
|
|
type Group: GroupWithMapToCurve;
|
|
/// A key exchange protocol
|
|
type KeyExchange: KeyExchange<Self::Hash, Self::Group>;
|
|
/// The main hash function use (for HKDF computations and hashing transcripts)
|
|
type Hash: Hash;
|
|
/// A slow hashing function, typically used for password hashing
|
|
type SlowHash: SlowHash<Self::Hash>;
|
|
}
|