Struct esp_idf_svc::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. Client only attach the bundle, the clean up must be done by the user.

certificate: *const i8

< Certificate data, default is NULL. It’s not copied nor freed by the client, user needs to clean up.

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. It’s not copied nor freed by the client, user needs to clean up.

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. It’s not copied nor freed by the client, user needs to clean up.

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