概述

用 Tulip 连接现有软件系统

Tulip 是一个开放式平台，旨在与您现有的 IT 基础设施无缝集成。这种集成通过连接器实现。

连接器是 Tulip 的一项功能，允许 HTTP API、MQTT 和 SQL 数据库与 Tulip 进行数据交换。它们对于连接外部服务器和系统（包括表 API）至关重要。通过设置连接器，您可以将外部信息导入到您的 Tulip 应用程序中，从而简化流程。

连接器类型

1. HTTP- 从外部 API 访问数据。
2. MQTT- 写入你的 MQTT 命名空间。
3. SQL- 访问 Tulip 以外的外部数据库。

要访问连接器，请将鼠标悬停在 "应用程序"选项卡上，然后选择 "连接器"。

在 "连接器 "页面，你可以查看连接器的状态、描述和最后更新时间。

将鼠标悬停在状态栏上，可获得有关每个 Environment 状态的更多信息。

每个连接器可以有多个连接器函数或查询，这些函数或查询会在应用程序中触发。
下面是连接器函数的示例：

如何使用连接器

连接器可在触发器或 Automation 中使用。{{术语表.操作块}}中使用。

示例 1

1. "当操作员扫描条形码时
2. "在我的 SQL 数据库中查找该条形码
3. "然后根据该数据导航到三个不同步骤之一"。

示例 2

1. "当操作员按下此按钮时
2. "向我的 HTTP API 发送请求，以跟踪工厂车间的生产问题"。

这两个示例都是自助服务。如果可以查询 SQL 数据库或外部软件服务（如 MES 或 ERP），则可以在 Tulip 中编写查询。

下图显示了运行连接器功能的触发器编辑器逻辑：

连接器环境

环境选项卡允许您为每个连接器功能设置多个服务器。通过环境，您可以根据应用程序和自动化的生命周期来划分受影响的信息。

有关环境的更多详情，请点击此处。

技术细节

由于连接器与外部系统通信，因此了解如何配置连接器以适应您的自定义 IT 环境至关重要。连接器主机是 Tulip 平台的一个组件，负责管理这些连接。

对于 Tulip 云公开提供的数据库和 API，无需额外配置。但是，如果出现问题或需要连接到数据库、API 或 Tulip 云不公开提供的机器，请参阅有关连接器主机的文章。

创建连接器

设置新连接器不需要丰富的 API 或数据库知识，但熟悉连接类型会有所帮助。

要创建连接器，请导航到应用程序下的连接器页面。单击右上角的**+ 创建连接器**。你可以选择一个现有的快速连接器，也可以点击创建自定义连接器。

设置新连接器

基本信息

1. 为连接器添加名称和描述。这些内容可随时编辑。
2. 选择连接器类型。创建连接器后不能更改。
3. [可选]启用自定义子域可为每个功能配置唯一的子域，便于与更复杂的服务架构集成。

例如，如果服务器地址是tulip.co，功能一可以使用community.tulip.co，功能二可以使用support.tulip.co。

启用自定义子域后，必须提供一个默认子域来检查连接器状态。

运行于：连接器主机

选择将执行请求的连接器主机。云连接器主机由 Tulip 提供，通过 Tulip 云发出请求。任何注册到您账户的内部连接器主机也会出现。

在此了解有关连接器主机的更多信息。

HTTP 连接器设置

在此了解如何设置 HTTP 连接器功能。

允许自定义子域

启用后，可在功能级别添加子域。启用后，必须添加一个默认子域，用于检查连接器的在线状态。

示例服务器是acme.co，有些功能查询sales.acme.co，有些功能则联系shipping.acme.co，等等。

服务器地址

指定 Tulip 连接的网络地址，即主机名或 IP 地址。

传输层安全（TLS

传输层安全（TLS）是一种加密协议，旨在通过计算机网络提供安全通信。它通过对各方之间传输的数据进行加密，确保数据的私密性和完整性。TLS 是安全套接字层 (SSL) 的后续版本，广泛用于确保互联网连接的安全。

端口

服务器通过服务器提供商提供的特定网络端口监听请求。HTTPS 服务最常用的端口是 443，HTTP 服务最常用的端口是 80。

