Del via

Konfigurer Moodle LMS-plug-ins

I denne artikel lærer du, hvordan du installerer og konfigurerer Moodle LMS-plug-ins for at inkorporere Microsoft Teams med din Moodle-oplevelse.

Forudsætninger

Her er forudsætningerne for at konfigurere en installeret Moodle til at arbejde med Microsoft Teams:

  • Legitimationsoplysninger for Moodle-administrator.
  • Microsoft Entra administratorlegitimationsoplysninger.
  • Et Azure-abonnement, hvor du kan oprette nye ressourcer.

1. Installér Microsoft 365 Moodle-plug-ins

Moodle-integration med Microsoft Teams er baseret på åben kildekode Microsoft 365 Moodle-plug-ins-sæt.

Nødvendige programmer og plug-ins

Download og installér følgende elementer:

  1. En aktuel stabil version af Moodle.

    Vigtigt!

    Hvis du ikke har et eksisterende Moodle-websted, skal du gå til Moodle på Azure-lageret og hurtigt udrulle en Moodle-forekomst og tilpasse den til dine behov.

  2. Download og gem Moodle OpenID Connect og Microsoft 365 Integration-plug-ins på din lokale computer.

    Bemærk!

    Installation af OpenID Connect- og Microsoft 365 Integration-plug-ins er påkrævet for Teams-integrationen.

    Vi anbefaler også, at du installerer Microsoft 365 Teams Theme-plug-in'en.

Installér plug-ins

  1. Download plug-ins, udpak dem, og upload til deres tilsvarende mapper.
    • Udpak OpenID Opret forbindelse-plug-in (auth_oidc) til en mappe med navnet oidc, og upload den til godkendelsesmappen i Moodle-dokumentroden.
    • Udpak Plug-in'en Microsoft 365 Integration (local_o365) til en mappe med navnet o365, og upload den til den lokale mappe i Moodle-dokumentroden.
  2. Log på dit Moodle-websted som administrator, og vælg Webstedsadministration.
  3. Ved registrering af nye plug-ins, der skal installeres, skal Moodle omdirigere dig til siden til installation af nye plug-ins. Hvis dette ikke sker, skal du på siden Webstedsadministration vælge Meddelelser under fanen Generelt , denne handling skal udløse installationen af plug-ins.
  4. Når de nye plug-ins er installeret, viser Moodle dig en side med alle nye konfigurationer fra de installerede plug-ins. Du kan trygt springe denne side over ved at anvende standardindstillingerne. Plug-ins konfigureres i følgende trin.

2. Aktivér godkendelses-plug-in'en OpenID Connect

For at Moodle-plug-ins kan kommunikere med Microsoft-tjenester, skal OpenID Connect-godkendelses-plug-in'en være aktiveret og konfigureret.

  1. Gå tilGodkendelseaf plug-instil webstedsadministration>>, og vælg derefter Administrer godkendelse.

  2. Find OpenID Connect-godkendelses-plug-in'en, og vælg øjeikonet for at aktivere det.

  3. Vælg Indstillinger for plug-in'en for at bekræfte godkendelses- og tokenslutpunkterne .

    1. Standardværdierne skal være:
      1. Godkendelsesslutpunkt: https://login.microsoftonline.com/common/oauth2/authorize.
      2. Slutpunkt for token: https://login.microsoftonline.com/common/oauth2/token.

  4. Registrer omdirigerings-URI'en til senere brug.

    Bemærk!

    Det er ikke påkrævet for alle Moodle-brugere at OpenID Connect-godkendelses-plug-in'en som godkendelsesmetode. Men hvis de bruger andre godkendelsesmetoder, skal deres Moodle-konti være forbundet til deres tilsvarende Microsoft-konti, før de kan bruge visse funktioner i Teams-integrationen, f.eks. synkronisering af Ejerskab og medlemskab af Teams.

3. Konfigurer forbindelsen mellem Microsoft 365-plug-ins og Microsoft-tjenester

Du skal konfigurere forbindelsen mellem Microsoft 365-plug-ins og Microsoft-tjenester, før de kan arbejde sammen.

Bemærk!

