Struct Tls 

pub struct Tls { /* private fields */ }

How a connection to the broker is secured.

Start from Tls::system_roots for a broker whose certificate a public authority issued, or Tls::with_ca_pem for one whose certificate comes from an authority of its own, and add client_certificate when the broker asks each client to prove who it is.

Examples

use pamoja_mqtt::{MqttConfig, Tls};

// A hosted broker with a publicly issued certificate, on the MQTT over TLS port.
let config = MqttConfig::new("sensor-1", "broker.example.com", 8883).tls(Tls::system_roots());
assert!(config.uses_tls());

Implementations

impl Tls

pub fn system_roots() -> Tls

Trusts the certificate authorities the operating system trusts.

Returns

The TLS settings, presenting no client certificate.

pub fn with_ca_pem(pem: impl Into<Vec<u8>>) -> Tls

Trusts only the certificate authorities in a PEM file.

A broker on a private network usually holds a certificate its operator issued, so the client trusts that operator’s authority and nothing else.

Arguments

• pem - one or more CERTIFICATE blocks.

Returns

The TLS settings, presenting no client certificate.

pub fn client_certificate( self, certificate_pem: impl Into<Vec<u8>>, key_pem: impl Into<Vec<u8>>, ) -> Tls

Presents a client certificate, for a broker that authenticates each client by one.

Arguments

• certificate_pem - the client’s certificate, followed by any intermediates.
• key_pem - the certificate’s private key, in PKCS #8, PKCS #1, or SEC1 form.

Returns

The updated settings, for chaining.

Trait Implementations

impl Clone for Tls

fn clone(&self) -> Tls

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Tls

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

Formats the value using the given formatter.