教學課程：設定 M-Files 來自動布建使用者

發行項
05/02/2024

本教學課程說明您需要在 M-Files 和 Microsoft Entra ID 中執行的步驟，以設定自動使用者布建。設定時，Microsoft Entra ID 會自動使用 Microsoft Entra 布建服務將使用者和群組布建和取消布建至 M-Files 。如需此服務執行方式、運作方式和常見問題的重要詳細數據，請參閱使用 Microsoft Entra ID 將使用者布建和取消布建至 SaaS 應用程式。

支援的功能

在 M-Files 中建立使用者。
當使用者不再需要存取權時，請移除 M-Files 中的使用者。
讓 Microsoft Entra ID 與 M-Files 之間的使用者屬性保持同步。
在 M-Files 中布建群組和群組成員資格。
M-Files 的單一登錄（建議）。

必要條件

本教學課程中所述的案例假設您已經具備下列必要條件：

Microsoft Entra 租使用者
下列其中一個角色：應用程式管理員 istrator、Cloud Application 管理員 istrator 或應用程式擁有者。
M-Files 雲端訂用帳戶（不支持傳統雲端）。
M-Files 中的用戶帳戶，具有訂用帳戶管理員或存取 M-Files Manage 的系統管理員存取權。

步驟 1：規劃布建部署

瞭解布建服務的運作方式。
判斷誰將在布建範圍內。
判斷在 Microsoft Entra ID 與 M-Files 之間對應的數據。
必要的對應已預先定義，但您可以將兩個額外的數據欄位對應至 M-Files。

步驟 2：設定 M-Files 以支援使用 Microsoft Entra ID 進行布建

在 M-Files 中設定使用者布建之前，請確定訂用帳戶中的所有保存庫在 M-Files 管理員中已停用使用者同步處理。

如果您先前已使用自己的 Entra ID 應用程式在 M-Files Manage 中設定使用者布建，則無法變更組態以從 Microsoft Entra 應用連結庫使用 M-Files 應用程式。如果您想要改用 M-Files 應用程式，請從 M-Files Manage 中刪除現有的組態，並停用或刪除相關的 Entra ID 應用程式。然後，遵循這些指示來建立新的組態。

在登入 M-Files Manage。https://manage.m-files.com
在左側頁面導覽中，按兩下 [ 布建]。
移至 [ 組態] 索引標籤。
在 [建立使用者布建的組態] 中，按兩下 [Azure AD 資源庫應用程式]。
輸入必要的資訊。
- 在 [ 組態名稱] 中，輸入組態的唯一名稱。
- 選取 [已布建使用者的預設授權類型 ]。所有布建的用戶都會先取得此授權。在布建使用者群組之後，您可以將使用者群組的授權類型變更為較高的授權類型。如果訂用帳戶中預設授權類型沒有足夠的可用授權，所有使用者都不會取得授權。
按兩下每個數據片段的複製圖示（），該 M-Files Manage 已建立，並記下這些值。

注意

當您關閉對話框時，不會在其他地方顯示客戶端密碼。

步驟 3：從 Microsoft Entra 應用連結庫新增 M-Files

從 Microsoft Entra 應用連結庫新增 M-Files，以開始管理對 M-Files 的布建。如果您先前已針對 SSO 設定 M-Files，您可以使用相同的應用程式。不過，建議您在一開始測試整合時建立個別的應用程式。在這裡深入瞭解如何從資源庫新增應用程式。

步驟 4：定義將在布建範圍內的人員

Microsoft Entra 布建服務可讓您根據指派給應用程式，或根據使用者/群組的屬性來設定要布建的人員。如果您選擇根據指派將布建至應用程式的人員範圍，您可以使用下列步驟將使用者和群組指派給應用程式。如果您選擇只根據使用者或群組的屬性來設定要布建的人員範圍，您可以使用範圍篩選，如這裡所述。

從小規模開始。在向所有人推出之前，先使用一組小型的使用者和群組進行測試。當布建範圍設定為指派的使用者和群組時，您可以將一或兩個使用者或群組指派給應用程式來控制此設定。當範圍設定為所有使用者和群組時，您可以指定以屬性為基礎的範圍篩選。
如果您需要更多角色，您可以更新應用程式指令清單以新增角色。

步驟 5：設定自動使用者布建至 M-Files

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

若要在 Microsoft Entra 識別符中為 M-Files 設定自動使用者布建：

至少需以雲端應用程式系統管理員的身分登入 Microsoft Entra 系統管理中心。
流覽至 [身分>識別應用程式企業應用程式]。>
在應用程式清單中，選取 [M-Files]。
選取 [ 布建] 索引 標籤。
將 [布 建模式 ] 設定為 [ 自動]。
在 [管理員認證] 區段底下，輸入您的 M-Files 租使用者 URL、令牌端點、用戶端標識符和客戶端密碼。單擊 [測試連線，以確保 Microsoft Entra ID 可以連線到 M-Files。如果連線失敗，請確定您輸入的值正確，然後再試一次。
在 [ 通知電子郵件 ] 字段中，輸入應接收布建錯誤通知的人員或群組的電子郵件地址，然後選取 [失敗發生 時傳送電子郵件通知] 複選框。
選取 [儲存]。
選擇性：如果您想要同步處理其他使用者資訊，您可以定義要同步至 M-Files Manage 的兩個額外欄位。信息會顯示在 [使用者資訊] 頁面上的其他資訊 1 和 [其他資訊 2]。
1. 在 [ 對應] 區段底下，選取 [ 將 Microsoft Entra 使用者同步處理至 M-Files]。
2. 在 [ 屬性對應] 區段中，按兩下 [ 新增對應]。
3. 使用這些值：
  - 對應類型：直接
  - 來源屬性：輸入 Entra ID 屬性
  - 目標屬性：選取 urn：ietf：params：scim：schemas：extension：info：2.0：User：info1 或 urn：ietf：params：scim：schemas：extension：info：2.0：User：info2
  - 使用此屬性比對物件：否
  - 套用此對應：永遠
4. 按一下 [確定] 。
5. 選擇性：若要將兩個額外的數據欄位同步處理至 M-Files Manage，請新增第二個對應與其他可用的目標屬性。