使用自訂 SCIM 設定檔設定自動化使用者帳戶佈建功能 (Beta 版)

使用自訂 SCIM 設定檔自動佈建使用者是 Beta 版功能,僅開放少數參與者使用。如果應用程式詳細資料頁面未顯示「自動佈建」,表示貴組織尚無法使用這項功能。

您可以使用自訂 SCIM 設定檔,透過自動化使用者帳戶佈建功能,在支援 SCIM 2.0 的自訂或預先整合 SAML 應用程式中,自動設定及管理使用者帳戶。

事前準備

如要設定自訂 SCIM 設定檔,您必須具備:

  • 具備超級管理員角色的 Cloud Identity 帳戶。詳情請參閱「預先建立的管理員角色」。
  • 在管理控制台中,為使用者設定並啟用自訂或預先整合的 SAML 應用程式

應用程式必須具備 SCIM 伺服器,且該伺服器應符合下列條件:

  • 支援 SCIM 2.0 版
  • 使用標準 HTTP 方法,包括 POST、GET、PATCH (備用方法為 PUT) 和 DELETE
  • 支援不記名權杖驗證。不支援 OAuth 權杖驗證。

使用自訂 SCIM 設定檔設定自動化使用者帳戶佈建功能

  1. 在 Google 管理控制台中,依序點選「選單」圖示 接下來「應用程式」圖示 接下來「網頁和行動應用程式」。

    必須以超級管理員身分登入,才能執行這項工作。

  2. 按一下 SAML 應用程式的名稱。
  3. 在「自動佈建」下方,按一下「設定自動佈建功能」。
  4. 在「存取權杖」中輸入應用程式的不記名權杖,然後按一下「繼續」。
  5. 在「端點網址」欄位中,輸入應用程式的 SCIM 端點網址,然後按一下「繼續」。Google 會連線至您的 SCIM 端點,自動找出支援的屬性。
  6. 將 Google 目錄屬性對應至相應的應用程式屬性。如果應用程式支援結構定義探索,表格會預先填入探索到的屬性。如要手動對應自訂屬性,請按一下「新增對應」接下來 完成後,按一下「繼續」。
  7. (選用) 如果您未新增任何群組,系統會佈建所有可存取 SAML 應用程式的使用者。如要將自動佈建功能限制為套用至特定使用者群組,請按照下列步驟操作:
    • 在「搜尋群組」中輸入一或多個群組名稱字母,選取群組名稱,然後選擇範圍。
    • 新增其他群組。
    • (選用) 如要移除群組,請按一下「移除」。
      如果群組中含有來自次要網域或機構外部的使用者,系統不會佈建這些使用者。
  8. 決定在關閉應用程式後,或是使用者的 Google Workspace 帳戶遭停權或刪除後,使用者可以存取應用程式的時間。您可以選擇將他們的帳戶停權、實刪除,或先停權再實刪除。您可以為每個動作分別設定延遲時間範圍。
    1. 視需要為下列各項事件選擇選項:
      • 使用者的應用程式遭到關閉時
      • 使用者在 Google 上遭到停權時
      • 使用者從 Google 服務遭到刪除時
        如果將使用者帳戶停權,系統會將帳戶標示為已停用。如果實刪除使用者帳戶,該帳戶會從應用程式中永久移除。因此請務必先預留更多時間,再實刪除使用者帳戶。如要進一步瞭解停權和刪除作業,請參閱「編輯取消佈建時間範圍」。
    2. 按一下「繼續」。
  9. 測試連線:

    1. 在「Google Directory 使用者」部分,搜尋並選取沒有應用程式帳戶的使用者。
    2. 按一下「測試」。

      Google 會在您的應用程式中為使用者建立帳戶、更新帳戶,然後刪除帳戶。每項作業都會顯示「成功」、「失敗」或「未執行」。如果作業失敗,請查看 HTTP 代碼、SCIM 錯誤類型,以及應用程式的「查看原始回應」詳細資料。

      注意:如果應用程式未針對新使用者傳回 201 Created (例如使用者已存在),「建立使用者」作業就會失敗,Google 則會略過更新和刪除作業。如果「刪除使用者」失敗,請在應用程式中手動刪除測試帳戶。

  10. 按一下「完成」。
    即使測試失敗,您也可以點選「Finish」(完成),稍後再重新測試。 這個步驟會儲存設定,但不會啟用自動佈建功能。如要啟用,請前往應用程式的詳細資料頁面 接下來「自動佈建」,然後將切換鈕設為「啟用」。
    注意:如果您沒有為任何使用者開啟應用程式,這項設定就會處於停用狀態。按一下「使用者存取權」並開啟應用程式,即可啟用自動佈建功能。

編輯佈建資訊

