Condividi tramite

Configurare i plug-in Moodle LMS

  • Articolo

In questo articolo si apprenderà come installare e configurare i plug-in Moodle LMS per incorporare Microsoft Teams con l'esperienza Moodle.

Prerequisiti

Ecco i prerequisiti per configurare un moodle installato per l'uso con Microsoft Teams:

  • Credenziali di amministratore di Moodle.
  • Microsoft Entra credenziali di amministratore.
  • Sottoscrizione di Azure in cui è possibile creare nuove risorse.

1. Installare i plug-in Di Microsoft 365 Moodle

L'integrazione di Moodle con Microsoft Teams è basata sulla open source set di plug-in Di Microsoft 365 Moodle.

Applicazioni e plug-in necessari

Scaricare e installare gli elementi seguenti:

  1. Versione stabile corrente di Moodle.

    Importante

    Se non si dispone di un sito Moodle esistente, passare al repository Moodle in Azure e distribuire rapidamente un'istanza di Moodle e personalizzarla in base alle proprie esigenze.

  2. Scaricare e salvare i plug-in Moodle OpenID Connect e Microsoft 365 Integration nel computer locale.

    Nota

    L'installazione dei plug-in OpenID Connect e Microsoft 365 Integration è necessaria per l'integrazione di Teams.

    È anche consigliabile installare il plug-in Tema di Microsoft 365 Teams .

Installare i plug-in

  1. Scaricare i plug-in, estrarli e caricarli nelle cartelle corrispondenti.
    • Estrarre il plug-in OpenID Connect (auth_oidc) in una cartella denominata oidc e caricarlo nella cartella di autenticazione della radice del documento Moodle.
    • Estrarre il plug-in Di integrazione di Microsoft 365 (local_o365) in una cartella denominata o365 e caricarlo nella cartella locale della radice del documento Moodle.
  2. Accedere al sito Moodle come amministratore e selezionare Amministrazione sito.
  3. Al momento del rilevamento dei nuovi plug-in da installare, Moodle dovrebbe reindirizzare l'utente alla pagina installa nuovi plug-in. In caso contrario, nella pagina Amministrazione sito selezionare Notifiche nella scheda Generale . Questa azione deve attivare l'installazione dei plug-in.
  4. Dopo l'installazione dei nuovi plug-in, Moodle mostrerà una pagina con tutte le nuove configurazioni dei plug-in installati. È possibile ignorare questa pagina applicando le impostazioni predefinite. I plug-in verranno configurati nei passaggi seguenti.

2. Abilitare il plug-in di autenticazione OpenID Connect

Per consentire ai plug-in Moodle di comunicare con i servizi Microsoft, è necessario attivare e configurare il plug-in di autenticazione OpenID Connect.

  1. Passare a Site AdministrationPluginsAuthentication (Autenticazioneplug-in> amministrazione > sito) e quindi selezionare Manage Authentication (Gestisci autenticazione).

  2. Trovare il plug-in di autenticazione OpenID Connect e selezionare l'icona a occhio per attivarlo.

  3. Selezionare Impostazioni per il plug-in per verificare gli endpoint di autorizzazione e token .

    1. I valori predefiniti devono essere:
      1. Endpoint di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize.
      2. Endpoint del token: https://login.microsoftonline.com/common/oauth2/token.

  4. Registrare l'URI di reindirizzamento per un uso successivo.

    Nota

    Non è necessario per tutti gli utenti di Moodle nel plug-in di autenticazione OpenID Connect come metodo di autenticazione; Tuttavia, se usano altri metodi di autenticazione, gli account Moodle devono essere connessi agli account Microsoft corrispondenti prima di poter usare determinate funzionalità nell'integrazione di Teams, ad esempio la sincronizzazione della proprietà e dell'appartenenza di Teams.

3. Configurare la connessione tra i plug-in di Microsoft 365 e i servizi Microsoft

Prima di poter collaborare, è necessario configurare la connessione tra i plug-in di Microsoft 365 e i servizi Microsoft.

Nota