Mens du konfigurerer integrationen, skal du holde konfigurationssiden for Moodle Integration i Microsoft 365 åben i en separat browserfane, da du skal vende tilbage til dette sæt sider under hele processen.

Opret Azure-app

  1. Gå tilPlug-ins til webstedsadministration>>Lokale plug-ins, og vælg derefter Microsoft 365-integration. Dette åbner konfigurationssiden for Microsoft 365 Integration.

  2. Vælg fanen Konfiguration på siden Konfiguration af Microsoft 365-integration.

  3. Vælg knappen Download PowerShell Script , og gem den som en ZIP-mappe på din lokale computer.

    Bemærk!

    Når scriptet køres, oprettes der et nyt Microsoft Entra program i Microsoft 365-lejeren, som konfigurerer de påkrævede URL-adresser og tilladelser til svar, giver de nødvendige tilladelser og returnerer AppID og Key.

    PowerShell-scriptet fungerer kun på Windows-operativsystemer.

  4. Forbered PowerShell-scriptet fra ZIP-filen på følgende måde:

    1. Download og udpak Moodle-AzureAD-Powershell.zip filen.
    2. Åbn den udpakkede mappe.
    3. Højreklik på filen, Moodle-AzureAD-Script.ps1 og vælg Egenskaber.
    4. Under fanen Generelt i vinduet Egenskaber skal du markere afkrydsningsfeltet Unblock ud for attributten Sikkerhed nederst i vinduet.
    5. Vælg OK.
    6. Kopiér mappestien til den udpakkede mappe.

  5. Kør PowerShell som administrator:

    1. I Windows skal du vælge Start.
    2. Type PowerShell.
    3. Højreklik på Windows PowerShell.
    4. Vælg Kør som administrator.

  6. Gå til den udpakkede mappe ved at skrive cd .../.../Moodle-AzureAD-Powershell , hvor .../... stien til mappen er.

  7. Udfør PowerShell-scriptet:

    1. Angiv ./Moodle-AzureAD-Script.ps1.
    2. Når du bliver spurgt, skal du logge på din Microsoft 365-administratorkonto i pop op-vinduet.
    3. Når du bliver spurgt, skal du angive navnet på Microsoft Entra-programmet, f.eks. Moodle- eller Moodle-plug-ins.
    4. Når du bliver spurgt, skal du angive URL-adressen til moodle-serveren.
    5. Når du bliver spurgt, skal du angive den SVAR-URL-adresse, der er kopieret fra konfigurationssiden for OpenID Connect-godkendelses-plug-in'en. Dette er i bund og grund URL-adressen på dit Moodle-websted efterfulgt af \auth\oidc\.
    6. Du bliver muligvis bedt om at logge på din Microsoft 365-konto igen i et pop op-vindue i processen. Dette er for at give administratorsamtykke til de tilladelser, der er føjet til appen for din organisation.
    7. Når scriptet er fuldført, skal du kopiere det program-id (AppID) og den programnøgle(), derKey genereres af scriptet, og gemme dem.

Angiv oplysninger om Azure-app i Moodle

  1. Gå tilbage til konfigurationssiden for OpenID Connect-godkendelses-plug-in'en.
  2. Indsæt værdien AppID i feltet Program-id og værdien Key i feltet Nøgle , og vælg derefter Gem ændringer.

Konfigurer forbindelse mellem Microsoft-plug-ins og Microsoft-tjenester

  1. Vælg fanen Konfiguration på siden Konfiguration af Microsoft 365-integration.
  2. I Vælg forbindelsesmetode skal du vælge Programadgang og derefter vælge Gem ændringer igen.
  3. Når siden er opdateret, kan du se et andet nyt afsnit Administration samtykke & yderligere oplysninger.
    1. Vælg Linket Angiv Administration samtykke, angiv dine legitimationsoplysninger til den globale Microsoft 365-administrator, og vælg derefter Acceptér for at tildele tilladelserne.
    2. Ud for feltet Microsoft Entra lejer skal du vælge knappen Registrer.
    3. Ud for den OneDrive for Business URL-adresse skal du vælge knappen Registrer.
    4. Når felterne er udfyldt, skal du vælge knappen Gem ændringer igen.
  4. Vælg knappen Opdater for at bekræfte installationen. Hvis der ikke rapporteres nogen fejl i denne fase, betyder det, at Microsoft-plug-ins kan kommunikere med Microsoft-serveren via Microsoft Graph-API'er.

