教學課程:設定 Code42 來自動佈建使用者
此教學課程說明您在 Code42 與 Microsoft Entra ID 中設定自動佈建使用者所需執行的步驟。 設定時,Microsoft Entra ID 會使用 Microsoft Entra 佈建服務,對 Code42 自動佈建和取消佈建使用者和群組。 如需此服務用途、運作方式和常見問題的重要詳細資料,請參閱將使用 Microsoft Entra ID 對於 SaaS 應用程式的使用者佈建和取消佈建自動化。
支援的功能
- 在 Code42 中建立使用者
- 當使用者不再需要存取權時,將其從 Code42 中移除
- 讓 Microsoft Entra ID 與 Code42 之間的使用者屬性保持同步
- 在 Code42 中佈建群組和群組成員資格
- 對 Code42 使用單一登入 (建議)
必要條件
本教學課程中概述的案例假設您已經具有下列必要條件:
- Microsoft Entra 租用戶
- 下列其中一個角色:應用程式系統管理員、雲端應用程式管理員或應用程式擁有者。
- 已啟用身分識別管理的 Code42 租用戶。
- 具有客戶雲端管理員權限的 Code42 使用者帳戶。
步驟 1:規劃佈建部署
- 了解佈建服務的運作方式 \(部分機器翻譯\)。
- 判斷誰會在佈建範圍 \(部分機器翻譯\) 內。
- 判斷要在 Microsoft Entra ID 與 Code42 之間對應哪些資料。
步驟 2:設定 Code42 以支援使用 Microsoft Entra ID 進行佈建
本節會引導您完成相關步驟,以便在 Code42 主控台的 [身分識別管理] 區段中,將 Microsoft Entra ID 設定為佈建提供者。 這麼做可讓 Code42 安全地從 Microsoft Entra ID 接收佈建要求。 建議您先檢閱 Code42 的支援文件,再使用 Microsoft Entra ID 進行佈建。
若要在 Code42 的主控台中建立佈建提供者:
- 登入您的 Code42 主控台。 選取 [系統管理] 以展開導覽功能表。 依序選取 [設定] 和 [身分識別管理]。
- 選取 [佈建] 索引標籤。然後展開 [新增佈建提供者] 功能表,並選取 [新增 SCIM 提供者]。
- 在 [顯示名稱] 欄位中,輸入佈建提供者的唯一名稱。 將 [驗證認證類型] 設定為 [OAuth 權杖]。 選取 [下一步] 以產生認證。
注意
- 讓此視窗保持開啟,直到系統提示您輸入後續步驟中所需的 [基底 URL] 和 [權杖]。
- 或者,請將此資訊複製到暫存位置以供日後參考。
步驟 3:從 Microsoft Entra 應用程式資源庫新增 Code42
從 Microsoft Entra 應用程式資源庫新增 Code42 以開始管理對 Code42 的佈建。 如果您先前已針對 SSO 設定 Code42,則可使用相同的應用程式。 不過,建議在一開始測試整合時,建立個別的應用程式。 在此深入了解從資源庫新增應用程式。
步驟 4:定義佈建範圍內的人員
透過 Microsoft Entra 佈建服務,可根據對應用程式的指派,或根據使用者/群組的屬性,界定要佈建的人員範圍。 如果選擇根據指派來界定將佈建至應用程式的人員,則可使用下列步驟將使用者和群組指派給應用程式。 如果選擇僅根據使用者或群組屬性來界定將要佈建的人員,即可使用如這裡所述的範圍篩選條件。
從小規模開始。 在推出給所有人之前,先使用一小部分的使用者和群組進行測試。 當佈建範圍設為已指派的使用者和群組時,您可將一或兩個使用者或群組指派給應用程式來控制這點。 當範圍設為所有使用者和群組時,您可指定以屬性為基礎的範圍篩選條件。
如果需要其他角色,您可以更新應用程式資訊清單以新增角色。
步驟 5:對 Code42 設定自動使用者佈建
本節將逐步引導您設定 Microsoft Entra 佈建服務,以根據 Microsoft Entra ID 中的使用者及/或群組指派,在 TestApp 中建立、更新和停用使用者及/或群組。
若要在 Microsoft Entra ID 中為 Code42 設定自動佈建使用者:
以至少 雲端應用程式系統管理員 的身分登入 Microsoft Entra 系統管理中心。
瀏覽至 [身分識別] > [應用程式] > [企業應用程式]
在應用程式清單中,選取 [Code42]。
選取 [佈建] 索引標籤。
將 [佈建模式] 設定為 [自動]。
在 [管理員認證] 區段底下,分別在 [租用戶 URL] 和 [祕密權杖] 中輸入稍早從 Code42 擷取到的 [SCIM 2.0 基底 URL] 和 [存取權杖] 值。 按一下 [測試連線],以確定 Microsoft Entra ID 可以連線至 Code42。 如果連線失敗,請確定您的 Code42 帳戶具有管理員權限並再試一次。
在 [通知電子郵件] 欄位中,輸入應該收到佈建錯誤通知的個人或群組電子郵件地址,然後選取 [發生失敗時傳送電子郵件通知] 核取方塊。
選取 [儲存]。
在 [對應] 區段底下,選取 [將 Microsoft Entra 使用者同步處理至 Code42]。
在 [屬性對應] 區段中,檢閱從 Microsoft Entra ID 同步處理至 Code42 的使用者屬性。 選取為 [比對] 屬性 (Property) 的屬性 (Attribute) 會用來比對 Code42 中的使用者帳戶以進行更新作業。 如果您選擇變更比對目標屬性,則必須確保 Code42 API 支援根據該屬性來篩選使用者。 選取 [儲存] 按鈕以認可所有變更。
屬性 類型 userName String 作用中 布林值 title String emails[type eq "work"].value String name.givenName String name.familyName String addresses[type eq "work"].locality String addresses[type eq "work"].region String addresses[type eq "work"].country String externalId String userType String urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department String urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division String urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager 參考 在 [對應] 區段底下,選取 [將 Microsoft Entra 群組同步至 Code42]。
在 [屬性對應] 區段中,檢閱從 Microsoft Entra ID 同步至 Code42 的群組屬性。 選取為 [比對] 屬性 (Property) 的屬性 (Attribute) 會用來比對 Code42 中的群組以進行更新作業。 選取 [儲存] 按鈕以認可所有變更。
屬性 類型 displayName String externalId String 成員 參考 若要設定範圍篩選,請參閱範圍篩選教學課程中提供的下列指示。
若要啟用 Code42 的 Microsoft Entra 佈建服務,請將 [佈建狀態] 變更為 [開啟](位於 [設定] 區段中)。
透過在 [設定] 區段的 [範圍] 中選擇需要的值,可定義要佈建到 Code42 的使用者和/或群組。
當您準備好要佈建時,按一下 [儲存]。
此作業會對在 [設定] 區段的 [範圍] 中所定義所有使用者和群組啟動首次同步處理週期。 初始週期會比後續週期花費更多時間執行,只要 Microsoft Entra 佈建服務正在執行,大約每 40 分鐘便會進行一次。
步驟 6:監視您的部署
設定佈建後,請使用下列資源來監視部署:
- 使用佈建記錄來判斷哪些使用者已佈建成功或失敗
- 檢查進度列來查看佈建週期的狀態,以及其接近完成的程度
- 如果佈建設定似乎處於狀況不良的狀態,則應用程式將會進入隔離狀態。 在此 \(部分機器翻譯\) 深入了解隔離狀態。
其他資源
- 管理企業應用程式的使用者帳戶佈建
- 什麼是搭配 Microsoft Entra ID 的應用程式存取和單一登入?
- 根據 Code42 中的 SCIM 群組來設定組織指派
- 根據 Code42 中的 SCIM 群組來設定角色指派