身份验证

• No Auth- 无需身份验证，或在其他请求头（如 x-auth-token）中进行身份验证。
• Basic Auth- 基本身份验证，实现用户名和密码。
• OAuth 2.0（承载令牌）--承载令牌是访问令牌的主要类型。它们由一个不透明的字符串组成，对使用它的客户端没有意义。
• OAuth 2.0（用户凭证）- 通常用于需要代表用户访问有限资源的客户端，例如需要访问用户联系人或日历事件的移动应用程序。用户必须明确授予权限。
• OAuth 2.0（客户端凭据）--客户端凭据是 Tulip 使用的一种授予类型，通过使用客户端凭据（客户端 ID 和客户端秘密）与授权服务器进行身份验证来获取访问令牌，通常用于代表自己而不是代表用户访问资源。
• OAuth 2.0（服务账户）- 用于需要访问更多资源或管理功能的客户端。该角色授予用户对账户和资源的广泛访问权限，如管理账户设置、创建或删除资源或执行管理任务。
• OAuth 1.0- OAuth 的早期版本，主要处理网络工作流。

点击此处了解有关 OAuth 的更多信息。

标头（可选）

标头提供数据来源验证、数据完整性和重放保护。这些标头将添加到连接器上的每个连接器功能中。

扩展证书颁发机构

可以上传.pem格式的文件，以扩展默认的 Node.js TLS 证书颁发机构。此字段更新Node.js TLS 库中的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。

有效 CA 的示例应如下所示：

-----begin certificate-----MIIDXTCCAkWgAwIBAgIJALaEfh0WW6ZcMA0GCSqGSIb3DQEBCwUAMEUxCzAJBgNVBAYTAlVTMRYwFAYDVQQIDA1TYW4gRnJhbmNpc2NvMRIwEAYDVQQHDAlTYW4gSm9zZTEPMA0GA1UECgwGQ29tcGFueTAeFw0xNzA1MjUyMDE2NDRaFw0xNzA2MjQyMDE2NDRaMEUxCzAJBgNVBAYTAlVTMRYwFAYDVQQIDA1TYW4gRnJhbmNpc2NvMRIwEAYDVQQHDAlTYW4gSm9zZTEPMA0GA1UECgwGQ29tcGFueTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAK9b+GVsTsmP7z9T2sh79uI/57pI1DBYNyOlwC0lfn8SebVKRg0qAsaF3V4rQ/RPZFGkTb2G7IKnWQZ6VB8AFLF6A9xuGe7vSG9ZcJ1AKM2uOwYXzWQNWRFiW1XPOEIOXB+N7kMFTF6ZzE6RkV68hVqVn7Kx4s0RYAKM4ESJIMyF64IHo5Rf6k3UtrOzy6M3LXM3axgUPHkHZh6/Pi3hecaF7w0qDhlS8UJLA4Gn1I6nrFt1URVd7aSIEiOQhs7wAGDzCjNYMEQK9ih0GLd9ybCm0flYo5fJqfOhWiCFm2z3SuGH9MSnVdrzxY6x23J/gE3spPvBopF6bRjQl0qiw1ZAgMBAAGjUDBOMB0GA1UdDgQWBBRZtdl2jSWpITThx8JZL4Jx0zCBdTAfBgNVHSMEGDAWgBRZtdl2jSWpITThx8JZL4Jx0zCBdTAMBgNVHRMEBTADAQH/MA0GCSqGSIb3DQEBCwUAA4IBAQARzA8ydRMOfbU0QLOEp9V4B6nO8XBpe9uvtYwQjmb5ZX1bR2/P71bzeJwHK6v4RZl6V5fwGzFdsMFI8JAlLJChM1BpsU7a5R+U/X6XJpCzjErhZ68Z3G+TQ4Bk9LhRlQTH5ld9lR8aWpVPvPIqMtkJhbvWn9P4ysc8q3WYfILy9m9J8Hz3i3AaAEjS5WWm4BjKUMvOF

SQL 连接器设置

设置 MQTT 连接器

在此了解如何创建 MQTT 连接器。

更多阅读

• 连接器快照
• 如何设置快速连接器
• 连接器故障排除