Konfigurer bruger- og kursussynkronisering

  1. Synkroniser brugere mellem Moodle-serveren og Microsoft Entra ID. Afhængigt af dit miljø kan du vælge forskellige indstillinger i denne fase. Sådan kommer du i gang:

    1. På konfigurationssiden for Microsoft 365-integration skal du vælge fanen Synkroniseringsindstillinger .

    2. I indstillingen Synkroniser brugere med Microsoft Entra ID skal du markere de afkrydsningsfelter, der gælder for dit miljø. Du skal vælge følgende indstillinger:
      ✔ Opret konti i Moodle for brugere i Microsoft Entra ID. ✔ Opdater alle konti i Moodle for brugere i Microsoft Entra ID.

    3. I afsnittet Begrænsning af oprettelse af bruger kan du konfigurere et filter for at begrænse de Microsoft Entra brugere, der synkroniseres til Moodle.

    Bemærk!

    Det er ikke nødvendigt at aktivere brugersynkronisering. Det vil dog gøre det meget nemmere at oprette forbindelse mellem Moodle-brugere og Microsoft 365-konti.

    Brugersynkronisering udføres ved at køre Synkroniser brugere med Microsoft Entra ID planlagte opgave.

  2. I afsnittet Kursussynkronisering kan du vælge Indstillingen Til tilpasning af kursussynkronisering for at aktivere automatisk oprettelse af Teams for nogle eller alle dine eksisterende Moodle-kurser.

    Bemærk!

    Kursussynkronisering udføres ved at køre Sync Moodle-kurserne til den planlagte opgave i Microsoft Teams .

  3. Gem ændringerne.

  4. Hvis du vil validere synkroniseringskonfigurationen, skal du køre de planlagte opgaver manuelt for første gang og navigere til Webstedsadministration>Server-opgaver>>Planlagte opgaver.

    1. Rul ned, og find opgaven Synkroniser brugere med Microsoft Entra ID, og vælg Kør nu.
      1. Dette synkroniserer Microsoft Entra brugere til dit Moodle-websted i henhold til indstillingerne for brugersynkronisering.
    2. Find derefter Sync Moodle-kurserne til Microsoft Teams-opgaven , og vælg Kør nu.
      1. Denne opgave opretter grupper for alle Moodle-kurser, hvor synkroniseringsindstillingen er slået til, og også Teams, hvis der findes en teamejer i kurset.
      2. Opgaven synkroniserer også Moodle-brugere, der er tilmeldt kurset, til Teams som ejere eller medlemmer.
        1. En teamejer er en Moodle-bruger, der
          1. er forbundet til en Microsoft 365-konto, OG
          2. er tilmeldt kurset, AND
          3. local/o365:teamowner har egenskaben i kursuskonteksten.
        2. På samme måde er et teammedlem en Moodle-bruger, der
          1. er forbundet til en Microsoft 365-konto, OG
          2. er tilmeldt kurset, AND
          3. local/o365:teamember har egenskaben i kursuskonteksten.
        3. Standardrollenlocal/o365:teamowner Lærer har funktionen , og standardrollen local/o365:teammemberStuderende har egenskaben .

Bemærk!

De planlagte opgaver udløses af Moodle Cron, som skal konfigureres til at køre ofte. Hver planlagt opgave kan have en standardplan, som kan tilpasses.

  • Standardplanen for synkronisering af brugere med Microsoft Entra ID opgave er hvert minut.
  • Standardplanen for Sync Moodle-kurserne til Microsoft Teams-opgaven er dagligt kl. 01.00 i standardtidszonen for Moodle-serveren.

Når plug-ins er installeret og konfigureret, kan du:

Ekstra dokumentation til Moodle-plug-in

Hvis du vil gennemse Moodles Microsoft 365-integrationsvejledninger og produktbemærkninger, kan du se disse ressourcer: