连接集成

连接集成会把你在外部服务中的账户(例如 Slack 或 GitHub)关联到你的 Kliv 应用,让应用可以使用该服务。你需要在 Kliv 的设置中自行完成连接;连接完成后,Kliv 会安全保存凭据,你的应用就可以开始使用它。

本页会说明连接流程,以及 Kliv 会为你存储什么。

连接流程

  1. 前往 Settings → Integrations。
  2. 从目录中选择你想要的集成。
  3. 选择 Connect。接下来会发生什么取决于服务:
    • 登录该服务。 大多数集成(Slack、Notion、HubSpot 等)会把你带到该服务中登录并批准访问,然后再带回 Kliv。你是在批准 Kliv 代表你执行操作;你不需要自己复制任何密钥。
    • 安装应用。 有些服务(例如 GitHub)会要求你把 Kliv 的应用安装到你的账户或组织中,并选择它可以访问什么。
    • 粘贴密钥。 少数服务通过从该服务设置中粘贴访问密钥来连接。Kliv 会把它存入保险库。
  4. 返回 Kliv 后,该集成会显示为已连接并可使用。

你可以为同一个服务连接多个账户,例如两个 Slack 工作区,并选择应用的某个部分使用哪一个。

Kliv 会为你存储什么

连接时,Kliv 会将该服务的凭据保存到安全保险库中。有几点需要知道:

  • 凭据位于 Kliv 的保险库中,绝不会进入你的应用代码。 你的应用访问者看不到它们,你也不需要自己管理令牌。
  • Kliv 会在后台提供凭据。 当你的应用发起调用时,Kliv 会在服务端附加正确的凭据。你的应用代码只描述要做什么,从不描述要如何认证。
  • 有些连接会自动刷新。 对于访问权会过期的服务,Kliv 会为你续期。如果某个服务撤销了访问权,例如你在对方服务中移除了 Kliv 的应用,该集成会要求你重新连接。

管理或断开连接

在同一个 Integrations 区域中,你可以查看已连接的集成,设置谁可以使用它,设置事件触发器,或断开连接。断开连接会移除已存储的凭据,并阻止你的应用继续使用该服务。

如果出现问题

  • "Not connected" —— 该集成尚未连接,或它的访问权已被移除。请从 Settings → Integrations 连接(或重新连接)它。
  • "Reconnect required" —— 外部服务撤销了 Kliv 的访问权。打开该集成并重新连接。
  • 多个连接 —— 如果你的应用为同一个服务连接了多个账户,你可能需要告诉它要使用哪一个。每个连接的页面都会显示一个连接选择器,这是应用用来在多个连接之间选择的简短标签。

相关