De Moodle LMS-invoegtoepassingen instellen en configureren voor Open LMS

  • Artikel

In dit artikel leert u hoe u de Moodle LMS-invoegtoepassingen installeert en configureert om Microsoft Teams te integreren met uw Open LMS-ervaring.

Vereisten

Een geïnstalleerd Open LMS instellen en configureren voor gebruik met Microsoft Teams:

De verbinding tussen de Microsoft 365-invoegtoepassingen en Microsoft-services configureren

U moet de verbinding tussen de Microsoft 365-invoegtoepassingen en Microsoft-services configureren voordat ze kunnen samenwerken.

Opmerking

Houd tijdens het configureren van de integratie de configuratiepagina voor Microsoft 365-integratie geopend in een afzonderlijk browsertabblad, omdat u tijdens het proces naar deze pagina's moet terugkeren.

De OpenID Connect-verificatie-invoegtoepassing inschakelen

Om ervoor te zorgen dat de Moodle-invoegtoepassingen kunnen communiceren met Microsoft-services, moet de OpenID Connect-verificatie-invoegtoepassing zijn ingeschakeld en geconfigureerd.

  1. Navigeer naarVerificatie vaninvoegtoepassingen>voor sitebeheer> en selecteer vervolgens Verificatie beheren.
  2. Zoek de OpenID Connect-verificatie-invoegtoepassing en selecteer het oogpictogram om deze in te schakelen.
  3. Selecteer Instellingen voor de invoegtoepassing om de autorisatie- en tokeneindpunten te controleren.
    1. De standaardwaarden moeten zijn:
      1. Autorisatie-eindpunt: https://login.microsoftonline.com/common/oauth2/authorize.
      2. Tokeneindpunt: https://login.microsoftonline.com/common/oauth2/token.
  4. Noteer de omleidings-URI voor later gebruik.

Opmerking

Het is niet vereist voor alle Open LMS-gebruikers om de OpenID Connect-verificatie-invoegtoepassing als hun verificatiemethode te gebruiken; Als ze echter andere verificatiemethoden gebruiken, moeten hun Open LMS-accounts worden verbonden met hun bijbehorende Microsoft-accounts voordat ze bepaalde functies in de Teams-integratie kunnen gebruiken, zoals het synchroniseren van teams-eigendom en -lidmaatschap.

Vereisten

Registreer Open LMS als een toepassing in uw Microsoft Entra ID met behulp van het PowerShell-script. Het script richt de volgende items in:

  • Een nieuwe Microsoft Entra-toepassing voor uw Microsoft 365-tenant, die wordt gebruikt door de Microsoft 365 Moodle-invoegtoepassingen.
  • De app voor uw Microsoft 365-tenant stelt de vereiste antwoord-URL's en machtigingen in voor de ingerichte app en retourneert de AppID en Key.
  • Op besturingssystemen die geen Windows zijn, moet u alleen het handmatige proces volgen om uw Open LMS-exemplaar in Azure te registreren. Raadpleeg de sectie Belangrijke waarschuwing hieronder voor meer informatie.

Belangrijk

Zie Uw Open LMS-exemplaar registreren als een toepassing voor meer informatie over het handmatig registreren van uw Open LMS-exemplaar.

Nadat u uw app hebt geregistreerd, controleert u of alle Azure-app-machtigingen zijn toegepast. Zie Azure-app-machtigingen voor meer informatie.

Toepassing registreren in Azure met behulp van PowerShell

