本文說明您需要在 Bentley - 自動使用者布建和Microsoft Entra ID 中執行的步驟，以設定自動使用者布建。 設定時，Microsoft Entra ID 會使用 Microsoft Entra 布建服務，自動將使用者和群組布建和取消布建至 Bentley - 自動使用者布建。 如需此服務的用途、運作方式和常見問題等重要詳細資訊，請參閱使用 Microsoft Entra ID 自動對 SaaS 應用程式進行使用者佈建和取消佈建。
支援的功能
- 在 Bentley 中建立使用者 - 自動使用者配置
- 移除 Bentley 中的使用者 - 當他們不再需要存取權時，自動使用者佈建系統將執行
- 讓使用者屬性在 Microsoft Entra ID 與 Bentley 之間保持同步 - 自動使用者布建
- 在 Bentley 中布建群組和群組成員資格 - 自動使用者布建
先決條件
本文中所述的案例假設您已經具備下列必要條件：
- 一個具有有效訂閱的 Microsoft Entra 用戶帳戶。 若尚未有帳戶，可以免費建立帳戶。
- 下列其中一個角色：
- 與 Bentley IMS 的同盟帳戶。
步驟 1：規劃您的配置部署
- 了解配置服務的運作方式。
- 判斷哪些人員在資源配置範圍內。
- 判斷要 項目標識碼與 Bentley Microsoft - 自動使用者布建之間的數據。
步驟 2：設定 Bentley 自動使用者布建，以支援使用 Microsoft Entra ID 進行布建
請連絡 Bentley 使用者配置支援團隊 ，請索取租戶 URL 和秘密令牌。 這些值會在 Bentley 應用程式的 [布建] 索引標籤中輸入。
步驟 3：新增 Bentley - 從 Microsoft Entra 應用程式庫自動配置使用者
從 Microsoft Entra 應用連結庫新增 Bentley - 自動使用者布建，以開始管理布建至 Bentley - 自動使用者布建。 在此瞭解更多有關從圖庫新增應用程式的資訊。
步驟 4：定義布建範圍中的人員
Microsoft Entra 布建服務可讓您根據指派給應用程式，或根據使用者或群組的屬性來設定布建的人員範圍。 如果您選擇根據指派來設定布建至應用程式的人員範圍，您可以使用 步驟將使用者和群組指派給應用程式。 如果您選擇僅依據使用者或群組的屬性來設定布建範圍，則可以 使用範圍篩選。
從小規模開始。 在向所有人推出之前，先使用一組小型的使用者和群組進行測試。 當佈建範圍設為已指派的使用者和群組時，您可將一或兩個使用者或群組指派給應用程式來控制這點。 當範圍設為所有使用者和群組時，您可指定以屬性為基礎的範圍篩選條件。
如果您需要額外的角色，您可以 更新應用程式指令清單 以新增角色。
步驟 5：將自動使用者布建設定為 Bentley - 自動使用者布建
本章節將逐步引導您設定 Microsoft Entra 佈建服務，以根據 Microsoft Entra ID 中的使用者和/或群組指派，在 TestApp 中建立、更新和停用使用者和/或群組。
若要為 Bentley 設定自動使用者佈建 - Microsoft Entra ID 中的自動使用者佈建：
以至少 雲端應用程式系統管理員 的身分登入 Microsoft Entra 系統管理中心。
導覽至 Entra ID>企業應用程式
在應用程式清單中，選取 [Bentley - 自動使用者配置]。
選擇 佈建 索引標籤。
將 [佈建模式] 設定為 [自動]。
在 [管理員憑證] 區段下，輸入您的 Bentley - 自動化使用者配置租戶 URL 和秘密令牌。 選取 [測試連線 以確保Microsoft Entra ID 可以連線到 Bentley - 自動使用者布建。 如果連線失敗，請確定您的 Bentley - 自動使用者布建帳戶具有系統管理員許可權，然後再試一次。
在 [通知電子郵件] 欄位中，輸入應該收到佈建錯誤通知的個人或群組電子郵件地址，然後選取 [發生失敗時傳送電子郵件通知] 核取方塊。
選取 [儲存]。
在 [對應] 區段底下，選取 [將 Microsoft Entra 使用者同步至 Bentley - 自動使用者佈建]。
檢閱從 Microsoft Entra ID 同步到 Bentley 的自動使用者布建在 屬性對應 區段中的用戶屬性。 選擇作為 [比對] 屬性的這些屬性，用於在 Bentley 的自動使用者布建中，比對用戶帳戶以執行更新作業。 如果您選擇變更 比對目標屬性，您必須確定 Bentley - 自動使用者布建 API 支援根據該屬性篩選使用者。 點擊 儲存 按鈕以儲存所有變更。
屬性 類型 支持篩選 使用者名稱 字符串 ✓ 標題 字符串 電子郵件[類型等於“工作”].值 字符串 首選語言 字符串 名稱.名字 字符串 姓名.姓氏 字符串 addresses[type eq “work”].streetAddress 字符串 addresses[type eq "work"].locality － 用於工作地址的屬性。 字符串 地址[類型 相等 “工作”].地區 字符串 地址[type eq "work"].郵遞區號 字符串 addresses[type eq "工作"].國家 字符串 phoneNumbers[type eq "工作"].value 字符串 externalId（外部識別碼） 字符串 urn：ietf：params：scim：schemas：extension：Bentley：2.0：User：isSoftDeleted 字符串 在 [對應] 區段中，選取 [將 Microsoft Entra 群組同步至 Bentley - 自動化使用者供應]。
檢閱從 Microsoft Entra ID 同步至 Bentley - Attribute-Mapping 區段中自動使用者布建的群組屬性。 選取為 匹配 屬性的屬性用於在 Bentley 中自動使用者布建的更新操作中匹配群組。 點擊 儲存 按鈕以儲存所有變更。
屬性 類型 支持篩選 顯示名稱 字符串 ✓ externalId（外部識別碼） 字符串 成員 參考文獻 urn：ietf：params：scim：schemas：extension：Bentley：2.0：Group：description 字符串 若要設定範圍篩選，請參閱 範圍篩選一文中提供的下列指示，。
若要啟用 Microsoft Entra 的 Bentley - 自動使用者布建服務，請在 [設定] 區段中，將 [布建狀態] 變更為 [開啟]。
定義您想要布建至 Bentley 的使用者和/或群組 - 自動使用者布建，方法是在 [設定] 區段中，選擇 [範圍] 中所需的值。
當您準備好進行配置時，請選取 [ 儲存]。
此作業會啟動在 [ 設定] 區段中 範圍 中定義之所有使用者和群組的初始同步處理週期。 初始週期會比後續週期花費更多時間執行，只要 Microsoft Entra 佈建服務正在執行，這大約每 40 分鐘便會發生一次。
步驟 6：監視您的部署
設定佈建後，請使用下列資源來監視部署：
- 使用 佈建記錄 可以判斷使用者是否已順利完成佈建
- 檢查 進度列 以查看配置週期的狀態，以及該週期接近完成的程度。
- 如果佈建設定似乎處於狀況不良的狀態，則應用程式將會進入隔離狀態。 深入瞭解 應用程式的布建隔離狀態，請參閱文章 №。