使用自訂 SCIM 設定檔自動佈建使用者是 Beta 版功能,僅開放少數參與者使用。如果應用程式詳細資料頁面未顯示「自動佈建」,表示貴組織尚無法使用這項功能。
您可以使用自訂 SCIM 設定檔,透過自動化使用者帳戶佈建功能,在支援 SCIM 2.0 的自訂或預先整合 SAML 應用程式中,自動設定及管理使用者帳戶。
事前準備
如要設定自訂 SCIM 設定檔,您必須具備:
- 具備超級管理員角色的 Cloud Identity 帳戶。詳情請參閱「預先建立的管理員角色」。
- 在管理控制台中,為使用者設定並啟用自訂或預先整合的 SAML 應用程式
應用程式必須具備 SCIM 伺服器,且該伺服器應符合下列條件:
- 支援 SCIM 2.0 版
- 使用標準 HTTP 方法,包括
POST、GET、PATCH(備用方法為PUT) 和DELETE - 支援不記名權杖驗證。不支援 OAuth 權杖驗證。
使用自訂 SCIM 設定檔設定自動化使用者帳戶佈建功能
-
在 Google 管理控制台中,依序點選「選單」圖示
「應用程式」圖示
「網頁和行動應用程式」。
必須以超級管理員身分登入,才能執行這項工作。
- 按一下 SAML 應用程式的名稱。
- 在「自動佈建」下方,按一下「設定自動佈建功能」。
- 在「存取權杖」中輸入應用程式的不記名權杖,然後按一下「繼續」。
- 在「端點網址」欄位中,輸入應用程式的 SCIM 端點網址,然後按一下「繼續」。Google 會連線至您的 SCIM 端點,自動找出支援的屬性。
- 將 Google 目錄屬性對應至相應的應用程式屬性。如果應用程式支援結構定義探索,表格會預先填入探索到的屬性。如要手動對應自訂屬性,請按一下「新增對應」
完成後,按一下「繼續」。
- (選用) 如果您未新增任何群組,系統會佈建所有可存取 SAML 應用程式的使用者。如要將自動佈建功能限制為套用至特定使用者群組,請按照下列步驟操作:
- 在「搜尋群組」中輸入一或多個群組名稱字母,選取群組名稱,然後選擇範圍。
- 新增其他群組。
- (選用) 如要移除群組,請按一下「移除」。
如果群組中含有來自次要網域或機構外部的使用者,系統不會佈建這些使用者。
- 決定在關閉應用程式後,或是使用者的 Google Workspace 帳戶遭停權或刪除後,使用者可以存取應用程式的時間。您可以選擇將他們的帳戶停權、實刪除,或先停權再實刪除。您可以為每個動作分別設定延遲時間範圍。
- 視需要為下列各項事件選擇選項:
- 使用者的應用程式遭到關閉時
- 使用者在 Google 上遭到停權時
- 使用者從 Google 服務遭到刪除時
如果將使用者帳戶停權,系統會將帳戶標示為已停用。如果實刪除使用者帳戶,該帳戶會從應用程式中永久移除。因此請務必先預留更多時間,再實刪除使用者帳戶。如要進一步瞭解停權和刪除作業,請參閱「編輯取消佈建時間範圍」。
- 按一下「繼續」。
- 視需要為下列各項事件選擇選項:
測試連線:
- 在「Google Directory 使用者」部分,搜尋並選取沒有應用程式帳戶的使用者。
按一下「測試」。
Google 會在您的應用程式中為使用者建立帳戶、更新帳戶,然後刪除帳戶。每項作業都會顯示「成功」、「失敗」或「未執行」。如果作業失敗,請查看 HTTP 代碼、SCIM 錯誤類型,以及應用程式的「查看原始回應」詳細資料。
注意:如果應用程式未針對新使用者傳回
201 Created(例如使用者已存在),「建立使用者」作業就會失敗,Google 則會略過更新和刪除作業。如果「刪除使用者」失敗,請在應用程式中手動刪除測試帳戶。
按一下「完成」。
即使測試失敗,您也可以點選「Finish」(完成),稍後再重新測試。 這個步驟會儲存設定,但不會啟用自動佈建功能。如要啟用,請前往應用程式的詳細資料頁面「自動佈建」,然後將切換鈕設為「啟用」。
注意:如果您沒有為任何使用者開啟應用程式,這項設定就會處於停用狀態。按一下「使用者存取權」並開啟應用程式,即可啟用自動佈建功能。
編輯佈建資訊
編輯要執行自動佈建作業的使用者群組
-
在 Google 管理控制台中,依序點選「選單」圖示
「應用程式」圖示
「網頁和行動應用程式」。
必須以超級管理員身分登入,才能執行這項工作。
- 按一下 SAML 應用程式的名稱。
- 點選「自動佈建」。
- 在「帳戶佈建範圍」部分,按一下「編輯」。
- 在「搜尋群組」中輸入一或多個群組名稱字母,選取群組名稱,然後選擇範圍。
- 新增其他群組。
- (選用) 如要移除群組,請按一下「移除」。
如果群組中含有來自次要網域或機構外部的使用者,系統不會佈建這些使用者。 - 按一下「Update」。
編輯取消佈建的時程
如何定義取消帳戶管理動作生效前的延遲時間:
-
在 Google 管理控制台中,依序點選「選單」圖示
「應用程式」圖示
「網頁和行動應用程式」。
必須以超級管理員身分登入,才能執行這項工作。
- 按一下 SAML 應用程式的名稱。
- 點選「自動佈建」。
- 在「取消佈建」部分,按一下「編輯」。
- 針對每個事件 (「當使用者的應用程式遭到停用時」、「當使用者遭到 Google 停權時」和「當使用者遭到 Google 刪除時」),選取要採取的動作,以及 Google 在變更發生後等待多久才將要求傳送至您的應用程式 (「24 小時內」、「1 天後」、「7 天後」或「21 天後」):
- 將使用者帳戶停權:在應用程式中停用使用者 (
PATCH或PUT搭配active: false)。 - 永久刪除使用者帳戶:從應用程式 (
DELETE /Users/{id}) 永久刪除使用者。
如果同時選取這兩個選項,請務必將永久刪除的延遲時間設得比停權時間長。 - 按一下「Update」。
停用自動佈建功能並刪除設定資訊
您可以關閉應用程式的自動佈建功能,而不會遺失設定資訊。您也可以關閉自動佈建功能,並移除所有設定資訊。
關閉自動佈建功能
如何停用應用程式的自動佈建功能,同時保留設定資訊:
-
在 Google 管理控制台中,依序點選「選單」圖示
「應用程式」圖示
「網頁和行動應用程式」。
必須以超級管理員身分登入,才能執行這項工作。
- 按一下 SAML 應用程式的名稱。
- 選擇下列其中一種做法:
- 關閉「自動佈建」。
- 依序點選「自動佈建」
「狀態」
「關閉」。
- 按一下「關閉」加以確認。
停用自動佈建功能並刪除設定資訊
如要停用自動佈建功能,並移除所有設定資訊,請按照下列步驟操作:
-
在 Google 管理控制台中,依序點選「選單」圖示
「應用程式」圖示
「網頁和行動應用程式」。
必須以超級管理員身分登入,才能執行這項工作。
- 按一下 SAML 應用程式的名稱。
- 點選「自動佈建」。
- 按一下「刪除」即可停用自動佈建功能,並移除所有設定資訊。
系統不會移除現有使用者,他們仍可使用應用程式。
查看使用資訊
- 啟用自動佈建功能後,您可以查看使用資訊。詳情請參閱「監控自動化使用者帳戶佈建作業」。
- 您可以查看過去 30 天內的下列使用資訊:
| 管理員記錄事件 | 說明 |
|---|---|
| 透過自動佈建功能建立使用者 | 透過自動佈建功能建立的使用者 |
| 更新自動佈建的使用者 | 透過自動佈建功能更新的使用者 |
| 將自動佈建的使用者停權 | 透過自動佈建功能停權的使用者 |
| 解除自動佈建使用者的停權狀態 | 透過自動佈建功能重新啟用的使用者 |
| 永久刪除自動佈建的使用者 | 透過自動佈建功能刪除的使用者 |
| 失敗 | 失敗的要求 |
如果自動佈建功能停止運作
如果 Google 無法再連線至您的應用程式,自動佈建功能就會停止運作。舉例來說,不記名權杖可能已過期或遭到撤銷,或是應用程式的 SCIM 網址可能已變更。如要修正問題,請更新權杖或網址:
-
在 Google 管理控制台中,依序點選「選單」圖示
「應用程式」圖示
「網頁和行動應用程式」。
必須以超級管理員身分登入,才能執行這項工作。
- 按一下 SAML 應用程式的名稱。
- 點選「自動佈建」。
- 如要更新不記名權杖,請按照下列步驟操作:
- 在「應用程式授權」部分,按一下「重新授權」。
- 在「存取權杖」部分,貼上應用程式的新不記名權杖。
- 按一下「重新授權」。
- 如要更新 SCIM 基準網址,請在「端點網址」部分按一下「編輯」,輸入新網址,然後按一下「更新」。
- (選用) 如要驗證連線,請在「測試連線」部分點選「測試」。
如要進一步瞭解自動佈建功能停止運作的其他原因,請參閱應用程式的說明文件。