設定 Open LMS 的 Moodle LMS 外掛程式

在本文中，您將瞭解如何安裝和設定 Moodle LMS 外掛程式，以整合 Microsoft Teams 與您的 Open LMS 體驗。

必要條件

若要設定已安裝的 Open LMS 以與 Microsoft Teams 搭配使用：

• 確認 Moodle OpenID Connect 和 Microsoft 365 整合 外掛程式已啟用。

設定 Microsoft 365 外掛程式與 Microsoft 服務之間的連線

您必須先設定Microsoft 365 外掛程式與Microsoft服務之間的連線，才能一起運作。

啟用 OpenID Connect 驗證外掛程式

為了讓 Moodle 外掛程式與Microsoft服務通訊，必須開啟並設定 OpenID Connect 驗證外掛程式。

1. 流覽至 [月臺管理>外掛程式>驗證] ，然後選 取 [管理驗證]。
2. 尋找 OpenID Connect 驗證外掛程式，然後選取 眼睛圖示 來開啟它。
3. 選 取 外掛程式的 [設定] 以驗證 授權 和 令牌 端點。
   1. 預設值應該是：
      1. 授權端點： https://login.microsoftonline.com/common/oauth2/authorize。
      2. 令牌端點： https://login.microsoftonline.com/common/oauth2/token。
4. 記錄 重新導向 URI 以供稍後使用。

先決條件

使用 PowerShell 腳本，將 Open LMS 註冊為 Microsoft Entra ID 中的應用程式。 文稿會布建下列專案：

• Microsoft 365 租使用者的新 Microsoft Entra 應用程式，Microsoft 365 Moodle 外掛程式會使用此應用程式。
• Microsoft 365 租使用者的應用程式會設定布建應用程式所需的回復 URL 和許可權，並傳回 AppID 和 Key。
• 在非 Windows 的作系統上，您應該只遵循手動程式在 Azure 中註冊 Open LMS 實例。 如需詳細資訊，請參閱下方 的重要 警示一節。

使用 PowerShell 在 Azure 中註冊應用程式

步驟 1：建立 Azure 應用程式

1. 流覽至 [月臺管理>外掛程式][>本機外掛程式] ，然後選 取 [Microsoft 365 整合]。 這會開啟 [Microsoft 365 整合設定] 頁面。

2. 從 [Microsoft 365 整合設定] 頁面，選取 [ 設定] 索引卷 標。

3. 選取 [ 下載 PowerShell 腳本] 按鈕，並將其儲存為您本機計算機的 ZIP 資料夾。

   注意事項

   執行文稿會在 Microsoft 365 租使用者中建立新的 Microsoft Entra 應用程式，以設定必要的回復 URL 和許可權、提供必要的許可權，並傳回 AppID 和 Key。

   腳本在非 Windows 的作系統上無法在 PowerShell 中運作。

4. 從 ZIP 檔案準備 PowerShell 腳本，如下所示：

   1. 下載並解壓縮 Moodle-AzureAD-Powershell.zip 檔案。
   2. 開啟解壓縮的資料夾。
   3. 以滑鼠右鍵按下檔案， Moodle-AzureAD-Script.ps1 然後選取 [ 屬性]。
   4. 在 屬性視窗 的 [一般] 索引標籤下，選Unblock取視窗底部 [安全性] 屬性旁邊的複選框。
   5. 選取 [確定]。
   6. 將目錄路徑複製到解壓縮的資料夾。

5. 以系統管理員身分執行 PowerShell：

   1. 在 Windows 中，開啟 [開始] 功能表。
   2. 輸入 PowerShell。
   3. 以滑鼠右鍵按兩下 [Windows PowerShell]。
   4. 選 取 [以系統管理員身分執行]。

6. 輸入 cd .../.../Moodle-AzureAD-Powershell 其中 .../... 是目錄的路徑，以流覽至解壓縮的目錄。

7. 執行 PowerShell 腳本：

   1. 輸入 ./Moodle-AzureAD-Script.ps1。
   2. 當系統詢問時，請在彈出視窗中登入您的 Microsoft 365 系統管理員帳戶。
   3. 當系統詢問時，輸入 Microsoft Entra 應用程式的名稱。 例如，開啟 LMS、Moodle 或 Moodle 外掛程式。
   4. 當系統詢問時，請輸入 Open LMS 伺服器的 URL。
   5. 當系統詢問時，請輸入從 OpenID Connect 驗證外掛程式組態頁面複製的回復 URL。 這是 Open LMS 網站的 URL，後面接著 \auth\oidc\。
   6. 系統可能會要求您在程式的彈出視窗中再次登入Microsoft 365 帳戶。 這是為了提供系統管理員同意您組織新增至應用程式的許可權。
   7. 當文稿完成執行時，請複製腳本所產生的應用程式 識別碼 (AppID) 和應用程式 密鑰 (Key) 並加以儲存。

步驟 2：在 OpenID Connect 中設定 Azure 應用程式詳細數據

1. 返回 OpenID Connect 驗證外掛程式組態頁面。
2. 將 AppID 值貼到 [應用程式 標識符 ] 方塊中， Key 並將值貼到 [ 金鑰 ] 方塊中，然後選取 [ 儲存變更]。

步驟 3：設定Microsoft外掛程式與Microsoft服務之間的連線

1. 從 [Microsoft 365 整合設定] 頁面，選取 [ 設定] 索引卷 標。
2. 在 [選擇連線方法] 中，選 取 [應用程式存取]，然後再次選取 [ 儲存變更 ]。
3. 頁面重新整理之後，您可以看到另一個新區段 管理員 同意 & 其他資訊。
   1. 選取 [提供 管理員 同意] 鏈接，輸入您的Microsoft 365 全域管理員認證，然後選取 [接受] 以授與許可權。
   2. 在 [Microsoft Entra 租使用者] 字段旁，選取 [偵測] 按鈕。
   3. 在 [商務用 OneDrive URL] 旁，選取 [偵測] 按鈕。
   4. 填入欄位之後，再次選取 [ 儲存變更] 按鈕。
4. 選取 [ 更新] 按鈕以確認安裝。 如果在此階段未報告任何錯誤，表示Microsoft外掛程式可以透過 Microsoft Graph API 與Microsoft伺服器通訊。

步驟 4：設定使用者和課程同步處理

1. 在您的 Open LMS 伺服器與 Microsoft Entra ID 之間同步處理使用者。 視您的環境而定，您可以在此階段中選取不同的選項。 若要開始使用：

   1. 從 [Microsoft 365 整合設定] 頁面，選取 [ 同步設定] 索引卷 標。

   2. 在 [同步使用者與 Microsoft Entra ID] 設定中，選取套用至您環境的複選框。 您必須選擇以下選項：
      ✔ 在 [開啟 LMS] 中為 Microsoft Entra ID 中的使用者建立帳戶。 ✔ 針對 Microsoft Entra ID 中的使用者，更新 Open LMS 中的所有帳戶。

   3. 在 [使用者建立限制] 區段中，您可以設定篩選條件，以限制同步至 Open LMS 的 Microsoft Entra 使用者。

      注意事項

      啟用使用者同步並非絕對必要;不過，這會讓 Open LMS 使用者與 Microsoft 365 帳戶連線變得更容易。

      使用者同步處理是透過執行同步使用者與 Microsoft Entra ID 排程工作來執行。

2. 在 [ 課程同步] 區段中，您可以選取 [課程同步自定義 ] 選項，為部分或所有現有的 Open LMS 課程啟用 Teams 的自動建立。

   注意事項

   課程同步處理是藉由執行 Sync Moodle 課程來Microsoft Teams 排程工作來執行。

3. 儲存變更。

4. 若要驗證同步組態，您必須第一次手動執行排程的工作。 流覽至 [月臺管理>伺服器工作>>] [排程工作]。

   1. 向下卷動並尋找 [使用 Microsoft Entra ID 同步使用者] 工作，然後選取 [立即執行]。
      1. 這會根據使用者同步處理選項，將 Microsoft Entra 使用者同步至您的 Open LMS 網站。
   2. 接下來，尋找 Sync Moodle 課程以Microsoft Teams 工作，然後選取 [ 立即執行]。
      1. 此工作會為所有開啟同步處理選項的 Open LMS 課程建立群組，如果在課程中找到 小組擁有者 ，也會建立 Teams。
      2. 此工作也會將課程中註冊的 Open LMS 使用者同步處理為 Teams 的擁有者或成員。
         1. 小組 擁有者 是符合下列所有準則的 Open LMS 使用者：
            1. 已連線至 Microsoft 365 帳戶。
            2. 已在課程中註冊。
            3. local/o365:teamowner具有課程內容中的功能。
         2. 同樣地，小組 成員 是符合下列所有準則的Open LMS使用者：
            1. 已連線至 Microsoft 365 帳戶。
            2. 已在課程中註冊。
            3. local/o365:teamember具有課程內容中的功能。
         3. 默認 教師 角色具有 功能 local/o365:teamowner ，而預設 學生 角色具有 功能 local/o365:teammember 。

安裝並設定外掛程式之後，您可以：

• 將 Teams 類別和會議新增至 Open LMS。
• 將 Moodle Assistant Bot 部署至 Azure。
• 將 Moodle 索引標籤新增至 Teams 類別。

其他 Moodle 外掛程式檔

如果您想要檢閱 Open LMS 的 Microsoft 365 整合指南和版本資訊，請參閱下列資源：

• Microsoft Moodle Docs 上的 365 整合檔。