教學課程：設定 Insite LMS 來自動佈建使用者

發行項
06/24/2024

本教學課程說明您在 Insite LMS 和 Microsoft Entra ID 中設定自動使用者佈建所需的步驟。設定完成後，Microsoft Entra ID 會使用 Microsoft Entra 佈建服務，對 Insite LMS 自動佈建和取消佈建使用者。如需此服務的用途、運作方式和常見問題等重要詳細資訊，請參閱將使用 Microsoft Entra ID 對於 SaaS 應用程式的使用者佈建和取消佈建流程自動化。

支援的功能

在 Insite LMS 中建立使用者
當使用者不再需要存取時，將其從 Insite LMS 中移除
讓使用者屬性在 Microsoft Entra ID 與 Insite LMS 之間保持同步

必要條件

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

Microsoft Entra 租用戶
下列其中一個角色：應用程式系統管理員、雲端應用程式管理員或應用程式擁有者。
Insite LMS 租用戶。
Insite LMS 中具有管理員權限的使用者帳戶。

步驟 1：規劃佈建部署

了解佈建服務的運作方式 \(部分機器翻譯\)。
定義在佈建範圍內的人員。
決定要在 Microsoft Entra ID 與 Insite LMS 之間對應哪些資料。

步驟 2：設定 Insite LMS 以支援使用 Microsoft Entra ID 進行佈建

產生秘密權杖

使用您的系統管理帳戶登入 Insite LMS Console。
瀏覽至左側選單上的 [應用程式] 模組。
在 [自我裝載的作業] 區段中，可找到名為「SCIM」的作業。如果找不到該作業，請連絡 LMS 支援小組。
按一下 [產生 API 金鑰]。複製並儲存 API 金鑰。此值會輸入到 Insite LMS 應用程式 [佈建] 索引標籤中的 [祕密權杖] 欄位。

注意

API 金鑰效期僅有 1 年，且必須在到期之前手動更新。

步驟 3：從 Microsoft Entra 應用程式庫新增 Insite LMS

從 Microsoft Entra 應用程式資源庫新增 Insite LMS，以開始管理對 Insite LMS 的佈建。如果您先前已針對 SSO 設定 Insite LMS，則可使用相同的應用程式。不過，建議您在一開始測試整合時，建立個別的應用程式。在此深入了解從資源庫新增應用程式。

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

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

從小規模開始。在推出給所有人之前，先使用一小部分的使用者和群組進行測試。當佈建範圍設為已指派的使用者和群組時，您可將一或兩個使用者或群組指派給應用程式來控制這點。當範圍設為所有使用者和群組時，您可指定以屬性為基礎的範圍篩選條件。
如果需要其他角色，您可以更新應用程式資訊清單以新增角色。

步驟 5：設定將使用者自動佈建至 Insite LMS

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

在 Microsoft Entra ID 中為 Insite LMS 設定自動使用者佈建：

以至少雲端應用程式系統管理員的身分登入 Microsoft Entra 系統管理中心。
瀏覽至 [身分識別]>[應用程式]>[企業應用程式]
在應用程式清單中，選取 [Insite LMS]。
選取 [佈建] 索引標籤。
將 [佈建模式] 設定為 [自動]。
在 [管理員認證] 區段中，在 Insite LMS 的 [租用戶 URL] 輸入 https://api.insitelms.net/scim，並且輸入上述步驟 2 產生的祕密權杖。選取 [測試連線]，以確保 Microsoft Entra ID 可以連線到 Insite LMS。如果連線失敗，請確定您的 Insite LMS 帳戶具有管理員權限，然後再試一次。
在 [通知電子郵件] 欄位中，輸入應收到佈建錯誤通知的個人或群組電子郵件地址。選取 [發生失敗時傳送電子郵件通知] 核取方塊。
選取 [儲存]。
在 [對應] 區段中，選取 [將 Microsoft Entra 使用者同步至 Insite LMS]。

在 [屬性對應] 區段中，檢閱從 Microsoft Entra ID 同步至 Insite LMS 的使用者屬性。選取為 [比對] 屬性的屬性會用來比對 Insite LMS 中的使用者帳戶，以進行更新作業。如果您變更了比對目標屬性，則必須確保 Insite LMS API 支援根據該屬性來篩選使用者。選取 [儲存] 認可任何變更。

屬性	類型	支援篩選	Insite LMS 需求
userName	String	✓	✓
emails[type eq "work"].value	String	✓	✓
作用中	布林值
name.givenName	String
name.familyName	String
phoneNumbers[type eq "work"].value	String

若要設定範圍篩選條件，請參閱範圍篩選教學課程中提供的指示。
若要啟用 Insite LMS 的 Microsoft Entra 佈建服務，請在 [設定] 區段中，將 [佈建狀態] 變更為 [開啟]。
在 [設定] 區段的 [範圍] 中選取所需的值，以定義要佈建至 Insite LMS 的使用者或群組。
準備好要佈建時，請選取 [儲存]。

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

步驟 6：監視您的部署

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

使用佈建記錄可以判斷使用者是否已順利完成佈建。
檢查進度列來查看佈建週期的狀態，以及其接近完成的程度。
如果佈建設定似乎處於狀況不良的狀態，則應用程式將會進入隔離狀態。若要深入了解隔離狀態，請參閱隔離的應用程式佈建狀態。

下一步

瞭解如何針對佈建活動檢閱記錄和取得報告

共用方式為