QUIC 双向认证、DDS 代理功能升级｜NanoMQ Newsletter 2023-03

首先确认自己使用的 NanoMQ 版本已开启了 QUIC 选项，目前使用双向认证只需在配置中设置对应的客户端证书和私钥等文件路径，注意这部分配置无论是使用传统的 TCP 模式还是 QUIC 模式都一样有效：

旧配置文件格式：

bridge.mqtt.emqx.tls.enable=false
bridge.mqtt.emqx.tls.key_password=yourpass
bridge.mqtt.emqx.tls.keyfile=/etc/certs/key.pem
bridge.mqtt.emqx.tls.certfile=/etc/certs/cert.pem
bridge.mqtt.emqx.tls.cacertfile=/etc/certs/cacert.pem

‍‍

HOCON 格式:

## 在 bridge 段落中的 connector 部分


bridges.mqtt {
  nodes = [
    {
      name = emqx
      enable = true
      connector {
        ......
        conn_properties = {
          ......
        }
        # # Ssl config ##
        # # Ssl config is also valid when working in MQTT over QUIC mode ##
        ssl {
          enable = false
          key_password = "yourpass"
          keyfile = "/etc/certs/key.pem"
          certfile = "/etc/certs/cert.pem"
          cacertfile = "/etc/certs/cacert.pem"
        }
      }

‍‍

NanoMQ 的 MQTT over TCP 部分采用的是 MbedTLS 库进行加解密，与标准的 TCP 连接不同，QUIC 部分采用的是 MsQUIC 子模块项目内置的 OpenSSL API。OpenSSL 和 MbedTLS 两个目前最流行的 SSL 库在 NanoMQ 项目中可以同时兼容运行。

目前 NanoMQ 的 MQTT over QUIC 桥接功能暂时不支持 Windows 环境下运行。由于平台兼容性问题，在 Windows 环境中需要替换使用 schannel 来进行 TLS/SSL 加解密。计划在后续的版本中完成 Winodws 环境适配。

bridge.mqtt.emqx.quic_initial_rtt=60
bridge.mqtt.emqx.quic_send_idleTimeout=60

• Primitive types

• Structs

• String and string with template

• Sequence template

• Enums

• Part of Annotations

forward_rules = {
    ## DDS to MQTT
    dds_to_mqtt = {
        from_dds = "MQTTCMD/topic1"
        to_mqtt = "DDS/topic1"
        struct_name = "remote_control_result_t"
    }
    ## MQTT to DDS
    mqtt_to_dds = {
        from_mqtt = "DDSCMD/topic1"
        to_dds = "MQTT/topic1"
        struct_name = "remote_control_req_t"
    }
}

$ ./nanomq_cli ddsproxy sub -t "MQTT/topic1" --struct "remote_control_req_t"

编译 IDL
代码生成器 idl-serial

$ git clone https://github.com/nanomq/idl-serial.git
$ cd idl-serial
$ mkdir build && cd build
$ cmake -G Ninja ..
$ ninja 
$ sudo ninja install

编译完成生成可执行文件 idl-serial-code-gen

## 生成C代码 idl_convert.c 和 idl_convert.h
$ ./idl-serial-code-gen  dds_structs.idl  idl_convert

• 将以上步骤中生成的代码文件 idl_convert.c
  和 idl_convert.h
  拷贝到 nanomq_cli/dds2mqtt
  路径下

• 通过 cmake 参数 IDL_FILE_PATH
  指定 idl
  文件路径（不指定则默认为工程路径下的 etc/idl/dds_type.idl
  ）

$ git clone https://github.com/emqx/nanomq.git
$ cd nanomq
## 拷贝以上生成的文件到 nanomq_cli/dds2mqtt/路径下
$ cp {YOUR_PATH}/idl_convert.* nanomq_cli/dds2mqtt
$ mkdir build && cd build
$ cmake -G Ninja -DIDL_FILE_PATH={IDL_PATH} -DCMAKE_PREFIX_PATH={DDS_LIBRARY_PATH} -DBUILD_DDS_PROXY=ON ..
$ ninja 
$ sudo ninja install