設定 SCIM 佈建

SCIM 佈建會讓你在 Kliv 的團隊自動與身分提供者保持同步。當你在 Okta 或 Entra 中把某人加入正確的群組,他們就會取得 Kliv 帳戶;當你在那邊將他們停用,他們的 Kliv 存取權會立即撤銷,包括任何已開啟的工作階段。不需要手動清理,也不會有人離職後還保有存取權。

這是目錄同步。它與 SSO 搭配運作:SSO 是人員登入的方式;SCIM 則負責建立與移除他們的帳戶。

你要設定什麼

你要給身分提供者兩樣東西,一個基礎 URL和一個權杖,其餘由提供者那邊處理。啟用後,你就不再於 Kliv 中管理個別使用者,由你的提供者作為資料的權威來源。

開啟佈建並取得詳細資訊

  1. 前往使用者管理 → 單一登入。
  2. 開啟佈建分頁。
  3. Kliv 會顯示你的提供者需要的基礎 URL,請複製。
  4. 選擇產生權杖。Kliv 只會顯示一次 Bearer 權杖,請立刻複製並存放在安全的地方。基於安全考量,Kliv 不會再次顯示。

在身分提供者中連接

在提供者的管理主控台中,開啟你的 Kliv 應用程式的佈建設定,並貼上:

  • 來自 Kliv 的基礎 URL,以及
  • 你剛產生的權杖。

接著啟用你需要的動作,通常是建立使用者、更新使用者與停用使用者,若有使用也包含群組同步。你的提供者通常會有測試連線按鈕,請執行以確認連結正常。

帳戶如何建立與移除

  • 建立/啟用 — 在你的提供者中被指派 Kliv 的使用者,會取得具標準成員存取權限的 Kliv 帳戶。
  • 更新 — 姓名或其他屬性的變更會自動同步。
  • 停用 — 當你在提供者中將使用者設為停用,他們的 Kliv 存取權會被撤銷,已開啟的工作階段也會結束,他們無法再登入。
  • 刪除 — 徹底移除使用者,是停用的永久版本。

由 SCIM 佈建的新成員只會取得成員存取權限。除非你刻意設定群組對應,否則他們不會從提供者繼承管理員或任何提升的角色。

輪替權杖

若權杖可能已外洩,或依你的資安政策要求的週期,請輪替權杖。

  1. 在佈建分頁選擇輪替權杖。
  2. 複製新的權杖(只顯示一次),並到身分提供者中更新。

在你把新權杖更新到提供者之前,佈建都會失敗,所以請在能立即把新值貼到提供者的時候再輪替。

持續留意

佈建分頁會顯示連線的健康狀態與最近的錯誤。如果你的提供者回報佈建失敗,請先來這裡查看:連線失敗幾乎都是因為權杖過期或不符,或是基礎 URL 沒有完整複製。

在 Kliv 中管理 SCIM 使用者

使用者或群組一旦由 SCIM 管理,就由你的身分提供者負責。如果你在 Kliv 中直接編輯由 SCIM 管理的使用者或群組而被拒絕,這是預期行為:這是在保護你的提供者資料不被覆寫,並非錯誤。請改在你的提供者中進行變更。