編輯要執行自動佈建作業的使用者群組

  1. 在 Google 管理控制台中,依序點選「選單」圖示 接下來「應用程式」圖示 接下來「網頁和行動應用程式」。

    必須以超級管理員身分登入,才能執行這項工作。

  2. 按一下 SAML 應用程式的名稱。
  3. 點選「自動佈建」。
  4. 在「帳戶佈建範圍」部分,按一下「編輯」。
  5. 在「搜尋群組」中輸入一或多個群組名稱字母,選取群組名稱,然後選擇範圍。
  6. 新增其他群組。
  7. (選用) 如要移除群組,請按一下「移除」。
    如果群組中含有來自次要網域或機構外部的使用者,系統不會佈建這些使用者。
  8. 按一下「Update」。

編輯取消佈建的時程

如何定義取消帳戶管理動作生效前的延遲時間:

  1. 在 Google 管理控制台中,依序點選「選單」圖示 接下來「應用程式」圖示 接下來「網頁和行動應用程式」。

    必須以超級管理員身分登入,才能執行這項工作。

  2. 按一下 SAML 應用程式的名稱。
  3. 點選「自動佈建」。
  4. 在「取消佈建」部分,按一下「編輯」。
  5. 針對每個事件 (「當使用者的應用程式遭到停用時」、「當使用者遭到 Google 停權時」和「當使用者遭到 Google 刪除時」),選取要採取的動作,以及 Google 在變更發生後等待多久才將要求傳送至您的應用程式 (「24 小時內」、「1 天後」、「7 天後」或「21 天後」):
    • 將使用者帳戶停權:在應用程式中停用使用者 (PATCH 或 PUT 搭配 active: false)。
    • 永久刪除使用者帳戶:從應用程式 (DELETE /Users/{id}) 永久刪除使用者。
      如果同時選取這兩個選項,請務必將永久刪除的延遲時間設得比停權時間長。
  6. 按一下「Update」。

停用自動佈建功能並刪除設定資訊

您可以關閉應用程式的自動佈建功能,而不會遺失設定資訊。您也可以關閉自動佈建功能,並移除所有設定資訊。

關閉自動佈建功能

如何停用應用程式的自動佈建功能,同時保留設定資訊:

  1. 在 Google 管理控制台中,依序點選「選單」圖示 接下來「應用程式」圖示 接下來「網頁和行動應用程式」。

    必須以超級管理員身分登入,才能執行這項工作。

  2. 按一下 SAML 應用程式的名稱。
  3. 選擇下列其中一種做法:
    • 關閉「自動佈建」。
    • 依序點選「自動佈建」接下來「狀態」接下來「關閉」。
  4. 按一下「關閉」加以確認。

停用自動佈建功能並刪除設定資訊

如要停用自動佈建功能,並移除所有設定資訊,請按照下列步驟操作:

  1. 在 Google 管理控制台中,依序點選「選單」圖示 接下來「應用程式」圖示 接下來「網頁和行動應用程式」。

    必須以超級管理員身分登入,才能執行這項工作。

  2. 按一下 SAML 應用程式的名稱。
  3. 點選「自動佈建」。
  4. 按一下「刪除」即可停用自動佈建功能,並移除所有設定資訊。
    系統不會移除現有使用者,他們仍可使用應用程式。

查看使用資訊

管理員記錄事件 說明
透過自動佈建功能建立使用者 透過自動佈建功能建立的使用者
更新自動佈建的使用者 透過自動佈建功能更新的使用者
將自動佈建的使用者停權 透過自動佈建功能停權的使用者
解除自動佈建使用者的停權狀態 透過自動佈建功能重新啟用的使用者
永久刪除自動佈建的使用者 透過自動佈建功能刪除的使用者
失敗 失敗的要求

如果自動佈建功能停止運作

如果 Google 無法再連線至您的應用程式,自動佈建功能就會停止運作。舉例來說,不記名權杖可能已過期或遭到撤銷,或是應用程式的 SCIM 網址可能已變更。如要修正問題,請更新權杖或網址:

  1. 在 Google 管理控制台中,依序點選「選單」圖示 接下來「應用程式」圖示 接下來「網頁和行動應用程式」。

    必須以超級管理員身分登入,才能執行這項工作。

  2. 按一下 SAML 應用程式的名稱。
  3. 點選「自動佈建」。
  4. 如要更新不記名權杖,請按照下列步驟操作:
    1. 在「應用程式授權」部分,按一下「重新授權」。
    2. 在「存取權杖」部分,貼上應用程式的新不記名權杖。
    3. 按一下「重新授權」。
  5. 如要更新 SCIM 基準網址,請在「端點網址」部分按一下「編輯」,輸入新網址,然後按一下「更新」。
  6. (選用) 如要驗證連線,請在「測試連線」部分點選「測試」。

如要進一步瞭解自動佈建功能停止運作的其他原因,請參閱應用程式的說明文件。