如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .md ,即可取得該頁面的 Markdown 版本。
主要導覽
主題

動態群組

使用 SCIM 使用者屬性自動管理群組成員資格

動態群組會依據身分識別提供者透過 SCIM 傳送的使用者屬性,將工作區成員分組。你可以使用部門、地點等支援的屬性來設定成員資格規則。這些屬性變更時,群組會自動加入符合規則的成員,並移除不再符合規則的成員。

例如,你可以設定動態群組,納入部門為 Engineering 且地點為 London 的成員。你可以在 ChatGPT 管理後台管理規則,使用者屬性則由身分識別提供者提供。

開始前

  • 以工作區擁有者或管理員身分登入支援動態群組的工作區。
  • 為工作區設定 SCIM 佈建,並確認身分識別提供者會傳送你要使用的屬性。
  • 選擇與身分識別提供者所傳送的值相符的屬性值。本指南列出了支援的屬性及其在承載資料中的路徑。

群組成員資格與功能權限分開管理。成員的存取權仍取決於其適用角色、席位類型及產品使用資格。如需瞭解存取權模型,請參閱群組與佈建。

建立動態群組

  1. 開啟 ChatGPT 管理後台,並選取你的工作區。
  2. 在「身分識別與存取權」下,選取「群組與角色」。
  3. 若要選取「建立群組」,請按 + 按鈕。
  4. 輸入群組名稱,例如 Demo,開啟「動態群組」,然後選取「下一步」。
  1. 在「新增成員資格規則」下,指定「屬性」、「運算子」和「值」。本例中,請依序選取 department 和「等於」,再輸入 Engineering。
  2. 選取「新增條件」以新增另一條規則。本例中,請依序選取 location 和「等於」,再輸入 London。

成員必須符合所有條件。在下列範例中,成員的部門必須是 Engineering,且地點必須是 London。

  1. 選取「建立」。開啟群組的「設定」分頁,查看群組名稱和成員資格規則。

建立群組時,系統會儲存成員資格規則。選取「重新同步」即可將這些規則套用至工作區的現有成員。

編輯成員資格規則

若要變更動態群組的成員資格條件,請依下列步驟操作:

  1. 開啟群組並選取「設定」。
  2. 編輯成員資格規則,然後選取「儲存變更」。
  3. 選取「重新同步」,將已儲存的規則套用至工作區的現有成員。

「儲存變更」只會儲存規則,不會啟動重新同步。「重新同步」使用已儲存的規則。如果有尚未儲存的變更,就無法使用此選項。

重新同步群組成員資格

使用「重新同步」,即可根據群組目前的規則和工作區現有的 SCIM 屬性,重新判定哪些成員符合資格。

  1. 開啟動態群組並選取「設定」。
  2. 在「成員資格規則」中,選取「重新同步」。
  3. 在「正在同步群組成員資格」狀態面板中查看進度。同步作業排入佇列後,面板可能會顯示「距離開始」及倒數計時,直到作業開始處理。你可以收合面板,也可以在「取消同步」選項仍可用時選取該選項。
  4. 處理完成後,開啟「群組成員」查看結果。

同步期間無法使用成員資格規則的控制項。取消同步可能導致只有部分成員的資格完成更新。每次變更規則後,請先儲存,再執行「重新同步」以套用已儲存的規則。如果群組中少了預期會加入的成員,請確認工作區是否已收到該成員的 SCIM 屬性,以及屬性值是否符合所有條件。

查看成員的 SCIM 屬性

你可以在成員的個人資料卡中查看工作區現有的 SCIM 屬性值,並與動態群組的成員資格規則比對。

  1. 在「身分識別與存取權」下,選取「成員」。
  2. 依姓名或電子郵件地址搜尋成員,然後選取該成員的姓名以開啟個人資料卡。
  3. 查看「SCIM 屬性」表格,其中列出每個可用的屬性及其值。

下列範例顯示一位測試成員的 SCIM 屬性值,包括 department、title 和 costCenter。

成員的姓名、電子郵件地址、頭像上的姓名首字母及群組名稱均已遮蔽。

支援的 SCIM 屬性

下表列出支援的屬性名稱,以及系統可從使用者承載資料中辨識的對應欄位。清單中的所有屬性都使用字串型別,包括 isAdmin。

單獨出現的欄位名稱代表最上層欄位。以 / 開頭的路徑指向指定 SCIM 擴充物件內的欄位。例如,/urn:ietf:params:scim:schemas:extension:enterprise:2.0:User/department 指的是 department 欄位,該欄位位於 urn:ietf:params:scim:schemas:extension:enterprise:2.0:User 物件內。

屬性名稱 SCIM 承載資料中可辨識的欄位
department department
/urn:ietf:params:scim:schemas:extension:enterprise:2.0:User/department
/urn:scim:schemas:extension:enterprise:1.0/department
/urn:scim:schemas:extension:enterprise:2.0/department
title title
manager manager
/urn:ietf:params:scim:schemas:extension:enterprise:2.0:User/manager/value
/urn:ietf:params:scim:schemas:extension:enterprise:2.0:User/manager/displayName
/urn:scim:schemas:extension:enterprise:1.0/manager/value
/urn:scim:schemas:extension:enterprise:1.0/manager/displayName
/urn:scim:schemas:extension:enterprise:2.0/manager/value
/urn:scim:schemas:extension:enterprise:2.0/manager/displayName
costCenter costCenter
/urn:ietf:params:scim:schemas:extension:enterprise:2.0:User/costCenter
/urn:scim:schemas:extension:enterprise:1.0/costCenter
division division
/urn:ietf:params:scim:schemas:extension:enterprise:2.0:User/division
/urn:scim:schemas:extension:enterprise:1.0/division
organization organization
/urn:ietf:params:scim:schemas:extension:enterprise:2.0:User/organization
/urn:scim:schemas:extension:enterprise:1.0/organization
userType userType
country country
isAdmin isAdmin
location location

對於 manager,系統可辨識最上層欄位,也可辨識擴充物件內的巢狀 value 或 displayName 欄位。對於 country,請傳送表中所列的最上層欄位。

相關文件