Share via

De Moodle LMS-invoegtoepassingen instellen

  • Artikel

In dit artikel leert u hoe u de Moodle LMS-invoegtoepassingen installeert en configureert om Microsoft Teams op te nemen in uw Moodle-ervaring.

Vereisten

Dit zijn de vereisten voor het instellen van een geïnstalleerde Moodle voor gebruik met Microsoft Teams:

  • Moodle-beheerdersreferenties.
  • Microsoft Entra beheerdersreferenties.
  • Een Azure-abonnement waarin u nieuwe resources kunt maken.

1. Installeer de Microsoft 365 Moodle-invoegtoepassingen

Moodle-integratie met Microsoft Teams wordt mogelijk gemaakt door de set open source Microsoft 365 Moodle-invoegtoepassingen.

Vereiste toepassingen en invoegtoepassingen

Download en installeer de volgende items:

  1. Een huidige stabiele versie van Moodle.

    Belangrijk

    Als u geen bestaande Moodle-site hebt, gaat u naar de Moodle on Azure-opslagplaats en implementeert u snel een Moodle-exemplaar en past u deze aan uw behoeften aan.

  2. Download de Moodle OpenID Connect - en Microsoft 365-integratie-invoegtoepassingen en sla deze op uw lokale computer op.

    Opmerking

    Het installeren van de OpenID Connect- en Microsoft 365-integratie-invoegtoepassingen is vereist voor de Teams-integratie.

    We raden u ook aan de invoegtoepassing Microsoft 365 Teams-thema te installeren.

Invoegtoepassingen installeren

  1. Download de invoegtoepassingen, pak ze uit en upload naar de bijbehorende mappen.
    • Pak de OpenID Connect-invoegtoepassing (auth_oidc) uit naar een map met de naam oidc en upload naar de verificatiemap van de hoofdmap van uw Moodle-document.
    • Pak de Microsoft 365 Integration-invoegtoepassing (local_o365) uit naar een map met de naam o365 en upload naar de lokale map van de hoofdmap van uw Moodle-document.
  2. Meld u als beheerder aan bij uw Moodle-site en selecteer Sitebeheer.
  3. Bij detectie van nieuwe invoegtoepassingen die moeten worden geïnstalleerd, moet Moodle u omleiden naar de pagina nieuwe invoegtoepassingen installeren. Als dit niet gebeurt, selecteert u op de pagina Sitebeheerde optie Meldingen op het tabblad Algemeen . Deze actie moet de installatie van de invoegtoepassingen activeren.
  4. Nadat de nieuwe invoegtoepassingen zijn geïnstalleerd, toont Moodle u een pagina met alle nieuwe configuraties van de geïnstalleerde invoegtoepassingen. U kunt deze pagina veilig overslaan door de standaardinstellingen toe te passen. De invoegtoepassingen worden in de volgende stappen geconfigureerd.

2. 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 Moodle-gebruikers om de OpenID Connect-verificatie-invoegtoepassing als hun verificatiemethode; Als ze echter andere verificatiemethoden gebruiken, moeten hun Moodle-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.

3. 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 van Microsoft 365 Moodle-integratie geopend in een afzonderlijk browsertabblad, omdat u tijdens het proces naar deze set pagina's moet terugkeren.

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 PowerShell-script werkt alleen op Windows-besturingssystemen.

  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. Selecteer start 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 in van de Microsoft Entra Toepassing, bijvoorbeeld Moodle- of Moodle-invoegtoepassingen.
    4. Voer desgevraagd de URL voor uw Moodle-server in.
    5. Voer desgevraagd de antwoord-URL in die is gekopieerd van de configuratiepagina van de OpenID Connect-verificatieinvoegtoepassing. Dit is in feite de URL van uw Moodle-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.

Details van Azure-app instellen in Moodle

  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.

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.

Synchronisatie van gebruikers en cursus configureren

  1. Synchroniseer gebruikers tussen uw Moodle-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 Moodle voor gebruikers in Microsoft Entra ID. ✔ Werk alle accounts in Moodle bij 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 die worden gesynchroniseerd met Moodle te beperken.

    Opmerking

    Het is niet vereist om gebruikerssynchronisatie in te schakelen. Het maakt het verbinden van Moodle-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 Aanpassingsoptie voor cursussynchronisatie selecteren om het automatisch maken van Teams voor sommige of al uw bestaande Moodle-cursussen in te schakelen.

    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 de eerste keer handmatig uitvoeren en naar Sitebeheerservertaken>>>Geplande taken navigeren.

    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 Moodle-site volgens de synchronisatieopties van de gebruiker.
    2. Zoek vervolgens de taak Moodle-cursussen synchroniseren met Microsoft Teams en selecteer Nu uitvoeren.
      1. Met deze taak worden groepen gemaakt voor alle Moodle-cursussen met de synchronisatieoptie ingeschakeld en ook Teams als een teameigenaar in de cursus kan worden gevonden.
      2. De taak synchroniseert ook Moodle-gebruikers die zijn ingeschreven in de cursus met Teams als eigenaren of leden.
        1. Een teameigenaar is een Moodle-gebruiker die
          1. is verbonden met een Microsoft 365-account, AND
          2. is ingeschreven voor de cursus, EN
          3. heeft de local/o365:teamowner mogelijkheid in de cursuscontext.
        2. Op dezelfde manier is een teamlid een Moodle-gebruiker die
          1. is verbonden met een Microsoft 365-account, AND
          2. is ingeschreven voor de cursus, EN
          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, die 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 1 uur in de standaardtijdzone van de Moodle-server.

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

Documentatie voor extra Moodle-invoegtoepassing

Als u moodle's Microsoft 365-integratiehandleidingen en opmerkingen bij de release wilt bekijken, raadpleegt u deze bronnen: