教學課程：設定 MURAL Identity 的自動使用者佈建
此教學課程說明您在 MURAL Identity與 Microsoft Entra ID 中設定自動使用者佈建所需的步驟。 設定時，Microsoft Entra ID 會使用 Microsoft Entra 佈建服務，自動佈建和取消佈建使用者和群組至 MURAL Identity。 如需關於此服務之用途、運作方式和常見問題的重要詳細資料，請參閱 使用 Microsoft Entra ID 對 SaaS 應用程式自動佈建及取消佈建使用者。
支援的功能
- 在 MURAL Identity 建立使用者
- 使用者不再需要存取時，將其從 MURAL Identity中移除。
- 讓 Microsoft Entra ID 與 MURAL Identity之間的使用者屬性保持同步
- 在 MURAL Identity中佈建群組和群組成員資格。
- 單一登錄以進行 MURAL Identity (建議)。
必要條件
本教學課程中概述的案例假設您已經具有下列必要條件：
- Microsoft Entra 租用戶。
- 下列其中一個角色：應用程式系統管理員、雲端應用程式管理員或應用程式擁有者。
- SCIM 佈建僅適用於 MURAL 的企業版方案。 設定 SCIM 佈建之前，請連絡 MURAL 客戶成功小組的成員以啟用此功能。
- 您必須先正確設定 SAML 式 SSO，才能設定自動佈建。 如需了解如何透過 Microsoft Entra ID 為 MURAL 設定 SSO，請參閱此處。
步驟 1：規劃佈建部署
- 了解佈建服務的運作方式 \(部分機器翻譯\)。
- 判斷誰會在佈建範圍 \(部分機器翻譯\) 內。
- 判斷要在 Microsoft Entra ID 與 MURAL Identity之間對應的資料。
步驟 2：設定 MURAL Identity，支援使用 Microsoft Entra ID 進行佈建
請遵循 這些步驟，從 MURAL 公司儀表板中的 API 金鑰頁面取得您的 SCIM URL 和唯一 API 權杖。 在 步驟 5 的「秘密權杖」欄位中使用此金鑰。
步驟 3：從 Microsoft Entra 應用程式庫新增 MURAL Identity
從 Microsoft Entra 應用程式庫新增 MURAL Identity，藉此開始管理對 Palo Alto Networks SCIM Connector 的佈建。 如果您之前已設定 MURAL Identity 的 SSO，則可使用相同的應用程式。 不過，建議在一開始測試整合時，建立個別的應用程式。 在此深入了解從資源庫新增應用程式。
步驟 4：定義佈建範圍內的人員
Microsoft Entra 佈建服務可讓您根據指派給應用程式，或根據使用者/群組的屬性來設定佈建的人員範圍。 如果選擇根據指派來界定將佈建至應用程式的人員，則可使用下列步驟將使用者和群組指派給應用程式。 如果選擇僅根據使用者或群組屬性來界定將要佈建的人員，即可使用如這裡所述的範圍篩選條件。
從小規模開始。 在推出給所有人之前，先使用一小部分的使用者和群組進行測試。 當佈建範圍設為已指派的使用者和群組時，您可將一或兩個使用者或群組指派給應用程式來控制這點。 當範圍設為所有使用者和群組時，您可指定以屬性為基礎的範圍篩選條件。
如果需要其他角色，您可以更新應用程式資訊清單以新增角色。
步驟 5：設定 MURAL Identity 的自動使用者佈建
本節將引導逐步設定 Microsoft Entra 佈建服務，以根據 Microsoft Entra ID 中的使用者和/或群組指派，在 MURAL Identity中建立、更新和停用使用者和/或群組。
若要在 Microsoft Entra ID 設定 MURAL Identity 自動使用者佈建：
以至少 雲端應用程式系統管理員 的身分登入 Microsoft Entra 系統管理中心。
瀏覽至 [身分識別]>[應用程式]>[企業應用程式]
在應用程式清單中，選取 [MURAL Identity]。
選取 [佈建] 索引標籤。
將 [佈建模式] 設定為 [自動]。
在 [管理員認證] 區段下，輸入您的 MURAL Identity 租用戶 URL 與祕密權杖。 按一下 [測試連線]，確定 Microsoft Entra ID 可以連線至 MURAL Identity。 如果連線失敗，請確認您的 MURAL Identity 帳戶具有管理員權限，然後再試一次。
在 [通知電子郵件] 欄位中，輸入應該收到佈建錯誤通知的個人或群組電子郵件地址，然後選取 [發生失敗時傳送電子郵件通知] 核取方塊。
選取 [儲存]。
在 [對應] 區段底下，選取 [將 Microsoft Entra 使用者同步處理至 MURAL Identity]。
在 [屬性對應] 區段中，檢閱從 Microsoft Entra ID 同步處理至 MURAL Identity 的使用者屬性。 如果該屬性已選為 [比對] 屬性，就會在更新作業中用於比對 MURAL Identity 中的使用者帳戶。 如果您選擇變更比對目標屬性，則您必須確認 MURAL Identity API 可根據該屬性來支援篩選使用者。 選取 [儲存] 按鈕以認可所有變更。
屬性 類型 支援篩選 MURAL Identity 的必要項目 userName String emails[type eq "work"].value String 作用中 布林值 name.givenName String name.familyName String externalId String 在 [對應] 區段底下，選取 [將 Microsoft Entra 群組同步處理至 MURAL Identity]。
在 [屬性對應] 區段中，檢閱從 Microsoft Entra ID 同步處理至 MURAL Identity 的群組屬性。 如果該屬性已選為 [比對] 屬性，就會在更新作業中用於比對 MURAL Identity 中的群組。 選取 [儲存] 按鈕以認可所有變更。
屬性 類型 支援篩選 MURAL Identity 的必要項目 displayName String 成員 參考 externalId String 若要設定範圍篩選，請參閱範圍篩選教學課程中提供的下列指示。
如要啟用 MURAL Identity 的 Microsoft Entra 佈建服務，請在 [設定] 區段中，將 [佈建狀態] 變更為 [開啟]。
在 [設定] 區段的 [範圍] 中選擇所需的值，即可定義要佈建至 MURAL Identity 的使用者和/或群組。
當您準備好要佈建時，按一下 [儲存]。
此作業會對在 [設定] 區段的 [範圍] 中所定義所有使用者和群組啟動首次同步處理週期。 初始週期的執行時間比後續迴圈要長，只要 Microsoft Entra 佈建服務仍在執行，大約每 40 分鐘就會發生一次。
步驟 6：監視您的部署
設定佈建後，請使用下列資源來監視部署：
- 使用佈建記錄來判斷哪些使用者已佈建成功或失敗
- 檢查進度列來查看佈建週期的狀態，以及其接近完成的程度
- 如果佈建設定似乎處於狀況不良的狀態，則應用程式將會進入隔離狀態。 在此 \(部分機器翻譯\) 深入了解隔離狀態。
疑難排解秘訣
- 佈建使用者時請注意，我們不支援在 MURAL 的名稱欄位 (即 givenName 或 familyName) 中填入數字。
- 在 GET 端點中篩選 userName 時，電子郵件地址務須全部小寫，否則您會收到空白的結果。 這是因為我們在佈建帳戶時會將電子郵件地址轉換成小寫。
- 如果取消佈建使用者 (將作用中的屬性設定為 false)，使用者會遭到虛刪除，並失去所有工作區的存取權。 如果同一個遭到取消佈建的使用者於稍後再次啟用 (將作用中屬性設定為 true)，該使用者將無法存取先前所屬的工作區使用者。 使用者會看到錯誤訊息「您已在此工作區中遭到停用」，雖可選擇要求重新啟用，但必須經過工作區管理員的核准。
- 如有任何其他問題，請連絡 MURAL Identity 支援小組。
變更記錄檔
06/22/2023 - 已新增群組佈建的支援。