連接整合服務

連接整合服務會把你在外部服務(例如 Slack 或 GitHub)的帳戶連結到你的 Kliv 應用程式,讓應用程式能與該服務協作。這由你自己在 Kliv 的設定中完成;連接之後,Kliv 會妥善保管憑證,你的應用程式即可開始使用。

本頁說明連接流程,以及 Kliv 為你儲存了哪些內容。

連接流程

  1. 前往設定 → 整合。
  2. 從目錄中挑選你要的整合服務。
  3. 選擇連接。接下來的步驟依服務而異:
    • 登入該服務。 大多數整合(Slack、Notion、HubSpot 等)會把你導向該服務登入並核准存取,然後帶你回到 Kliv。你是在授權 Kliv 代表你行事——你自己不需要複製任何金鑰。
    • 安裝應用程式。 有些服務(例如 GitHub)會要求你把 Kliv 的應用程式安裝到你的帳戶或組織,並選擇它能存取的範圍。
    • 貼上金鑰。 少數服務的連接方式,是從該服務的設定中複製一把存取金鑰貼上。Kliv 會替你把它存進保管庫。
  4. 回到 Kliv 後,該整合會顯示為已連接、可以使用。

同一個服務可以連接多個帳戶——例如兩個 Slack 工作區——並指定應用程式的某個部分要使用哪一個。

Kliv 為你儲存了什麼

連接時,Kliv 會把該服務的憑證存入安全保管庫。幾件值得知道的事:

  • 憑證存放在 Kliv 的保管庫,絕不會出現在你應用程式的程式碼中。 應用程式的訪客看不到它們,你也永遠不必自己管理權杖。
  • Kliv 在幕後提供憑證。 應用程式發出呼叫時,Kliv 會在伺服器端附上正確的憑證。你的程式碼只描述要做什麼,從不涉及如何驗證。
  • 某些連線會自動更新。 對於存取權會過期的服務,Kliv 會替你續期。如果某個服務撤銷了存取權——例如你在對方那邊移除了 Kliv 的應用程式——該整合會請你重新連接。

管理或中斷連接

在同一個「整合」區域,你可以檢視已連接的整合、設定誰能使用它、設定事件觸發,或中斷連接。中斷連接會刪除已儲存的憑證,你的應用程式將無法再使用該服務。

出問題時

  • 「未連接」 —— 該整合尚未連接,或其存取權已被移除。請從設定 → 整合連接(或重新連接)。
  • 「需要重新連接」 —— 外部服務撤銷了 Kliv 的存取權。開啟該整合並重新連接。
  • 多個連線 —— 如果你的應用程式為同一服務連接了多個帳戶,可能需要指定要用哪一個——每個連線的頁面都有一個連線選擇器,是一個簡短標籤,供你的應用程式在多個連線之間選擇。

相關頁面