Struct TlsConfig

pub struct TlsConfig {
    pub ca: Vec<u8>,
    pub x509_cert: Option<X509Certificate>,
    /* private fields */
}

In order to allow the clients to talk to the crate::scheduler::Scheduler a default certificate and private key is included in this crate. The only service endpoints that can be contacted with this NOBODY identity are [Scheduler.register] and [Scheduler.recover], as these are the endpoints that are used to prove ownership of a node, and returning valid certificates if that proof succeeds.

Fields

ca: Vec<u8>

x509_cert: Option<X509Certificate>

The device_crt parsed as an x509 certificate. Used to validate the common subject name against the node_id configured on the scheduler.

Implementations

impl TlsConfig

pub fn new() -> Self

pub fn with<V: AsRef<[u8]>>(crt: V, key: V, ca_crt: V) -> Self

impl TlsConfig

pub fn identity(self, cert_pem: Vec<u8>, key_pem: Vec<u8>) -> Self

This function is used to upgrade the anonymous NOBODY configuration to a fully authenticated configuration.

Only non-NOBODY configurations are able to talk to their nodes. If the TlsConfig is not upgraded, nodes will reply with handshake failures, and abort the connection attempt.

pub fn identity_from_path<P: AsRef<Path>>(self, path: P) -> Result<Self>

Upgrades the connection using an identity based on a certificate and key from a path.

The path is a directory that contains a client.crt and a client-key.pem-file which contain respectively the certificate and private key.

pub fn ca_certificate(self, ca: Vec<u8>) -> Self

This function is mostly used to allow running integration tests against a local mock of the service. It should not be used in production, since the preconfigured CA ensures that only the greenlight production servers can complete a valid handshake.

pub fn client_tls_config(&self) -> ClientTlsConfig

Trait Implementations

impl Clone for TlsConfig

fn clone(&self) -> TlsConfig

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TlsConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for TlsConfig

fn default() -> Self

Returns the “default value” for a type.