共用方式為


教學課程:設定 Miro 來自動佈建使用者

本教學課程旨在示範將 Microsoft Entra ID 設定為可對 Miro 自動佈建及取消佈建使用者和/或群組時,Miro 與 Microsoft Entra ID 中須執行的步驟。

注意

本教學課程說明建置在 Microsoft Entra 使用者佈建服務之上的連接器。 如需此服務執行方式、運作方式和常見問題的重要詳細資源,請參閱 使用 Microsoft Entra ID 將使用者佈建和取消佈建至 SaaS 應用程式

必要條件

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

  • Microsoft Entra 租用戶
  • Miro 租用戶
  • Miro 中具有管理員權限的使用者帳戶。

將使用者指派給 Miro

Microsoft Entra ID 會使用名為指派的概念,來判斷哪些使用者應接收對所選應用程式的存取權。 在自動佈建使用者的內容中,只有已指派至 Microsoft Entra ID 中應用程式的使用者和/或群組會進行同步處理。

設定並啟用自動佈建使用者之前,您應先決定 Microsoft Entra ID 中的哪些使用者和/或群組需要存取 Miro。 一旦決定後,您可以依照此處的指示,將這些使用者和/或群組指派給 Miro:

將使用者指派給 Miro 的重要秘訣

  • 建議將單一 Microsoft Entra 使用者指派給 Miro,以測試自動佈建使用者的設定。 其他使用者及/或群組可能會稍後再指派。

  • 將使用者指派給 Miro 時,您必須在 [指派] 對話方塊中選取任何有效的應用程式特有角色 (如果有的話)。 具有預設存取角色的使用者會從佈建中排除。

設定 Miro 以進行佈建

若要擷取所需的祕密權杖,請與 Miro 支援小組聯絡。 此值會輸入到 Miro 應用程式 [佈建] 索引標籤中的 [祕密權杖] 欄位。

設定 Miro 使用 Microsoft Entra ID 進行自動佈建使用者之前,必須從 Microsoft Entra 應用程式庫將 Miro 新增至您的受控 SaaS 應用程式清單。

若要從 Microsoft Entra 應用程式庫新增 Miro,請執行下列步驟:

  1. 以至少 雲端應用程式系統管理員 的身分登入 Microsoft Entra 系統管理中心
  2. 瀏覽至 [身分識別] > [應用程式] > [企業應用程式] > [新增應用程式]
  3. 在 [從資源庫新增] 區段的搜尋方塊中輸入 Miro
  4. 從結果面板選取 [Miro],然後新增應用程式。 將應用程式新增至您的租用戶時,請稍候幾秒鐘。

對 Miro 設定自動使用者佈建

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

提示

建議您選擇為 Miro 啟用 SAML 型單一登入,方法是遵循 Miro 單一登入教學課程中提供的指示。 單一登入和自動使用者佈建可以分開設定,但這兩個功能是互補的。

注意

若要深入了解 Miro 的 SCIM 端點,請參閱本文

若要在 Microsoft Entra ID 中為 Miro 設定自動使用者佈建

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

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

    企業應用程式刀鋒視窗

  3. 在應用程式清單中,選取 [Miro]

    應用程式清單中的 Miro 連結

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

    [管理] 選項的螢幕擷取畫面,並已指出 [佈建] 選項。

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

    [佈建模式] 下拉式清單的螢幕擷取畫面,並已指出 [自動] 選項。

  6. 在 [管理員認證] 區段下的 [租用戶 URL] 中輸入 https://miro.com/api/v1/scim。 輸入稍早在 [秘密權杖] 中擷取到的 [SCIM 權杖驗證] 值。 按兩下 [測試連線] 以確保 Microsoft Entra ID 可以連線到 Miro。 如果連線失敗,請確定您的 Miro 帳戶具有管理員權限並再試一次。

    租用戶 URL + 權杖

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

    通知電子郵件

  8. 按一下 [檔案] 。

  9. 在 [對應] 區段底下,選取 [將 Microsoft Entra 使用者同步處理至 Miro]

  10. 在 [屬性對應] 區段中,檢閱從 Microsoft Entra ID 同步處理至 Miro 的使用者屬性。 選取為 [比對] 屬性 (Property) 的屬性 (Attribute) 會用來比對 Miro 中的使用者帳戶,以進行更新作業。 選取 [儲存] 按鈕以認可所有變更。

    Miro 使用者屬性

  11. 在 [對應] 區段下,選取 [將 Microsoft Entra 群組同步處理至 Miro]

  12. 在 [屬性對應] 區段中,檢閱從 Microsoft Entra ID 同步處理至 Miro 的群組屬性。 選取為 [比對] 屬性 (Property) 的屬性 (Attribute) 會用來比對 Miro 中的群組以進行更新作業。 選取 [儲存] 按鈕以認可所有變更。 取消核取 [目標物件動作] 底下的 [建立] 和 [刪除],因為 Miro SCIM API 不支援建立和刪除群組。

    Miro 群組屬性

  13. 若要設定範圍篩選,請參閱範圍篩選教學課程中提供的下列指示。

  14. 若要啟用適用於 Miro 的 Microsoft Entra 佈建服務,請在 [設定] 區段中,將 [佈建狀態] 變更為 [開啟]

    佈建狀態已切換為開啟

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

    佈建範圍

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

    儲存雲端佈建設定

此作業會對在 [設定] 區段的 [範圍] 中定義的所有使用者和/或群組,啟動首次同步處理。 初始同步處理會比後續同步處理花費更多時間執行,只要 Microsoft Entra 佈建服務正在執行,這大約每 40 分鐘便會發生一次。 您可以使用 [同步處理詳細資料] 區段來監視進度,並遵循連結來佈建活動報告,當中會描述 Miro 上的 Microsoft Entra 佈建服務所執行之所有動作。

如需如何讀取 Microsoft Entra 佈建記錄的詳細資訊,請參閱關於使用者帳戶自動佈建的報告

連接器限制

  • Miro 的 SCIM 端點不允許對群組執行建立刪除作業。 其只支援群組的更新作業。

疑難排解秘訣

  • 如果發生群組建立錯誤,則必須取消核取 [目標物件動作] 下的 [建立] 和 [刪除],因為 Miro SCIM API 不支援建立和刪除群組。

    Miro 群組秘訣

其他資源

下一步