Durante la configurazione dell'integrazione, mantenere aperta la pagina di configurazione di Microsoft 365 Moodle Integration in una scheda del browser separata perché è necessario tornare a questo set di pagine durante tutto il processo.

Creare un'app di Azure

  1. Passare a Site Administration>Plugins Local plugins>(Plug-in locali) e quindi selezionare Microsoft 365 Integration (Integrazione di Microsoft 365). Verrà aperta la pagina di configurazione di Microsoft 365 Integration.

  2. Nella pagina configurazione di Microsoft 365 Integration selezionare la scheda Configurazione .

  3. Selezionare il pulsante Scarica script di PowerShell e salvarlo come cartella ZIP nel computer locale.

    Nota

    L'esecuzione dello script crea una nuova applicazione Microsoft Entra nel tenant di Microsoft 365, che configura gli URL e le autorizzazioni di risposta necessari, fornisce le autorizzazioni necessarie e restituisce AppID e Key.

    Lo script di PowerShell funziona solo nei sistemi operativi Windows.

  4. Preparare lo script di PowerShell dal file ZIP come indicato di seguito:

    1. Scaricare ed estrarre il Moodle-AzureAD-Powershell.zip file.
    2. Aprire la cartella estratta.
    3. Fare clic con il pulsante destro del Moodle-AzureAD-Script.ps1 mouse sul file e scegliere Proprietà.
    4. Nella scheda Generale del Finestra Proprietà selezionare la Unblock casella di controllo accanto all'attributo Security che si trova nella parte inferiore della finestra.
    5. Seleziona OK.
    6. Copiare il percorso della directory nella cartella estratta.

  5. Eseguire PowerShell come amministratore:

    1. In Windows selezionare Start.
    2. Tipo PowerShell.
    3. Fare clic con il pulsante destro del mouse su Windows PowerShell.
    4. Selezionare Esegui come amministratore.

  6. Passare alla directory decompressa digitando cd .../.../Moodle-AzureAD-Powershell dove .../... è il percorso della directory.

  7. Eseguire lo script di PowerShell:

    1. Immettere ./Moodle-AzureAD-Script.ps1.
    2. Quando richiesto, accedere all'account amministratore di Microsoft 365 nella finestra popup.
    3. Quando richiesto, immettere il nome dell'applicazione Microsoft Entra, ad esempio i plug-in Moodle o Moodle.
    4. Quando richiesto, immettere l'URL per il server Moodle.
    5. Quando richiesto, immettere l'URL di risposta copiato dalla pagina di configurazione del plug-in di autenticazione OpenID Connect. Si tratta essenzialmente dell'URL del sito Moodle, seguito da \auth\oidc\.
    6. Potrebbe essere richiesto di accedere di nuovo all'account Microsoft 365 in una finestra popup del processo. Ciò consente di fornire il consenso dell'amministratore alle autorizzazioni aggiunte all'app per l'organizzazione.
    7. Al termine dell'esecuzione dello script, copiare l'ID applicazione (AppID) e la chiave dell'applicazione(Key) generati dallo script e salvarli.

Impostare i dettagli dell'app Azure in Moodle

  1. Tornare alla pagina di configurazione del plug-in di autenticazione OpenID Connect.
  2. Incollare il AppID valore nella casella ID applicazione e il Key valore nella casella Chiave e quindi selezionare Salva modifiche.

Configurare la connessione tra plug-in Microsoft e servizi Microsoft

  1. Nella pagina configurazione di Microsoft 365 Integration selezionare la scheda Configurazione .
  2. In Scegliere il metodo di connessione selezionare Accesso all'applicazione e quindi selezionare di nuovo Salva modifiche .
  3. Dopo l'aggiornamento della pagina, è possibile visualizzare un'altra nuova sezione Amministrazione consenso & informazioni aggiuntive.
    1. Selezionare Il collegamento Fornisci Amministrazione consenso, immettere le credenziali di amministratore globale di Microsoft 365 e quindi Accettare per concedere le autorizzazioni.
    2. Accanto al campo Microsoft Entra tenant selezionare il pulsante Rileva.
    3. Accanto all'URL OneDrive for Business selezionare il pulsante Rileva.
    4. Dopo aver popolato i campi, selezionare di nuovo il pulsante Salva modifiche .
  4. Selezionare il pulsante Aggiorna per verificare l'installazione. Se in questa fase non viene segnalato alcun errore, significa che i plug-in Microsoft possono comunicare con il server Microsoft tramite le API Microsoft Graph.

Configurare la sincronizzazione di utenti e corsi

  1. Sincronizzare gli utenti tra il server Moodle e Microsoft Entra ID. A seconda dell'ambiente, è possibile selezionare diverse opzioni durante questa fase. Per iniziare:

    1. Nella pagina di configurazione di Microsoft 365 Integration selezionare la scheda Impostazioni di sincronizzazione .

    2. Nell'impostazione Sincronizza utenti con Microsoft Entra ID selezionare le caselle di controllo applicabili all'ambiente. È necessario selezionare le opzioni seguenti:
      ✔ Creare account in Moodle per gli utenti in Microsoft Entra ID. ✔ Aggiornare tutti gli account in Moodle per gli utenti in Microsoft Entra ID.

    3. Nella sezione Restrizione creazione utente è possibile configurare un filtro per limitare il Microsoft Entra utenti sincronizzati con Moodle.

    Nota

    Non è necessario attivare la sincronizzazione utente. tuttavia, renderà molto più semplice la connessione degli utenti di Moodle con gli account Microsoft 365.

    La sincronizzazione utente viene eseguita eseguendo l'attività Sincronizza utenti con Microsoft Entra ID pianificata.

  2. Nella sezione Sincronizzazione corsi è possibile selezionare l'opzione di personalizzazione della sincronizzazione del corso per attivare la creazione automatica di Teams per alcuni o tutti i corsi Moodle esistenti.

    Nota

    La sincronizzazione dei corsi viene eseguita eseguendo l'attività pianificata Sincronizza i corsi Moodle con Microsoft Teams .

  3. Salvare le modifiche.

  4. Per convalidare la configurazione della sincronizzazione, è necessario eseguire manualmente le attività pianificate per la prima volta, passare aAttività>pianificate delserver> di amministrazione> del sito.

    1. Scorrere verso il basso e trovare l'attività Sincronizza utenti con Microsoft Entra ID e selezionare Esegui ora.
      1. In questo modo gli utenti verranno sincronizzati Microsoft Entra con il sito Moodle in base alle opzioni di sincronizzazione utente.
    2. Individuare quindi l'attività Sincronizza corsi Moodle con Microsoft Teams e selezionare Esegui ora.
      1. Questa attività creerà gruppi per tutti i corsi Moodle con l'opzione di sincronizzazione attivata e anche Teams se è possibile trovare un proprietario del team nel corso.
      2. L'attività sincronizza anche gli utenti di Moodle registrati nel corso con Teams come proprietari o membri.
        1. Un proprietario del team è un utente di Moodle che
          1. è connesso a un account Microsoft 365, AND
          2. è iscritto al corso, AND
          3. ha la local/o365:teamowner funzionalità nel contesto del corso.
        2. Analogamente, un membro del team è un utente di Moodle che
          1. è connesso a un account Microsoft 365, AND
          2. è iscritto al corso, AND
          3. ha la local/o365:teamember funzionalità nel contesto del corso.
        3. Il ruolo predefinito Insegnante ha la local/o365:teamowner funzionalità e il ruolo predefinito Student ne ha la local/o365:teammember funzionalità.

Nota

Le attività pianificate vengono attivate da Moodle Cron, che deve essere configurato per l'esecuzione frequente. Ogni attività pianificata può avere una pianificazione predefinita, che può essere personalizzata.

  • La pianificazione predefinita dell'attività Sincronizza utenti con Microsoft Entra ID è ogni minuto.
  • La pianificazione predefinita dell'attività Sync Moodle courses to Microsoft Teams è giornaliera all'una del fuso orario predefinito del server Moodle.

Dopo aver installato e configurato i plug-in, è possibile:

Documentazione aggiuntiva del plug-in Moodle

Per esaminare le guide all'integrazione e le note sulla versione di Microsoft 365 di Moodle, vedere queste risorse: