当前位置：首页 > news >正文

【MQTT】mosquitto库中SSL/TLS相关API接口

news 2026/3/21 1:41:55

文章目录

1.相关API
- 1.1 mosquitto_tls_set
- 1.2 mosquitto_tls_insecure_set
- 1.3 mosquitto_tls_opts_set
- 1.4 mosquitto_tls_insecure_set
- 1.5 mosquitto_tls_set_context
- 1.6 mosquitto_tls_psk_set
2.示例代码

Mosquitto 是一个流行的 MQTT 消息代理（broker），它支持使用 SSL/TLS 来保障通信的安全性。有关于SSL/TLS的介绍可参考： SSL/TLS介绍。下面是与 SSL/TLS 相关的 Mosquitto 库中的一些重要 API：

1.相关API

1.1 mosquitto_tls_set

int mosquitto_tls_set(struct mosquitto *mosq, const char *cafile, const char *capath, const char *certfile, const char *keyfile, int (*pw_callback)(char *buf, int size, int rwflag, void *userdata));

该函数用于设置 SSL/TLS 相关参数。它接受以下参数：

mosq: 指向 mosquitto 实例的指针。
cafile: 包含 CA 证书的文件路径。
capath: 包含 CA 证书的文件夹路径。
certfile: 包含客户端 SSL 证书的文件路径（如果需要）。
keyfile: 包含客户端私钥的文件路径（如果需要）。
pw_callback: 一个回调函数，如果设置了密码则用于获取密码。

1.2 mosquitto_tls_insecure_set

int mosquitto_tls_insecure_set(struct mosquitto *mosq, bool value);

这个函数允许你设置是否对不受信任的服务器证书进行验证。将 value 设置为 true 将禁用服务器证书验证，这在测试环境中可能会有用，但在生产环境中请务必谨慎使用。

1.3 mosquitto_tls_opts_set

int mosquitto_tls_opts_set(struct mosquitto *mosq, int option, const void *value);

允许你设置与 TLS 相关的其他选项，例如用于自定义验证的回调函数等。

1.4 mosquitto_tls_insecure_set

int mosquitto_tls_insecure_set(struct mosquitto *mosq, bool value);

如果将 value 设置为 true，则会禁用服务器证书的验证。

1.5 mosquitto_tls_set_context

int mosquitto_tls_set_context(struct mosquitto *mosq, SSL_CTX *ctx);

允许你使用自定义的 OpenSSL SSL_CTX 对象来配置 TLS 连接。

1.6 mosquitto_tls_psk_set

int mosquitto_tls_psk_set(struct mosquitto *mosq, const char *psk, const char *identity, const char *ciphers);

如果你要使用 Pre-Shared Key（PSK）来保障连接安全，可以使用这个函数。

这些是一些与 SSL/TLS 相关的 Mosquitto 库中的重要 API。使用这些函数，你可以配置 Mosquitto 实例以在 MQTT 通信中使用 SSL/TLS 进行安全保护。务必在使用这些函数时参考 Mosquitto 的官方文档以获取详细的信息和示例代码。

2.示例代码

#include <mosquitto.h>int main(int argc, char **argv) 
{struct mosquitto *mosq = NULL;const char *host = "mqtt.example.com";int port = 8883; // 默认 MQTT over SSL/TLS 端口const char *topic = "example/topic";const char *message = "Hello, MQTT with SSL/TLS!";mosquitto_lib_init();mosq = mosquitto_new(NULL, true, NULL);if (!mosq) {fprintf(stderr, "Error: Unable to create Mosquitto instance.\n");return 1;}// 设置 SSL/TLS 参数mosquitto_tls_set(mosq, "/path/to/ca.crt", NULL, "/path/to/client.crt", "/path/to/client.key", NULL);// 连接到 MQTT 服务器int rc = mosquitto_connect(mosq, host, port, 60);if (rc) {fprintf(stderr, "Error: Unable to connect to the MQTT broker. Return code: %d\n", rc);mosquitto_destroy(mosq);mosquitto_lib_cleanup();return 1;}// 发布消息rc = mosquitto_publish(mosq, NULL, topic, strlen(message), message, 0, false);if (rc) {fprintf(stderr, "Error: Unable to publish message. Return code: %d\n", rc);}// 断开连接并清理资源mosquitto_disconnect(mosq);mosquitto_destroy(mosq);mosquitto_lib_cleanup();return 0;
}

此示例使用了 mosquitto_tls_set 函数来设置 SSL/TLS 相关参数，然后连接到 MQTT 服务器并发布一条消息。记得在实际应用中，还需要添加更多的错误处理和安全性检查，这里不多加赘述。