Stap 1: Azure-app maken

  1. Navigeer naarInvoegtoepassingen>voor sitebeheer>Lokale invoegtoepassingen en selecteer vervolgens Microsoft 365-integratie. Hiermee wordt de pagina Microsoft 365-integratieconfiguratie geopend.

  2. Selecteer op de pagina Microsoft 365-integratieconfiguratie het tabblad Setup .

  3. Selecteer de knop PowerShell-script downloaden en sla het op als een ZIP-map op uw lokale computer.

    Opmerking

    Als u het script uitvoert, maakt u een nieuwe Microsoft Entra-toepassing in de Microsoft 365-tenant, die de vereiste antwoord-URL's en machtigingen instelt, de vereiste machtigingen geeft en de AppID en Keyretourneert.

    Het script werkt niet in PowerShell op besturingssystemen die geen Windows zijn.

  4. Bereid het PowerShell-script als volgt voor vanuit het ZIP-bestand:

    1. Download en pak het Moodle-AzureAD-Powershell.zip bestand uit.
    2. Open de uitgepakte map.
    3. Klik met de rechtermuisknop op het Moodle-AzureAD-Script.ps1 bestand en selecteer Eigenschappen.
    4. Schakel op het tabblad Algemeen van de venster Eigenschappen het Unblock selectievakje in naast het beveiligingskenmerk onderaan het venster.
    5. Selecteer OK.
    6. Kopieer het mappad naar de uitgepakte map.

  5. Voer PowerShell uit als beheerder:

    1. Open het startmenu in Windows.
    2. Typ PowerShell.
    3. Klik met de rechtermuisknop op Windows PowerShell.
    4. Selecteer Als administrator uitvoeren.

  6. Navigeer naar de uitgepakte map door te typen cd .../.../Moodle-AzureAD-Powershell waar .../... het pad naar de map is.

  7. Voer het PowerShell-script uit:

    1. Voer in ./Moodle-AzureAD-Script.ps1.
    2. Meld u desgevraagd aan bij uw Microsoft 365-beheerdersaccount in het pop-upvenster.
    3. Voer desgevraagd de naam van de Microsoft Entra-toepassing in. Bijvoorbeeld Open LMS-, Moodle- of Moodle-invoegtoepassingen.
    4. Voer desgevraagd de URL in voor uw Open LMS-server.
    5. Voer desgevraagd de antwoord-URL in die is gekopieerd van de configuratiepagina van de OpenID Connect-verificatieinvoegtoepassing. Dit is de URL van uw Open LMS-site, gevolgd door \auth\oidc\.
    6. U wordt mogelijk gevraagd u opnieuw aan te melden bij uw Microsoft 365-account in een pop-upvenster. Dit is om beheerderstoestemming te geven voor de machtigingen die zijn toegevoegd aan de app voor uw organisatie.
    7. Wanneer de uitvoering van het script is voltooid, kopieert u de toepassings-id (AppID) en toepassingssleutel(Key) die door het script zijn gegenereerd en slaat u deze op.

Stap 2: Azure-app-details instellen in OpenID Connect

  1. Ga terug naar de configuratiepagina van de OpenID Connect-verificatieinvoegtoepassing.
  2. Plak de AppID waarde in het vak Toepassings-id en de Key waarde in het vak Sleutel en selecteer wijzigingen opslaan.

Stap 3: Verbinding tussen Microsoft-invoegtoepassingen en Microsoft-services configureren

  1. Selecteer op de pagina Microsoft 365-integratieconfiguratie het tabblad Setup .
  2. Selecteer in Verbindingsmethode kiezende optie Toepassingstoegang en selecteer vervolgens wijzigingen opnieuw opslaan .
  3. Nadat de pagina is vernieuwd, ziet u nog een nieuwe sectie Beheer toestemming & aanvullende informatie.
    1. Selecteer Geef Beheer toestemmingskoppeling op, voer de referenties van de globale beheerder van Microsoft 365 in en geef vervolgens Accepteren om de machtigingen te verlenen.
    2. Selecteer naast het veld Microsoft Entra tenant de knop Detecteren.
    3. Selecteer naast de OneDrive voor Bedrijven URL de knop Detecteren.
    4. Nadat de velden zijn ingevuld, selecteert u opnieuw de knop Wijzigingen opslaan .
  4. Selecteer de knop Bijwerken om de installatie te controleren. Als er in deze fase geen fout wordt gerapporteerd, betekent dit dat de Microsoft-invoegtoepassingen via Microsoft Graph-API's met de Microsoft-server kunnen communiceren.

