创建和管理连接
连接是一种已保存的配置,使 PlaidCloud 能够访问外部系统,例如数据库、数据湖、ERP、REST API、云服务或 Git 提供商。工作流步骤按名称引用连接,因此端点详细信息和凭据集中存放在一处,并在所有需要它们的步骤和项目中重复使用。
连接在 Tools > Connections 中管理。
- 打开 Tools > Connections
- 点击工具栏中的
New Connection,然后从菜单中选择要连接的系统 - 填写连接表单(选项卡和字段因类型而异,请参阅下方的连接表单)
- 点击
Create保存
新连接会显示在列表中,所有者为您本人。
Acumatica、Bill.com、Dynamics、Eclipse、HFM/FCCS、NetSuite、Workday 和 Workday Financials 连接保存为 REST 连接,列表中的 类型 列会显示该服务自己的类型。每种连接都在各自的表单中创建、编辑,并在步骤中选取。标头、身份验证和分页位于 Edit REST settings 中,可通过右键菜单访问(请参阅编辑连接)。
大多数连接会打开多选项卡表单。具体选项卡取决于类型,但通常会看到:
- 连接配置(REST 则为 连接详细信息):连接的
Name、可选的Memo、主机/端口/数据库(REST 则为主机/身份验证类型)、Usage开关(Active)以及Security Model。在数据库连接中,凭据位于此处的 身份验证凭据 组;在 REST 连接中,凭据位于单独的 身份验证 选项卡。 - SSL 配置:
Use SSL,以及用于加密连接的 SSL 模式和可选的客户端/根证书。 - SSH 配置:
Use SSH,以及通过 SSH 跳转主机建立连接隧道所需的堡垒机主机、端口、用户和密钥。
密码、令牌和其他凭据字段为只写:重新打开已保存的连接时它们显示为空,保存时留空则保留已存储的密钥。仅在要更改时才重新输入值。这适用于 REST 连接的 API 密钥、OAuth 客户端密钥和 OAuth 刷新令牌。多行凭据(NetSuite 私有证书、Anaplan 证书和私钥、Postman API 密钥、Slack 或 Teams 传入 webhook URL)同样为只写,并在输入或粘贴时被遮蔽。仅由空格组成的替换值会被拒绝,而不会覆盖已存储的凭据;清空该字段即可保留已保存的值。SQL 或 Git 连接的 SSL 客户端密钥和 SSH 私钥也是只写,但在输入时保持可见。所有其他字段在显示连接的任何位置(编辑器中以及通过 API)都会显示其真实的已保存值,包括名称看起来敏感的字段(数据库的只读标志、账户标识符、架构、主机名),只有真正的凭据才会被遮蔽或隐藏。
通过 REST API 和 MCP 时,凭据字段遵循与编辑器相同的规则:发送空字符串,PlaidCloud 会保留已存储的值;发送 null 则清除。所有非凭据字段在发送空值时仍会被清除。
必填字段在保存时进行验证;如果缺少内容,表单会切换到包含第一个无效字段的选项卡并加以标记。
连接上的 Security Model 控制工作区中谁可以使用它:
| 选项 | 谁可以使用该连接 |
|---|---|
| 私有(仅限所有者) | 仅限所有者。 |
| 仅限指定成员 | 所有者以及明确列出的成员。 |
| 仅限指定安全组 | 所有者以及指定安全组的成员。 |
| 所有工作区成员 | 工作区中的所有人。 |
选择 Specific Members Only 或 Specific Security Groups Only 时,请通过列表的 Actions 菜单授予访问权限:Members(用于 Specific Members Only)或 Groups(用于 Specific Security Groups Only),以及 Agents 和 Owners,每项都会打开一个可筛选的复选列表,您可以在其中勾选拥有访问权限的对象(请参阅使用选择器进行分配)。只有连接的所有者或工作区管理员可以在此更改访问权限。其他可以编辑连接的人可以打开连接,在只读列表中查看已分配的人员,从而了解谁拥有访问权限。工作区管理员可以更改其并不拥有的连接的访问权限,以便在其所有者离开后移交该连接。
谁能看到连接的凭据
Section titled “谁能看到连接的凭据”任何可以使用连接的人都可以打开它并查看其设置,还可以浏览 Git 连接的存储库、分支和文件。无论权限如何,连接的密码、令牌和密钥都不会返回给任何人:通过 REST API 和 MCP 时,它们会以遮蔽形式返回,在 REST 中为 __redacted__,在 MCP 中为 <redacted>。只有服务账户才会收到它们:PlaidLink 代理,以及项目自己的服务账户,工作流运行器和工作流所运行的代码(例如用户定义函数)会使用它。某个人的登录身份绝不会收到。将 __redacted__ 原样发回会保留已存储的值。
更改连接发送其凭据的目的地(例如其主机或令牌 URL)时,需要重新输入这些凭据。否则保存更改会停止,并给出一条指明需要重新输入哪些凭据的消息,对更改后的设置进行测试时也会同样被拒绝。
当使用与已保存的服务器 URL 不同的服务器 URL 浏览 Git 连接时,请输入该服务器的令牌。
一个连接可以为每个环境保存不同的配置(例如,在同一连接名称下分别配置开发主机和生产主机)。工具栏中的环境选择器用于选择要查看和编辑的环境配置。
New Environment:添加连接环境Edit Environment:重命名所选环境Delete Environment:删除所选环境,前提是没有项目使用它、没有步骤将其作为固定环境,且没有代理为其提供服务。否则,消息会说明仍有什么在使用它。默认环境不能删除。
列表中的 Available 列显示所选连接是否已针对所选环境进行配置。
环境与 PlaidLink 代理共享,因此项目的环境既可以切换运行其远程步骤的代理,也可以切换其读取的连接。请参阅代理环境。
- 在列表中选择连接
- 点击工具栏中的
Edit(或右键点击该行) - 更改字段并点击
Update
对于 Acumatica、Bill.com、Dynamics、Eclipse、HFM/FCCS、NetSuite、Workday 或 Workday Financials 连接,Edit 会打开该服务自己的表单。如需更改底层 REST 连接的标头、身份验证或分页,请右键点击该连接并选择 Edit REST settings。
测试方式取决于类型:
- 数据库连接(Databricks、Snowflake、PostgreSQL 和 Redshift)在编辑器中有 测试连接 按钮。它使用您输入的凭据打开连接,并报告成功(附带所连接的服务器版本)或失败原因,同时不会关闭编辑器,因此可以就地修复并重试。
- 使用 SSH 的数据库连接还在
SSH Config选项卡中提供 SSH 隧道测试。 - 通用 REST 连接有一个
Testing选项卡,可通过已保存的连接发送临时请求。
测试前请先保存连接,因为测试针对的是已存储的配置。
连接无法访问的地址
Section titled “连接无法访问的地址”连接不能指向回环地址、链路本地地址或云元数据地址。PlaidCloud 会在您测试连接以及步骤使用连接时检查主机名解析到的地址,不符合条件的地址会失败,并给出指明主机和其解析地址的错误。您私有网络中的地址不受影响。
克隆、删除和追踪使用情况
Section titled “克隆、删除和追踪使用情况”- 克隆:复制连接的配置,作为新连接的基础。请参阅克隆连接。
- 删除:从工具栏中移除所选连接(系统会要求您确认)。
- 使用位置…:列出引用该连接的工作流步骤,以便在编辑或删除之前了解影响。
通过 REST API、JSON-RPC 以及 AI 助手或 MCP 时同样适用:更改连接的设置需要您是其所有者之一,或者对于没有所有者的连接,需要是工作区管理员。启用、禁用、锁定和解锁连接需要所有者或工作区管理员。指定多个连接的请求仅在您能够更改其中每一个连接时才会生效。