設定 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 服務之間的連線，才能一起運作。

注意事項

設定整合時，請在個別的瀏覽器索引標籤中保持 Microsoft 365 整合設定頁面開啟，因為您在整個程式中必須返回這些頁面。

啟用 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 以供稍後使用。

注意事項

並非所有 Open LMS 使用者都需要使用 OpenID Connect 驗證外掛程式作為其驗證方法;不過，如果他們使用其他驗證方法，其 Open LMS 帳戶必須 連線 到其對應的 Microsoft 帳戶，才能在 Teams 整合中使用特定功能，例如同步 Teams 擁有權和成員資格。

先決條件

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

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

重要事項

如需手動註冊 Open LMS 實例的詳細資訊，請參閱 將您的 Open LMS 實例註冊為應用程式。

註冊應用程式之後，請確認已套用所有 Azure 應用程式許可權。 如需詳細資訊，請參閱 Azure 應用程式許可權。

使用 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 的自動建立。

   注意事項

   課程同步處理是透過執行 將 Moodle 課程同步至 Microsoft Teams 排程工作來執行。

3. 儲存變更。

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

   1. 向下卷動並尋找 [使用 Microsoft Entra ID 同步使用者] 工作，然後選取 [立即執行]。
      1. 這會根據使用者同步處理選項，將 Microsoft Entra 使用者同步至您的 Open LMS 網站。
   2. 接下來，尋找 將 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 。

注意事項

排程的工作是由 Moodle Cron 觸發，其必須設定為經常執行。 每個排程工作都可以有預設排程，而且可以自定義。

• [使用 Microsoft Entra ID 同步處理使用者] 工作的預設排程是每分鐘一次。
• 將 Moodle 課程同步處理至 Microsoft Teams 工作的預設排程是每天上午 1 點在 Open LMS 伺服器預設時區。

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

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

其他 Moodle 外掛程式檔

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

• Moodle Docs 上的 Microsoft 365 整合檔。