Duaer

集成

在 Duaer 里配置 MQTT 凭证

在 Duaer 中保存 MQTT 的连接信息,供工作流程节点在运行时使用。密钥经实例加密密钥保护,不会写进节点参数。

连接 MQTT Broker

Duaer 的 MQTT 凭证:

  • Protocol 和 Port 要配对:Mqtt 一般用 1883,Mqtts 一般用 8883,Ws 用 Broker 开放的 WebSocket 端口。
  • Broker 要求登录时填 Username 和 Password。
  • Client ID 留空时自动生成。关掉 Clean Session 来接收离线期间的 QoS 1 和 2 消息时,要填一个固定的 Client ID,否则每次连接都算新客户端。
  • 用证书认证时打开 SSL 并保持 Passwordless 打开,填 Client Certificate 和 Client Key;自建 CA 时填 CA Certificates。

Duaer 里的 MQTT 字段

在 Duaer 里新建 MQTT 凭证,填写这些字段:

  • Protocol:默认 Mqtt,可选 Mqtt、Mqtts、Ws。
  • Host
  • Port:默认 1883。
  • Username
  • Password(密钥)
  • Clean Session:是否使用 clean session。设为 false 才能在离线期间接收 QoS 1 和 2 的消息。默认打开。
  • Client ID:客户端 ID。留空则自动生成。
  • SSL:默认关闭。
  • Passwordless:是否用证书进行无密码连接(SASL 机制 EXTERNAL)。默认打开,SSL 打开时显示。
  • CA Certificates(密钥):使用的 SSL CA 证书。SSL 打开时显示。
  • Reject Unauthorized Certificate:是否校验证书。默认关闭,SSL 打开时显示。
  • Client Certificate(密钥):使用的 SSL 客户端证书。SSL 打开时显示。
  • Client Key(密钥):使用的 SSL 客户端私钥。SSL 打开时显示。

使用它的 Duaer 节点:MQTT、MQTT Trigger。

在 Duaer 里保存连接

打开 Credentials,创建 MQTT。按字段填写密钥、OAuth 或服务器地址。保存后,工作流程节点引用这份凭证,而不是把密钥写进参数。

凭证内容经实例的加密密钥保护。换密钥或弄丢密钥后,已存凭证会解不开,见托管文档里的加密密钥说明。对应节点见 相关节点。

谁能用这份凭证

能否看到或编辑,取决于项目和角色。不要把密钥贴进聊天或变量。外部密钥库见外部密钥文档。

常见问题

Duaer 的 MQTT 凭证密钥会出现在节点参数里吗?

不会。在 Duaer 里,MQTT 的密钥保存在凭证中,节点只引用凭证。执行记录也不应出现明文密钥。

在 Duaer 里 MQTT 凭证保存失败常见原因是什么?

字段填错、OAuth 回调地址与实例 URL 不一致,或当前角色不能创建凭证。先核对 MQTT 服务商要求的字段,再确认你在该项目里有权新建凭证。

同组