连接集成
连接集成会把你在外部服务中的账户(例如 Slack 或 GitHub)关联到你的 Kliv 应用,让应用可以使用该服务。你需要在 Kliv 的设置中自行完成连接;连接完成后,Kliv 会安全保存凭据,你的应用就可以开始使用它。
本页会说明连接流程,以及 Kliv 会为你存储什么。
连接流程
- 前往 Settings → Integrations。
- 从目录中选择你想要的集成。
- 选择 Connect。接下来会发生什么取决于服务:
- 登录该服务。 大多数集成(Slack、Notion、HubSpot 等)会把你带到该服务中登录并批准访问,然后再带回 Kliv。你是在批准 Kliv 代表你执行操作;你不需要自己复制任何密钥。
- 安装应用。 有些服务(例如 GitHub)会要求你把 Kliv 的应用安装到你的账户或组织中,并选择它可以访问什么。
- 粘贴密钥。 少数服务通过从该服务设置中粘贴访问密钥来连接。Kliv 会把它存入保险库。
- 返回 Kliv 后,该集成会显示为已连接并可使用。
你可以为同一个服务连接多个账户,例如两个 Slack 工作区,并选择应用的某个部分使用哪一个。
Kliv 会为你存储什么
连接时,Kliv 会将该服务的凭据保存到安全保险库中。有几点需要知道:
- 凭据位于 Kliv 的保险库中,绝不会进入你的应用代码。 你的应用访问者看不到它们,你也不需要自己管理令牌。
- Kliv 会在后台提供凭据。 当你的应用发起调用时,Kliv 会在服务端附加正确的凭据。你的应用代码只描述要做什么,从不描述要如何认证。
- 有些连接会自动刷新。 对于访问权会过期的服务,Kliv 会为你续期。如果某个服务撤销了访问权,例如你在对方服务中移除了 Kliv 的应用,该集成会要求你重新连接。
管理或断开连接
在同一个 Integrations 区域中,你可以查看已连接的集成,设置谁可以使用它,设置事件触发器,或断开连接。断开连接会移除已存储的凭据,并阻止你的应用继续使用该服务。
如果出现问题
- "Not connected" —— 该集成尚未连接,或它的访问权已被移除。请从 Settings → Integrations 连接(或重新连接)它。
- "Reconnect required" —— 外部服务撤销了 Kliv 的访问权。打开该集成并重新连接。
- 多个连接 —— 如果你的应用为同一个服务连接了多个账户,你可能需要告诉它要使用哪一个。每个连接的页面都会显示一个连接选择器,这是应用用来在多个连接之间选择的简短标签。
相关
- 可连接内容 —— 可用的集成以及它们解锁的能力。
- 控制谁可以使用连接器 —— 设置按操作访问。
- 响应提供商事件 —— 响应来自已连接服务的事件。