設定 OIDC SSO
OIDC 是連接身分提供者時 SAML 的替代方案。兩者都能讓你的團隊用現有的公司帳戶登入;OIDC 是較新的協定,部分提供者偏好使用。如果不確定該用哪個,請用 SAML——它是預設選項,支援所有受支援的提供者。當你的提供者建議使用 OIDC,或 SAML 不可行時,再選擇 OIDC。
設定流程與 SAML 相同——設定、驗證網域、測試、然後開啟——只是多了幾個 OIDC 特有的細節。
開始之前
- 一個有權管理單一登入的管理員帳戶。
- 你身分提供者管理主控台的存取權。
- 一個你能驗證的網域(團隊登入所用的電子郵件網域)。
開啟設定精靈
- 前往使用者管理 → 單一登入。
- 選擇設定單一登入。
- 挑選你的提供者,然後將協定切換為 OIDC。
與身分提供者交換設定
-
在提供者的主控台建立一個新的 OIDC(或「OpenID Connect」)應用程式。Kliv 會顯示要貼入的重新導向 URL。
-
你的提供者會給你 client ID、client secret 和 issuer URL(識別提供者登入服務的網址)。把三者都貼進 Kliv。
-
issuer URL 必須與你的提供者完全一致,一字不差。這是最常出錯的地方:
- Microsoft Entra 的 issuer 是各租戶專屬的,包含一長串識別碼——請從你自己的應用程式複製,不要沿用指南裡的範例。
- Google 公布的 issuer 有多種形式;請使用你主控台顯示的那一個。
issuer 只要有一點點不符,正常的登入就會被拒絕。下方的測試步驟會告訴你問題是否出在這裡。
Kliv 會把這些存成草稿——已設定但尚未生效。在你完成之前,團隊仍照現在的方式登入。
驗證你的網域
和 SAML 一樣,在你證明自己擁有該電子郵件網域之前,Kliv 不會依提供者的資料建立帳戶。請依照驗證你的網域操作,待顯示已驗證後再回到這裡。
用真實登入測試
- 選擇測試登入。
- 完全按照團隊將來的方式,在你的提供者登入。
- 成功後,Kliv 會記錄這次測試並解鎖開啟。
- 失敗時,Kliv 會顯示「預期值 vs 實際收到」的細節,讓你修正 issuer、密鑰或重新導向——請參閱排解 SSO 登入失敗。
開啟
測試登入成功後,選擇開啟。此後,已驗證網域上的人員會被導向你的提供者登入,首次登入會自動建立標準成員帳戶。
新成員只會取得一般成員權限——除非你設定群組對應,否則不會有更高的角色。
關於使用者身分的說明
OIDC 是以提供者發出的一組穩定值來識別每個人,而不是電子郵件地址。這是刻意的設計:即使電子郵件變更,同一個人仍保有原本的 Kliv 帳戶;Kliv 也不必依賴提供者把電子郵件標為「已驗證」(有些提供者不會為工作帳戶送出這項標記)。你不需要為此設定任何東西——只是了解一下,為什麼換了電子郵件不會產生重複帳戶。