ic-bn-lib-common 0.1.8

A collection of traits & types commonly used by ic-bn-lib and others
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

use std::{fmt::Debug, sync::Arc};

use anyhow::Error;
use async_trait::async_trait;
use rustls::{server::ClientHello, sign::CertifiedKey};

use crate::types::tls::{Cert, Pem};

/// Trait that the certificate providers should implement.
/// It should return a vector of PEM-encoded cert-keys pairs.
#[async_trait]
pub trait ProvidesCertificates: Sync + Send + std::fmt::Debug {
    /// Returns a list of certificates in PEM format
    async fn get_certificates(&self) -> Result<Vec<Pem>, Error>;
}

/// Trait that a certificate storage must implement
pub trait StoresCertificates<T: Clone + Send + Sync>: Send + Sync {
    fn store(&self, cert_list: Vec<Cert<T>>) -> Result<(), Error>;
}

/// Custom `ResolvesServerCert` trait that borrows `ClientHello`.
/// It's needed because Rustls' `ResolvesServerCert` consumes `ClientHello`
/// <https://github.com/rustls/rustls/issues/1908>
pub trait ResolvesServerCert: Debug + Send + Sync {
    fn resolve(&self, client_hello: &ClientHello) -> Option<Arc<CertifiedKey>>;

    /// Return first available certificate, if any.
    /// Can be used as a fallback option.
    fn resolve_any(&self) -> Option<Arc<CertifiedKey>> {
        None
    }
}