Configurare e configurare i plug-in Moodle LMS per Open LMS

  • Articolo

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

Prerequisiti

Per configurare e configurare un sistema Open LMS installato per l'uso con Microsoft Teams:

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 dell'integrazione di Microsoft 365 in una scheda del browser separata perché sarà necessario tornare a queste pagine durante tutto il processo.

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 che tutti gli utenti Open LMS usino il plug-in di autenticazione OpenID Connect come metodo di autenticazione; Tuttavia, se usano altri metodi di autenticazione, gli account Open LMS 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.

Requisiti

Registrare Open LMS come applicazione nel Microsoft Entra ID usando lo script di PowerShell. Lo script esegue il provisioning degli elementi seguenti:

  • Una nuova applicazione Microsoft Entra per il tenant di Microsoft 365, usata dai plug-in Di Microsoft 365 Moodle.
  • L'app per il tenant di Microsoft 365 configura gli URL di risposta e le autorizzazioni necessari per l'app di cui è stato effettuato il provisioning e restituisce AppID e Key.
  • Nei sistemi operativi che non sono Windows, è consigliabile seguire solo il processo manuale per registrare l'istanza di Open LMS in Azure. Per informazioni dettagliate, vedere la sezione Avviso importante riportata di seguito.

Importante

Per altre informazioni sulla registrazione manuale dell'istanza di Open LMS, vedere Registrare l'istanza di Open LMS come applicazione.

Dopo aver registrato l'app, verificare che vengano applicate tutte le autorizzazioni dell'app di Azure. Per altre informazioni, vedere Autorizzazioni per le app di Azure.

Registrare un'applicazione in Azure con PowerShell

Passaggio 1: 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 non funziona in PowerShell nei sistemi operativi che non sono 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 aprire il menu 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, aprire i plug-in Open LMS, Moodle o Moodle.
    4. Quando richiesto, immettere l'URL per il server Open LMS.
    5. Quando richiesto, immettere l'URL di risposta copiato dalla pagina di configurazione del plug-in di autenticazione OpenID Connect. Questo è l'URL del sito Open LMS 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.

Passaggio 2: Impostare i dettagli dell'app Azure in OpenID Connect

  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.

Passaggio 3: 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.

Passaggio 4: Configurare la sincronizzazione di utenti e corsi

  1. Sincronizzare gli utenti tra il server Open LMS 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 Open LMS per gli utenti in Microsoft Entra ID. ✔ Aggiornare tutti gli account in Open LMS per gli utenti in Microsoft Entra ID.

    3. Nella sezione Restrizione creazione utente è possibile configurare un filtro per limitare i Microsoft Entra utenti sincronizzati con Open LMS.

      Nota

      Non è assolutamente necessario per abilitare la sincronizzazione utente; tuttavia, la connessione degli utenti Open LMS con gli account Microsoft 365 sarà molto più semplice.

      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 dei corsi per abilitare la creazione automatica di Teams per alcuni o tutti i corsi Open LMS 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> 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 Microsoft Entra utenti verranno sincronizzati con il sito Open LMS 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 Open LMS con l'opzione di sincronizzazione attivata e anche Teams se è possibile trovare un proprietario del team nel corso.
      2. Questa attività sincronizza anche gli utenti Open LMS registrati nel corso con Teams come proprietari o membri.
        1. Un proprietario del team è un utente Open LMS che soddisfa tutti i criteri seguenti:
          1. è connesso a un account Microsoft 365.
          2. è iscritto al corso.
          3. ha la local/o365:teamowner funzionalità nel contesto del corso.
        2. Analogamente, un membro del team è un utente Open LMS che soddisfa tutti i criteri seguenti:
          1. è connesso a un account Microsoft 365.
          2. è iscritto al corso.
          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 e 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 alle 1:00 nel fuso orario predefinito del server Open LMS.

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

Documentazione aggiuntiva del plug-in Moodle

Per consultare le guide all'integrazione di Microsoft 365 di Open LMS e le note sulla versione, vedere queste risorse: