如何构建第一个 MQTT 连接器

:::(Warning) (警告）并非所有郁金香实例都已启用 MQTT 支持。如果您有兴趣启用该功能，请联系 support@tulip.co：

如何构建第一个 MQTT 连接器

使用本指南学习如何将 MQTT 主题引入 Tulip

在本指南中，您将学习：*如何在 Tulip 中设置 MQTT 数据源

如果你有一个正在运行的 MQTT 代理，并希望将其连接到 Tulip，那么你就可以设置一个 MQTT 数据源，并创建你的第一个机器监控应用程序了。

设置 MQTT 连接

可以从连接器页面或机器数据源页面创建 MQTT 连接器。设置过程并无不同，在一个地方创建的连接会在另一个地方显示。

有关创建连接器的更多详情，请点击此处：如何配置连接器

设置为机器数据源

1. 单击菜单栏上车间选项卡下的机器选项。

1. 然后，单击左侧抽屉中的机器数据源。

1. 然后，单击 "机器数据源 "页面中的 "创建机器数据源"。

1. 为数据源命名，选择连接器主机，选择MQTT 和所需的 MQTT 版本。

1. 添加连接详细信息，以连接到您的代理。

配置 MQTT 连接

运行于

运行于表示将负责处理与代理连接的连接器主机。如果您的代理无法访问更广泛的互联网，则需要一个内部连接器主机（On-PremConnector Host）来访问您的 MQTT 代理。在测试连接器主机之前，请查看以下版本要求。

:::(Warning) (预置连接器主机版本）只有 261 (LTS11) 或更高版本的预置连接器主机支持 MQTT 数据源。 只有 OS56 或更高版本的边缘设备支持 MQTT 数据源。

:::

MQTT 与 MQTTs

MQTTs 就是简单的 MQTT，但增加了一层安全性。选择 MQTTs 时，客户端与代理之间的通信将使用 SSL/TLS。此外，MQTTs 还支持私钥、证书和或可信 CA 令牌。如果只选择 MQTT，则只能通过用户名和密码或客户端 ID 用户名进行身份验证。

客户端 ID

客户端 ID 是 Tulip 客户端向 MQTT 代理识别自己的方式。在最简单的层面上，它通常用于身份验证和访问控制。它可以设置为静态值，也可以设置为 "自动生成 "标志下的随机值。

保持存活

保持存活是客户端希望与代理保持通信畅通的最长时间（以秒为单位）。如果在该时间内没有信息从代理传递到客户端，客户端将向代理发送一条信息，表明它仍然存活。

MQTTs 认证信息

私钥

更新Node.js 验证配置中的密钥属性。

私钥采用 PEM 格式。PEM 允许对私钥进行加密。加密密钥将使用 options.passphrase 解密。使用不同算法的多个密钥可以未加密密钥字符串或缓冲区数组的形式提供，也可以对象数组的形式提供。object.passphrase 是可选项。如果提供了 object.passphrase，加密密钥将使用 object.passphrase 解密；如果没有提供 object.passphrase，则使用 options.passphrase 解密。

证书

更新Node.js 身份验证配置中的cert属性。

证书链为 PEM 格式。每个私钥应提供一个证书链。每个证书链应包括所提供私钥的 PEM 格式证书，然后是 PEM 格式的中间证书（如有），按顺序排列，且不包括根 CA（根 CA 必须是对等方预先知道的，见 ca）。提供多个证书链时，它们的顺序不必与其私钥中的密钥顺序一致。如果不提供中间证书，对等方将无法验证证书，握手将失败。

可信 CA

更新Node.js 身份验证配置中的ca属性。

可选择覆盖受信任的 CA 证书。默认情况下，信任 Mozilla 推荐的知名 CA。如果使用此选项明确指定 CA，则会完全替换 Mozilla 的 CA。值可以是字符串或缓冲区，也可以是字符串和/或缓冲区的数组。任何字符串或缓冲区都可以包含多个 PEM CA。对等方的证书必须可以链入服务器信任的 CA，这样才能验证连接。如果使用的证书不能链入知名 CA，则必须将证书的 CA 明确指定为受信任的 CA，否则连接将无法验证。如果对等方使用的证书与默认 CA 不匹配或不能链入默认 CA，请使用 ca 选项提供一个对等方证书可以匹配或链入的 CA 证书。对于自签名证书，必须提供自己的 CA 证书。对于 PEM 编码证书，支持的类型有 "TRUSTED CERTIFICATE"（可信证书）、"X509 CERTIFICATE"（X509 证书）和 "CERTIFICATE"（证书）。另请参阅 tls.rootCertificates。

测试连接

点击 "测试"查看能否成功连接到代理。

如果测试成功，就可以设置机器了。单击保存，然后转到 "机器类型"页面，设置第一类机器。

找到您想要的了吗？

你还可以前往community.tulip.co发布你的问题，或者看看其他人是否也遇到过类似的问题！