介紹
SCIM 目錄同步讓您可以直接從身份提供者(如 Okta 或 Microsoft Entra ID)管理您的 Gamma 工作區成員。連接後,在目錄中新增使用者會自動建立其帳戶,移除使用者則會停用帳戶並釋放席位,無需在 Gamma 進行手動清理。
🔷 注意: SCIM 僅適用於 Gamma 的 企業版,且需先啟用單一登入(SSO)。您需要在 Gamma 擁有工作區管理員權限,並且在身份提供者擁有管理員權限。
SCIM 與即時配置的比較
Gamma 支援透過 SSO 配置使用者的兩種方式。
即時配置(JIT)。 使用者首次透過 SSO 登入時會自動建立 Gamma 帳戶。此功能開箱即用,無需額外設定。未登入前,工作區可能看起來是空的,這是正常現象。
SCIM 配置。 Gamma 直接從您的身份提供者目錄同步使用者帳戶。帳戶會在無需首次登入的情況下建立,從目錄中移除使用者會自動在 Gamma 中取消配置。
大多數團隊會先使用 JIT,當需要從目錄處理離職時再加入 SCIM。
設定 SCIM
開始之前
SCIM 有兩個前置條件。
您的工作區必須啟用 SSO。 目錄同步是建立在 SSO 連線之上,只有在完成 SSO 設定後才會顯示設定選項。
先將所有需要 Gamma 存取權的人加入您的目錄群組。 啟用 SCIM 後,目錄將成為驗證網域內人員進入工作區的唯一途徑。未在目錄中的人即使透過 SSO 登入也無法加入。
步驟 1:確保 SSO 已啟用
只有在完成 SSO 設定後才能配置 SCIM。如果您的工作區尚未啟用 SSO,請先從這裡開始。
步驟 2:打開目錄同步設定
在您的工作區中,前往 工作區設定 > 安全性與驗證。啟用 SSO 後,您會看到包含 SCIM 行的 目錄同步 區塊。
點擊 設定,在新分頁開啟安全設定入口。
步驟 3:連接您的身份提供者目錄
設定入口會引導您連接目錄,並提供針對您的提供者量身訂做的指示。
連接後,Gamma 會對您的目錄執行初次同步。現有工作區成員會以電子郵件匹配,帳戶會被連結而非重複,且其內容不會改變。
同步完成後,安全性與驗證 頁面會顯示目錄同步為 已啟用,並標示啟用日期。從此之後,工作區成員由您的身份提供者管理。
SCIM 啟用後的成員管理方式
新增成員
在身份提供者中指派某人使用 Gamma,系統會自動建立其 Gamma 帳戶。他們不會收到 Gamma 的邀請郵件,只需透過 SSO 登入,帳戶與工作區成員資格即已準備好。
如果某人已有與電子郵件匹配的 Gamma 帳戶,系統會以相同方式連結至您的工作區,也不會發送郵件。
新成員預設為 成員。現有管理員可從工作區設定中將其升級為 管理員。
SCIM 會同步每位使用者的電子郵件、名字和姓氏。目錄中的個人資料更新會自動同步至 Gamma。
🔷 注意: SCIM 啟用期間,從 Gamma 的 成員 頁面發送至您 SSO 管理網域內電子郵件的邀請會被跳過,不會發送邀請郵件。請改由目錄新增這些人員。對於管理網域外的電子郵件(如外部訪客),邀請仍會正常發送。
移除成員
在身份提供者中移除或取消指派某人,其 Gamma 帳戶會被停用,該成員會被移出工作區,所有有效會話會立即結束,席位也會立即釋放。無需在 Gamma 進行後續操作。
若稍後重新指派該成員,其帳戶與內容會在下次登入時恢復。
他們在公司工作區中建立的所有內容會保留且權限不變。若需將離職員工的內容轉移至其他帳戶,請聯絡我們的支援團隊。
💎 專業提示: 請保持工作區至少有兩位管理員。唯一的管理員(或帳單管理員)無法透過 SCIM 被取消配置,這可防止您被鎖定在外,但若只有一位管理員,可能會阻礙離職流程。
席位
透過目錄新增的使用者即使超過購買的席位數,也會被配置,且訂閱不會自動調整。
請在身份提供者中指派群組前,先調整好席位數,並使用 成員 > 管理席位 來保持成員與購買席位數一致。
常見問題與常見問題解答
我從成員頁面邀請某人,但他們從未收到郵件。
如果他們的電子郵件在您 SSO 管理的網域內,SCIM 啟用期間邀請會被跳過。
請改為將他們加入身份提供者的 Gamma 目錄中。
我的團隊有人看到錯誤訊息說我們的組織使用目錄同步。
他們尚未在身份提供者中被指派使用 Gamma。
請 IT 管理員在目錄中指派他們使用 Gamma,然後讓他們重新登入。
被配置的使用者會收到歡迎或邀請郵件嗎?
不會。Gamma 會在背景靜默建立帳戶。
若有任何通知,將由您的身份提供者發出,而非 Gamma。
我們可以用身份提供者群組控制工作區成員資格,或將群組對應到角色嗎?
目前還不行。群組同步功能正在規劃中。
所有透過 SSO 或 SCIM 配置的使用者皆為成員,管理員必須在 Gamma 內手動授權。
我們在身份提供者中移除某人,但未設定 SCIM。他們還能使用嗎?
未啟用 SCIM 時,從身份提供者移除某人會阻止新登入,但現有會話會持續至過期,且席位不會自動釋放。
請從 工作區設定 > 成員 中移除他們以釋放席位。這正是 SCIM 消除的手動步驟。
我們可以稍後關閉 SCIM 嗎?
請聯絡我們的支援團隊,我們會協助您停用或重新配置目錄同步。