Stap 4: Synchronisatie van gebruikers en cursus configureren

  1. Synchroniseer gebruikers tussen uw Open LMS-server en Microsoft Entra ID. Afhankelijk van uw omgeving kunt u tijdens deze fase verschillende opties selecteren. Je kunt als volgt aan de slag:

    1. Selecteer op de pagina Microsoft 365-integratieconfiguratie het tabblad Synchronisatie-instellingen .

    2. Schakel in de instelling Gebruikers synchroniseren met Microsoft Entra ID de selectievakjes in die van toepassing zijn op uw omgeving. U moet de volgende opties selecteren:
      ✔ Maak accounts in Open LMS voor gebruikers in Microsoft Entra ID. ✔ Werk alle accounts bij in Open LMS voor gebruikers in Microsoft Entra ID.

    3. In de sectie Beperking voor het maken van gebruikers kunt u een filter instellen om de Microsoft Entra gebruikers te beperken die worden gesynchroniseerd met Open LMS.

      Opmerking

      Het is niet absoluut vereist om gebruikerssynchronisatie in te schakelen; Het maakt het verbinden van Open LMS-gebruikers met Microsoft 365-accounts echter veel eenvoudiger.

      Gebruikerssynchronisatie wordt uitgevoerd door de taak Gebruikers synchroniseren met Microsoft Entra ID geplande taak uit te voeren.

  2. In de sectie Cursussynchronisatie kunt u de optie Aanpassing van cursussynchronisatie selecteren om het automatisch maken van Teams in te schakelen voor sommige of al uw bestaande Open LMS-cursussen.

    Opmerking

    Cursussynchronisatie wordt uitgevoerd door de geplande taak Moodle-cursussen synchroniseren met Microsoft Teams uit te voeren.

  3. Sla de wijzigingen op.

  4. Als u de synchronisatieconfiguratie wilt valideren, moet u de geplande taken voor het eerst handmatig uitvoeren. Navigeer naar SitebeheerServertaken>>>Geplande taken.

    1. Schuif omlaag en zoek de taak Gebruikers synchroniseren met Microsoft Entra ID en selecteer Nu uitvoeren.
      1. Hiermee worden Microsoft Entra gebruikers gesynchroniseerd met uw Open LMS-site op basis van de synchronisatieopties voor gebruikers.
    2. Zoek vervolgens de taak Moodle-cursussen synchroniseren met Microsoft Teams en selecteer Nu uitvoeren.
      1. Met deze taak worden groepen gemaakt voor alle Open LMS-cursussen met de synchronisatieoptie ingeschakeld, en ook Teams als een teameigenaar kan worden gevonden in de cursus.
      2. Met deze taak worden ook Open LMS-gebruikers die zijn ingeschreven in de cursus gesynchroniseerd met Teams als eigenaren of leden.
        1. Een teameigenaar is een Open LMS-gebruiker die voldoet aan alle volgende criteria:
          1. is verbonden met een Microsoft 365-account.
          2. is ingeschreven voor de cursus.
          3. heeft de local/o365:teamowner mogelijkheid in de cursuscontext.
        2. Op dezelfde manier is een teamlid een Open LMS-gebruiker die voldoet aan alle volgende criteria:
          1. is verbonden met een Microsoft 365-account.
          2. is ingeschreven voor de cursus.
          3. heeft de local/o365:teamember mogelijkheid in de cursuscontext.
        3. De standaardrol Docent heeft de local/o365:teamowner mogelijkheid en de standaardrol Student heeft de local/o365:teammember mogelijkheid.

Opmerking

De geplande taken worden geactiveerd door Moodle Cron, die moet worden geconfigureerd om regelmatig te worden uitgevoerd. Elke geplande taak kan een standaardplanning hebben en kan worden aangepast.

  • De standaardplanning van de taak Gebruikers synchroniseren met Microsoft Entra ID is elke minuut.
  • Het standaardschema van de taak Moodle-cursussen synchroniseren met Microsoft Teams is dagelijks om 01:00 uur in de standaard tijdzone van de OPEN LMS-server.

Nadat de invoegtoepassingen zijn geïnstalleerd en geconfigureerd, kunt u het volgende doen:

Documentatie voor extra Moodle-invoegtoepassing

Als u de Microsoft 365-integratiehandleidingen en opmerkingen bij de release van Open LMS wilt bekijken, raadpleegt u deze bronnen: