AI-on-the-edge-device 的 MQTTpassword参数配置与源码级认证原理解析【免费下载链接】AI-on-the-edge-deviceEasy to use device for connecting old measuring units (water, power, gas, ...) to the digital world项目地址: https://gitcode.com/GitHub_Trending/ai/AI-on-the-edge-device本文围绕 AI-on-the-edge-device将水表、电表、气表等传统计量设备接入数字世界的 ESP32 设备固件中 MQTT 连接的password认证参数展开说明其默认值、在config.ini中的配置方式并结合 interface_mqtt.cpp 与 ClassFlowMQTT.cpp 的源码实现解释密码如何被解析、注入 MQTT 客户端并用于 broker 认证同时给出连接被拒时的排查思路。读完本文你将能正确配置 MQTT 账号认证并定位认证类连接故障。参数定义与默认值password是 MQTT 连接认证参数之一其正式定义如下项目内容参数名password默认值PASSWORD作用MQTT broker 认证使用的密码Password for MQTT authentication默认值PASSWORD只是一个占位符并不代表真实密码。该参数必须与另一个认证参数user默认值USERNAME见 user.md成对使用——在源码实现中只有当user与password同时非空时认证凭据才会被写入 MQTT 客户端配置详见下文源码级认证链路。在 config.ini 中配置 passwordMQTT 的全部参数在 SD 卡根目录的 config.ini 的[MQTT]段落中配置。默认模板中该段落整体被注释示例写法为[MQTT] Uri mqtt://IP-ADRESS:1883 MainTopic watermeter ClientID watermeter user USERNAME password PASSWORD启用 MQTT 认证时将user与password两行取消注释并替换为真实凭据例如[MQTT] Uri mqtt://192.168.1.10:1883 MainTopic watermeter ClientID watermeter user mqtt-user password s3cret-pa55word配置完成后需重启设备或在 Web 界面执行相应操作使配置生效。需要注意MQTT 用户名/密码认证是明文凭据仅对 broker 认证有效与加密无关若需传输加密应配合CACert、ClientCert、ClientKey等 TLS 证书参数同样定义于[MQTT]段落见 config.ini 中的注释示例。源码级认证链路从 config.ini 到 MQTT 客户端password的生效过程贯穿三个层次可以从源码逐一确认。1. 配置解析ReadParameter()ClassFlowMQTT.cpp 中的ClassFlowMQTT::ReadParameter()负责逐行解析[MQTT]段落。其中对PASSWORD的处理为第 131-134 行if ((toUpper(_param) PASSWORD) (splitted.size() 1)) { this-password splitted[1]; }ZerlegeZeile将key value形式的一行拆分为键值对参数名经过toUpper大小写归一化后与PASSWORD比较因此password、PASSWORD、Password等写法均能被识别。解析得到的密码保存在ClassFlowMQTT::password成员中。该段落在构造函数 SetInitialParameter() 中默认初始化为空字符串。2. 配置传递MQTT_Configure()流程启动时ClassFlowMQTT::Start() 将解析出的password连同uri、clientname来自ClientID、user、maintopic等一并传给 interface_mqtt.cpp 中的MQTT_Configure()bool MQTTConfigCheck MQTT_Configure(uri, clientname, user, password, maintopic, domoticzintopic, LWT_TOPIC, LWT_CONNECTED, LWT_DISCONNECTED, caCertFilename, validateServerCert, clientCertFilename, clientKeyFilename, keepAlive, SetRetainFlag, (void *)GotConnected);MQTT_Configure()的关键逻辑第 263-266 行if (_user.length() _password.length()){ user _user; password _password; }即只有用户名和密码同时非空时全局user/password才会被赋值这印证了二者必须成对配置的事实。另外MQTT_Configure()还要求Uri、MainTopic、ClientID三者均非空否则会记录Init aborted! Config error (URI, MainTopic or ClientID missing)并拒绝初始化第 207-211 行。3. 凭据注入MQTT_Init() 与 esp-mqtt 客户端MQTT_Init()interface_mqtt.cpp 第 280-375 行在 Wi-Fi 连接就绪后构造esp_mqtt_client_config_t并调用esp_mqtt_client_init()。认证凭据的注入发生在第 332-335 行if (user.length() password.length()){ mqtt_cfg.credentials.username user.c_str(); mqtt_cfg.credentials.authentication.password password.c_str(); }可以看到密码最终写入的是 ESP-IDF esp-mqtt 客户端配置的credentials.authentication.password字段在 MQTT CONNECT 报文中作为 Password Flag 对应的负载发送给 broker底层由 esp-mqtt 组件完成 MQTT 3.1.1 协议交互。该实现同时也说明TLS 客户端证书clientCert/clientKey与用户名密码认证是相互独立的凭据机制可同时配置。日志中的密码保护MQTT_Configure()在 DEBUG 级别记录连接参数但密码是否出现在日志中受编译宏控制interface_mqtt.cpp 第 268-274 行#ifdef __HIDE_PASSWORD LogFile.WriteToFile(ESP_LOG_DEBUG, TAG, URI: uri , clientname: client_id , user: user , password: XXXXXXXX, maintopic: ...); #else LogFile.WriteToFile(ESP_LOG_DEBUG, TAG, URI: uri , clientname: client_id , user: user , password: password , maintopic: ...); #endif__HIDE_PASSWORD宏在 defines.h 中默认定义因此默认固件构建下日志中的密码会被替换为XXXXXXXX避免真实密码泄露到 SD 卡日志文件只有显式取消该宏的调试构建才会打印明文密码。认证失败连接返回码 0x04 与 0x05当 broker 拒绝认证时esp-mqtt 事件回调mqtt_event_handler_cb()会对连接返回码进行分类并写入日志interface_mqtt.cpp 第 149-189 行与password直接相关的两类是返回码含义日志信息0x04用户名或密码数据格式错误malformedConnection refused, malformed data in username or password (0x04)0x05客户端未获授权Connection refused, not authorized. Check username/password (0x05)排查步骤建议收到0x05最常见时核对[MQTT]段落中user/password是否与 broker 侧账号完全一致注意密码中的特殊字符如#、;、空格在config.ini中可能影响行解析——该文件使用key value空格分隔格式特殊字符建议避免或确认解析器ZerlegeZeile的处理行为收到0x04时检查密码中是否存在非法字符或编码问题确认设备侧与 broker 侧的密码字节一致确认user与password均已配置且非空否则源码中凭据根本不会被注入若启用 TLS配置了CACert等证书参数先确认证书校验通过再排查认证凭据避免混淆两类故障在设备 Web 界面的日志页面LogLevel调高中检索上述返回码日志定位连接被拒的具体阶段。小结password是 AI-on-the-edge-device MQTT 功能中最基础的认证参数它在config.ini的[MQTT]段落中配置默认占位值为PASSWORD必须与user成对使用才能生效。从源码链路看它经历ClassFlowMQTT::ReadParameter()解析、MQTT_Configure()校验传递、最终注入 esp-mqtt 客户端credentials.authentication.password三个环节默认固件还会在日志中对其脱敏处理。遇到 broker 返回 0x04/0x05 连接错误时应优先核对凭据的成对性、特殊字符与 broker 侧账号配置。相关实现可继续查阅 interface_mqtt.h、ClassFlowMQTT.cpp 及 config.ini 中的完整[MQTT]段落示例。【免费下载链接】AI-on-the-edge-deviceEasy to use device for connecting old measuring units (water, power, gas, ...) to the digital world项目地址: https://gitcode.com/GitHub_Trending/ai/AI-on-the-edge-device创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
AI-on-the-edge-device 的 MQTT `password` 参数配置与源码级认证原理解析
AI-on-the-edge-device 的 MQTTpassword参数配置与源码级认证原理解析【免费下载链接】AI-on-the-edge-deviceEasy to use device for connecting old measuring units (water, power, gas, ...) to the digital world项目地址: https://gitcode.com/GitHub_Trending/ai/AI-on-the-edge-device本文围绕 AI-on-the-edge-device将水表、电表、气表等传统计量设备接入数字世界的 ESP32 设备固件中 MQTT 连接的password认证参数展开说明其默认值、在config.ini中的配置方式并结合 interface_mqtt.cpp 与 ClassFlowMQTT.cpp 的源码实现解释密码如何被解析、注入 MQTT 客户端并用于 broker 认证同时给出连接被拒时的排查思路。读完本文你将能正确配置 MQTT 账号认证并定位认证类连接故障。参数定义与默认值password是 MQTT 连接认证参数之一其正式定义如下项目内容参数名password默认值PASSWORD作用MQTT broker 认证使用的密码Password for MQTT authentication默认值PASSWORD只是一个占位符并不代表真实密码。该参数必须与另一个认证参数user默认值USERNAME见 user.md成对使用——在源码实现中只有当user与password同时非空时认证凭据才会被写入 MQTT 客户端配置详见下文源码级认证链路。在 config.ini 中配置 passwordMQTT 的全部参数在 SD 卡根目录的 config.ini 的[MQTT]段落中配置。默认模板中该段落整体被注释示例写法为[MQTT] Uri mqtt://IP-ADRESS:1883 MainTopic watermeter ClientID watermeter user USERNAME password PASSWORD启用 MQTT 认证时将user与password两行取消注释并替换为真实凭据例如[MQTT] Uri mqtt://192.168.1.10:1883 MainTopic watermeter ClientID watermeter user mqtt-user password s3cret-pa55word配置完成后需重启设备或在 Web 界面执行相应操作使配置生效。需要注意MQTT 用户名/密码认证是明文凭据仅对 broker 认证有效与加密无关若需传输加密应配合CACert、ClientCert、ClientKey等 TLS 证书参数同样定义于[MQTT]段落见 config.ini 中的注释示例。源码级认证链路从 config.ini 到 MQTT 客户端password的生效过程贯穿三个层次可以从源码逐一确认。1. 配置解析ReadParameter()ClassFlowMQTT.cpp 中的ClassFlowMQTT::ReadParameter()负责逐行解析[MQTT]段落。其中对PASSWORD的处理为第 131-134 行if ((toUpper(_param) PASSWORD) (splitted.size() 1)) { this-password splitted[1]; }ZerlegeZeile将key value形式的一行拆分为键值对参数名经过toUpper大小写归一化后与PASSWORD比较因此password、PASSWORD、Password等写法均能被识别。解析得到的密码保存在ClassFlowMQTT::password成员中。该段落在构造函数 SetInitialParameter() 中默认初始化为空字符串。2. 配置传递MQTT_Configure()流程启动时ClassFlowMQTT::Start() 将解析出的password连同uri、clientname来自ClientID、user、maintopic等一并传给 interface_mqtt.cpp 中的MQTT_Configure()bool MQTTConfigCheck MQTT_Configure(uri, clientname, user, password, maintopic, domoticzintopic, LWT_TOPIC, LWT_CONNECTED, LWT_DISCONNECTED, caCertFilename, validateServerCert, clientCertFilename, clientKeyFilename, keepAlive, SetRetainFlag, (void *)GotConnected);MQTT_Configure()的关键逻辑第 263-266 行if (_user.length() _password.length()){ user _user; password _password; }即只有用户名和密码同时非空时全局user/password才会被赋值这印证了二者必须成对配置的事实。另外MQTT_Configure()还要求Uri、MainTopic、ClientID三者均非空否则会记录Init aborted! Config error (URI, MainTopic or ClientID missing)并拒绝初始化第 207-211 行。3. 凭据注入MQTT_Init() 与 esp-mqtt 客户端MQTT_Init()interface_mqtt.cpp 第 280-375 行在 Wi-Fi 连接就绪后构造esp_mqtt_client_config_t并调用esp_mqtt_client_init()。认证凭据的注入发生在第 332-335 行if (user.length() password.length()){ mqtt_cfg.credentials.username user.c_str(); mqtt_cfg.credentials.authentication.password password.c_str(); }可以看到密码最终写入的是 ESP-IDF esp-mqtt 客户端配置的credentials.authentication.password字段在 MQTT CONNECT 报文中作为 Password Flag 对应的负载发送给 broker底层由 esp-mqtt 组件完成 MQTT 3.1.1 协议交互。该实现同时也说明TLS 客户端证书clientCert/clientKey与用户名密码认证是相互独立的凭据机制可同时配置。日志中的密码保护MQTT_Configure()在 DEBUG 级别记录连接参数但密码是否出现在日志中受编译宏控制interface_mqtt.cpp 第 268-274 行#ifdef __HIDE_PASSWORD LogFile.WriteToFile(ESP_LOG_DEBUG, TAG, URI: uri , clientname: client_id , user: user , password: XXXXXXXX, maintopic: ...); #else LogFile.WriteToFile(ESP_LOG_DEBUG, TAG, URI: uri , clientname: client_id , user: user , password: password , maintopic: ...); #endif__HIDE_PASSWORD宏在 defines.h 中默认定义因此默认固件构建下日志中的密码会被替换为XXXXXXXX避免真实密码泄露到 SD 卡日志文件只有显式取消该宏的调试构建才会打印明文密码。认证失败连接返回码 0x04 与 0x05当 broker 拒绝认证时esp-mqtt 事件回调mqtt_event_handler_cb()会对连接返回码进行分类并写入日志interface_mqtt.cpp 第 149-189 行与password直接相关的两类是返回码含义日志信息0x04用户名或密码数据格式错误malformedConnection refused, malformed data in username or password (0x04)0x05客户端未获授权Connection refused, not authorized. Check username/password (0x05)排查步骤建议收到0x05最常见时核对[MQTT]段落中user/password是否与 broker 侧账号完全一致注意密码中的特殊字符如#、;、空格在config.ini中可能影响行解析——该文件使用key value空格分隔格式特殊字符建议避免或确认解析器ZerlegeZeile的处理行为收到0x04时检查密码中是否存在非法字符或编码问题确认设备侧与 broker 侧的密码字节一致确认user与password均已配置且非空否则源码中凭据根本不会被注入若启用 TLS配置了CACert等证书参数先确认证书校验通过再排查认证凭据避免混淆两类故障在设备 Web 界面的日志页面LogLevel调高中检索上述返回码日志定位连接被拒的具体阶段。小结password是 AI-on-the-edge-device MQTT 功能中最基础的认证参数它在config.ini的[MQTT]段落中配置默认占位值为PASSWORD必须与user成对使用才能生效。从源码链路看它经历ClassFlowMQTT::ReadParameter()解析、MQTT_Configure()校验传递、最终注入 esp-mqtt 客户端credentials.authentication.password三个环节默认固件还会在日志中对其脱敏处理。遇到 broker 返回 0x04/0x05 连接错误时应优先核对凭据的成对性、特殊字符与 broker 侧账号配置。相关实现可继续查阅 interface_mqtt.h、ClassFlowMQTT.cpp 及 config.ini 中的完整[MQTT]段落示例。【免费下载链接】AI-on-the-edge-deviceEasy to use device for connecting old measuring units (water, power, gas, ...) to the digital world项目地址: https://gitcode.com/GitHub_Trending/ai/AI-on-the-edge-device创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考