集成节点/Built in_nodes/Credentials
MQTT 凭据#
你可以使用这些凭据来认证以下节点:
- MQTT
- MQTT Trigger
前提条件#
安装一个 MQTT 代理(broker)。 MQTT 在 MQTT 软件列表 中提供了可用的服务器/代理列表。
支持的认证方式#
- 代理连接(Broker connection)
相关资源#
更多关于 MQTT 协议的信息,请参考 MQTT 官方文档。 有关详细配置和说明,请查阅你的代理服务提供商的文档。
使用代理连接#
要配置此凭据,你需要准备以下信息:
- MQTT 代理的 协议(Protocol)
- 主机地址(Host)
- 端口(Port)
- 用于认证的 用户名(Username) 和 密码(Password)
- 如果你使用 SSL,还需要相应的证书和密钥
配置步骤如下:
- 选择代理的 协议(Protocol),该选项将决定 n8n 使用的 URL 格式。可选项包括:
- Mqtt :URL 以标准的
mqtt:协议开头。 - Mqtts :URL 以安全的
mqtts:协议开头。 - Ws :URL 以 WebSocket 的
ws:协议开头。
- Mqtt :URL 以标准的
- 输入你的代理 主机地址(Host)。
- 输入 n8n 连接代理时应使用的 端口号(Port)。
- 输入用于登录代理的 用户名(Username)。
- 输入该用户的 密码(Password)。
- 如果你希望在离线期间也能接收 QoS 1 和 QoS 2 消息,请关闭 Clean Session 开关。
- 输入你希望凭据使用的 客户端 ID(Client ID)。如果留空,n8n 将自动生成一个。你可以使用固定的或基于表达式的 Client ID。
- Client ID 可用于识别和追踪连接访问。n8n 建议使用包含
n8n字样的标识,便于审计。
- Client ID 可用于识别和追踪连接访问。n8n 建议使用包含
- 如果你的 MQTT 代理启用了 SSL,请打开 SSL 开关。开启后需要配置以下内容:
- 选择是否使用基于证书的 无密码(Passwordless) 连接,类似于 SASL 的 EXTERNAL 机制。若启用:
- 选择是否 拒绝未经授权的证书(Reject Unauthorized Certificate):若关闭,即使证书验证失败,n8n 仍会尝试连接。
- 添加 SSL 客户端证书(Client Certificate)。
- 为客户端证书添加对应的 SSL 客户端密钥(Client Key)。
- 添加一个或多个 SSL CA 证书(CA Certificates)。
请参考您的 MQTT 代理服务器提供商的文档,以获取更详细的配置说明。