共用方式為


教學課程:針對自動使用者佈建設定 Bentley - Automatic User Provisioning

此教學課程說明您在 Bentley - Automatic User Provisioning 與 Microsoft Entra ID 中設定自動使用者佈建所需執行的步驟。 設定後,Microsoft Entra ID 將能利用 Microsoft Entra 佈建服務自動將使用者和群組佈建至 Bentley - Automatic User Provisioning 及取消佈建。 如需關於此服務之用途、運作方式和常見問題的重要詳細資料,請參閱 使用 Microsoft Entra ID 對 SaaS 應用程式自動佈建及取消佈建使用者

支援的功能

  • 在 Bentley - Automatic User Provisioning 中建立使用者
  • 當使用者不再需要任何存取權時,移除 Bentley - Automatic User Provisioning 中的使用者
  • 保持 Microsoft Entra ID 與 Bentley - Automatic User Provisioning 之間的使用者屬性同步
  • 在 Bentley - Automatic User Provisioning 中佈建群組和群組成員資格

必要條件

本教學課程中概述的案例假設您已經具有下列必要條件:

步驟 1:規劃佈建部署

  1. 了解佈建服務的運作方式 \(部分機器翻譯\)。
  2. 判斷誰會在佈建範圍 \(部分機器翻譯\) 內。
  3. 判斷在 Microsoft Entra ID 與 Bentley - Automatic User Provisioning 之間對應的資料。

步驟 2:設定 Bentley - Automatic User Provisioning 以支援使用 Microsoft Entra ID 進行佈建

請與 Bentley User Provisioning 支援小組聯繫,以取得租用戶 URL 和祕密權杖。 這些值會在 Bentley 應用程式的 [佈建] 索引標籤中輸入。

從 Microsoft Entra 應用程式資源庫新增 Bentley - Automatic User Provisioning 以啟動對於 Bentley - Automatic User Provisioning 的對應佈建。 在此深入了解從資源庫新增應用程式。

步驟 4:定義佈建範圍內的人員

透過 Microsoft Entra 佈建服務,可根據對應用程式的指派,或根據使用者/群組的屬性,界定要佈建的人員範圍。 如果選擇根據指派來界定將佈建至應用程式的人員,則可使用下列步驟將使用者和群組指派給應用程式。 如果選擇僅根據使用者或群組屬性來界定將要佈建的人員,即可使用如這裡所述的範圍篩選條件。

  • 從小規模開始。 在推出給所有人之前,先使用一小部分的使用者和群組進行測試。 當佈建範圍設為已指派的使用者和群組時,您可將一或兩個使用者或群組指派給應用程式來控制這點。 當範圍設為所有使用者和群組時,您可指定以屬性為基礎的範圍篩選條件

  • 如果需要其他角色,您可以更新應用程式資訊清單以新增角色。

步驟 5:將自動使用者佈建設定為 Bentley - Automatic User Provisioning

本節將逐步引導您設定 Microsoft Entra 佈建服務,以根據 Microsoft Entra ID 中的使用者及/或群組指派,在 TestApp 中建立、更新和停用使用者及/或群組。

若要在 Microsoft Entra ID 中針對 Bentley - Automatic User Provisioning 設定自動使用者佈建:

  1. 以至少 雲端應用程式系統管理員 的身分登入 Microsoft Entra 系統管理中心

  2. 瀏覽至 [身分識別]>[應用程式]>[企業應用程式]

    企業應用程式刀鋒視窗

  3. 在應用程式清單中,選取 [Bentley - Automatic User Provisioning]

    應用程式清單中的 [Bentley - 自動使用者佈建] 連結

  4. 選取 [佈建] 索引標籤。

    佈建索引標籤

  5. 將 [佈建模式] 設定為 [自動]

    佈建索引標籤 [自動]

  6. 在 [管理員認證] 區段下,輸入您的 Bentley - Automatic User Provisioning 租用戶 URL 和祕密權杖。 按一下 [測試連線] 以確保 Microsoft Entra ID 可以連線到 Bentley - Automatic User Provisioning。 如果連線失敗,請確定您的 Bentley - Automatic User Provisioning 帳戶具有管理員權限,然後再試一次。

    Token

  7. 在 [通知電子郵件] 欄位中,輸入應該收到佈建錯誤通知的個人或群組電子郵件地址,然後選取 [發生失敗時傳送電子郵件通知] 核取方塊。

    通知電子郵件

  8. 選取 [儲存]。

  9. [對應] 區段下方,選取 [將 Microsoft Entra 使用者同步處理至 Bentley - Automatic User Provisioning]

  10. [屬性對應] 區段中,檢閱從 Microsoft Entra ID 同步處理到 Bentley - Automatic User Provisioning 的使用者屬性。 選取為 [比對] 屬性的屬性會用來比對 Bentley - Automatic User Provisioning 中的使用者帳戶,以進行更新作業。 如果您選擇變更比對目標屬性,則必須確保 Bentley - Automatic User Provisioning API 支援根據該屬性來篩選使用者。 選取 [儲存] 按鈕以認可所有變更。

    屬性 類型 支援篩選
    userName String
    title String
    emails[type eq "work"].value String
    preferredLanguage String
    name.givenName String
    name.familyName String
    addresses[type eq "work"].streetAddress String
    addresses[type eq "work"].locality String
    addresses[type eq "work"].region String
    addresses[type eq "work"].postalCode String
    addresses[type eq "work"].country String
    phoneNumbers[type eq "work"].value String
    externalId String
    urn:ietf:params:scim:schemas:extension:Bentley:2.0:User:isSoftDeleted String
  11. [對應] 區段下方,選取 [將 Microsoft Entra 群組同步處理至 Bentley - Automatic User Provisioning]

  12. [屬性對應] 區段中,檢閱從 Microsoft Entra ID 同步處理到 Bentley - Automatic User Provisioning 的群組屬性。 選取為 [比對] 屬性的屬性會用來比對 Bentley - Automatic User Provisioning 中的群組,以進行更新作業。 選取 [儲存] 按鈕以認可所有變更。

    屬性 類型 支援篩選
    displayName String
    externalId String
    成員 參考
    urn:ietf:params:scim:schemas:extension:Bentley:2.0:Group:description String
  13. 若要設定範圍篩選,請參閱範圍篩選教學課程中提供的下列指示。

  14. 若要啟用 Bentley - Automatic User Provisioning 的 Microsoft Entra 佈建服務,在 [設定] 區段中,將 [佈建狀態] 變更為 [開啟]

    佈建狀態已切換為開啟

  15. 透過在 [設定] 區段的 [範圍] 中選擇需要的值,可定義要佈建到 Bentley - Automatic User Provisioning 的使用者和/或群組。

    佈建範圍

  16. 當您準備好要佈建時,按一下 [儲存]

    儲存雲端佈建設定

此作業會對在 [設定] 區段的 [範圍] 中所定義所有使用者和群組啟動首次同步處理週期。 初始週期會比後續週期花費更多時間執行,只要 Microsoft Entra 佈建服務正在執行,大約每 40 分鐘便會進行一次。

步驟 6:監視您的部署

設定佈建後,請使用下列資源來監視部署:

  1. 使用佈建記錄來判斷哪些使用者已佈建成功或失敗
  2. 檢查進度列來查看佈建週期的狀態,以及其接近完成的程度
  3. 如果佈建設定似乎處於狀況不良的狀態,則應用程式將會進入隔離狀態。 在此 \(部分機器翻譯\) 深入了解隔離狀態。

其他資源

下一步