Struct esp_idf_hal::sys::esp_mqtt_client_config_t_broker_t_verification_t

#[repr(C)]
pub struct esp_mqtt_client_config_t_broker_t_verification_t {
    pub use_global_ca_store: bool,
    pub crt_bundle_attach: Option<unsafe extern "C" fn(_: *mut c_void) -> i32>,
    pub certificate: *const i8,
    pub certificate_len: usize,
    pub psk_hint_key: *const psk_key_hint,
    pub skip_cert_common_name_check: bool,
    pub alpn_protos: *mut *const i8,
    pub common_name: *const i8,
}

Broker identity verification

If fields are not set broker’s identity isn’t verified. it’s recommended to set the options in this struct for security reasons.

Fields

use_global_ca_store: bool

< Use a global ca_store, look esp-tls documentation for details.

crt_bundle_attach: Option<unsafe extern "C" fn(_: *mut c_void) -> i32>

< Pointer to ESP x509 Certificate Bundle attach function for the usage of certificate bundles.

certificate: *const i8

< Certificate data, default is NULL, not required to verify the server.

certificate_len: usize

< Length of the buffer pointed to by certificate.

psk_hint_key: *const psk_key_hint

< Pointer to PSK struct defined in esp_tls.h to enable PSK authentication (as alternative to certificate verification). PSK is enabled only if there are no other ways to verify broker.

skip_cert_common_name_check: bool

< Skip any validation of server certificate CN field, this reduces the security of TLS and makes the MQTT client susceptible to MITM attacks

alpn_protos: *mut *const i8

< NULL-terminated list of supported application protocols to be used for ALPN

common_name: *const i8

< Pointer to the string containing server certificate common name. If non-NULL, server certificate CN must match this name, If NULL, server certificate CN must match hostname. This is ignored if skip_cert_common_name_check=true.

Trait Implementations

impl Clone for esp_mqtt_client_config_t_broker_t_verification_t

fn clone(&self) -> esp_mqtt_client_config_t_broker_t_verification_t

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for esp_mqtt_client_config_t_broker_t_verification_t

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

Formats the value using the given formatter.

impl Default for esp_mqtt_client_config_t_broker_t_verification_t

fn default() -> esp_mqtt_client_config_t_broker_t_verification_t

Returns the “default value” for a type.

impl Copy for esp_mqtt_client_config_t_broker_t_verification_t