Struct NullProvider 

pub struct NullProvider {
    pub alpn: Vec<Vec<u8>>,
    pub hello_padding: usize,
    pub server_flight: usize,
    pub accept_any_tag: bool,
    /* private fields */
}

The null provider. alpn lists the protocols offered (client) or accepted (server).

Fields

alpn: Vec<Vec<u8>>

hello_padding: usize

Extra bytes in the ClientHello, to exercise multi-packet CRYPTO data.

server_flight: usize

Size of a mock Certificate message in the server’s flight.

accept_any_tag: bool

Accept any packet tag, so mutated packets reach frame processing (fuzzing).

Implementations

impl NullProvider

pub fn new(seed: u64) -> Self

Examples found in repository

examples/bench_quic.rs (line 21)

fn providers(real: bool) -> (Arc<dyn CryptoProvider>, Arc<dyn CryptoProvider>) {
    if !real {
        return (Arc::new(NullProvider::new(1)), Arc::new(NullProvider::new(2)));
    }
    let ss = certgen::issue(&CertParams::server(&["localhost"]), PrivateKey::generate_ec(EcCurve::P256), None);
    let ck = simoom_tls::CertifiedKey::new(vec![ss.cert_der.clone()], ss.key.clone()).unwrap();
    let s = TlsProvider::server(Arc::new(simoom_tls::ServerConfig::new(ck).with_alpn(&[b"h3"])));
    let mut roots = simoom_tls::x509::RootStore::empty();
    roots.add_der(&ss.cert_der).unwrap();
    let c = TlsProvider::client(Arc::new(simoom_tls::ClientConfig::new(roots).with_alpn(&[b"h3"])));
    (Arc::new(c), Arc::new(s))
}

Trait Implementations

impl CryptoProvider for NullProvider

fn initial_keys(&self, version: u32, dcid: &[u8], is_server: bool) -> Keys

Initial keys derived from the client’s first destination connection ID.

fn retry_tag(&self, version: u32, pseudo_packet: &[u8]) -> [u8; 16]

The Retry integrity tag over the Retry pseudo-packet (RFC 9001 §5.8).

fn hmac(&self, key: &[u8; 32], parts: &[&[u8]]) -> [u8; 32]

HMAC-SHA256 over the concatenation of parts.

fn fill_random(&self, buf: &mut [u8])

Cryptographically secure random bytes.

fn server_session( &self, _version: u32, tp: Vec<u8>, ) -> Result<Box<dyn CryptoSession>, TransportError>

Starts a server handshake for QUIC version that will send transport_params.

fn client_session( &self, _version: u32, _name: &str, tp: Vec<u8>, ) -> Result<Box<dyn CryptoSession>, TransportError>

Starts a client handshake to server_name that will send transport_params.