設定和設定 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 應用程式的名稱。 例如，Open 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. 將值貼到 [應用程式識別碼] 方塊中，並將Key值貼AppID到 [索引鍵] 方塊中，然後選取 [儲存變更]。

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

1. 從 [Microsoft 365 整合] 設定頁面中，選取 [ 設定 ] 索引標籤。
2. 在 [選擇連線方法] 中，選取 [應用程式存取]，然後再次選取 [儲存變更]。
3. 頁面重新整理後，您可以看到另一個新區段管理員同意書 & 其他資訊。

   1. 選取 [ 提供管理員同意 ] 連結，輸入您的 Microsoft 365 全域系統管理員認證，然後 [ 接受 ] 以授與許可權。

      重要事項

      全域管理員是高度許可權的角色。 將其使用限制在無法使用現有角色的緊急情況。 如需詳細資訊，請參閱 關於 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 同步處理] 設定中，選取套用至您環境的核取方塊。 您必須選取下列選項：

      ✔ 在 Open 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 。

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

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

額外的 Moodle 外掛程式檔

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

• Moodle Docs 上的 Microsoft 365 整合檔。