共用方式為

設定 Moodle LMS 外掛程式

  • 發行項

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

必要條件

以下是設定已安裝的 Moodle 以與 Microsoft Teams 搭配運作的必要條件：

  • Moodle 系統管理員認證。
  • Microsoft Entra 系統管理員認證。
  • 您可以在其中建立新資源的 Azure 訂用帳戶。

1.安裝 Microsoft 365 Moodle 外掛程式

Moodle 與 Microsoft Teams 的整合是由 開放原始碼 Microsoft 365 Moodle 外掛程式集所提供。

必要的應用程式和外掛程式

下載並安裝下列專案：

  1. 目前穩定版本的 Moodle。

    重要事項

    如果您沒有現有的 Moodle 網站，請移至 Azure 上的 Moodle 存放庫，並快速部署 Moodle 實例，並根據您的需求加以自定義。

  2. 將 Moodle OpenID Connect 和 Microsoft 365 整合 外掛程式下載並儲存到您的本機電腦。

    注意事項

    Teams 整合需要安裝 OpenID Connect 和 Microsoft 365 整合外掛程式。

    此外，建議您安裝 Microsoft 365 Teams 主題 外掛程式。

安裝外掛程式

  1. 下載外掛程式、將其解壓縮，然後上傳至其對應的資料夾。
    • 將 OpenID Connect 外掛程式 (auth_oidc) 解壓縮至名為 oidc 的資料夾，然後上傳至 Moodle 檔案根目錄的 驗證 資料夾。
    • 將 Microsoft 365 整合外掛程式 (local_o365) 解壓縮至名為 o365 的資料夾，然後上傳至 Moodle 檔根目錄的 本 機資料夾。
  2. 以系統管理員身分登入您的 Moodle 網站，然後選取 [ 網站管理]。
  3. 偵測到要安裝的新外掛程式時，Moodle 應該會將您重新導向至安裝新的外掛程式頁面。 如果未發生這種情況，請在 [網站管理] 頁面的 [一般] 索引標籤中選取 [通知]，此動作應該會觸發外掛程式的安裝。
  4. 安裝新的外掛程式之後，Moodle 會顯示一個頁面，其中包含來自已安裝外掛程式的所有新元件。 您可以套用預設設定，安全地略過此頁面。 外掛程式將在下列步驟中設定。

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

    注意事項

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

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

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

注意事項

設定整合時，請在不同的瀏覽器索引標籤中開啟您的 Microsoft 365 Moodle 整合設定頁面，因為您需要在整個程式中返回這組頁面。

建立 Azure 應用程式

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

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

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

    注意事項

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

    PowerShell 腳本只適用於 Windows 作業系統。

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

在 Moodle 中設定 Azure 應用程式詳細數據

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

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

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

設定用戶和課程同步處理

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

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

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

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

    注意事項

    不需要開啟使用者同步;不過，這會讓 Moodle 使用者與 Microsoft 365 帳戶的連線變得更容易。

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

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

    注意事項

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

  3. 儲存變更。

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

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

注意事項

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

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

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

其他 Moodle 外掛程式檔

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