設定 SAML SSO

單一登入(SSO)讓你的團隊用平常工作所用的帳戶登入 Kliv,透過貴公司的身分提供者(管理員工登入的服務,例如 Okta 或 Microsoft Entra)。不必另外管理 Kliv 密碼,而且有人離職時,只要在一個地方移除他們,也就同時移除了他們在這裡的存取權。

SAML 是連接身分提供者時最廣泛支援的方式。本頁將依序帶你完成設定、用真實登入測試,以及開啟,這樣的順序能確保你的團隊不會遇到任何問題。

這一切都由你自己設定,不需要提交支援申請,也不用和廠商通電話。

開始之前

  • 你需要一個有權管理貴組織單一登入的管理員帳戶。
  • 你需要能存取身分提供者的管理主控台(Okta、Entra、Google Workspace、OneLogin 或其他 SAML 提供者)。
  • 準備一個你能驗證的網域,也就是團隊登入所用的電子郵件網域(例如 yourcompany.com)。

開啟設定精靈

  1. 前往使用者管理 → 單一登入。
  2. 選擇設定單一登入。
  3. 挑選你的提供者:Okta、Microsoft Entra、Google、OneLogin 或其他。選擇已知的提供者會預先填入正確的設定,讓你少抄一些東西。
  4. 協定保持為 SAML(預設)。OIDC 是進階的替代方案,請參閱設定 OIDC SSO。

與身分提供者交換設定

SSO 的運作建立在身分提供者與 Kliv 互相信任之上。你需要把彼此的一些資訊交給對方:

  1. Kliv 會顯示你的提供者需要的值(例如 Kliv 接收登入的 URL)。把這些值複製到提供者管理主控台中新建的 SAML 應用程式。
  2. 你的提供者會給你它自己的資訊,通常是中繼資料 URL或 XML 檔案,以及簽署憑證。把中繼資料貼進 Kliv(或上傳檔案)。
  3. 確認你的提供者會為每位使用者傳送穩定的識別碼,而不只是電子郵件地址。(實際的屬性依提供者而異,預設範本會指出該用哪一個;請在你的主控台中確認措辭。) Kliv 會用這個值辨識再次登入的人,即使他們的電子郵件改變也一樣。

Kliv 會把這些儲存為草稿。草稿已設定但尚未生效,在你完成之前,團隊仍照現在的方式登入。

驗證你的網域

在 Kliv 依據你的提供者建立帳戶之前,你必須證明自己掌控團隊所用的電子郵件網域。這可以防止任何人宣稱擁有不屬於他們的網域。

請依照驗證你的網域,在 DNS 加入一筆記錄,或在網站上放一個檔案。待顯示已驗證後再回到這裡。

用真實登入測試

這個步驟讓 SSO 可以放心開啟:你要在它影響任何人之前,證明整個往返流程運作正常。

  1. 在精靈中選擇測試登入。
  2. 你會被導向身分提供者登入,過程與你的團隊將來的體驗完全相同。
  3. 成功後,Kliv 會記錄這次成功的測試,並解鎖開啟按鈕。
  4. 失敗時,Kliv 會顯示它預期的內容與提供者實際傳來的內容,請參閱排解 SSO 登入失敗。在提供者端修正後再測試一次。

在針對你即將啟用的這組確切設定完成一次成功的測試登入之前,無法開啟 SSO。單純儲存永遠不夠。

開啟

測試通過後,選擇開啟。從此,當有人輸入已驗證網域的電子郵件地址,Kliv 就會將他們導向身分提供者登入。首次登入的人會自動建立 Kliv 帳戶,並具備標準成員存取權限。

新成員只會加入你的「所有人」群組。除非你刻意設定,否則他們不會從身分提供者取得管理員或任何提升的角色,請參閱將 IdP 群組對應到 Kliv 角色。

設定完成後

你的單一登入頁面現在會顯示狀態卡片,取代精靈畫面:包含你的提供者、已驗證的網域、最近一次成功登入,以及簽署憑證即將到期時的警告。請留意這個警告,憑證過期後登入就會失敗,直到你上傳新憑證為止。

若要要求網域上的每個人都使用 SSO(並在 SSO 出問題時保留安全的回復途徑),請參閱要求 SSO 並設定緊急存取管理員。