Einrichten der Moodle LMS-Plug-Ins
In diesem Artikel erfahren Sie, wie Sie die Moodle LMS-Plug-Ins installieren und konfigurieren, um Microsoft Teams in Ihre Moodle-Erfahrung zu integrieren.
Voraussetzungen
Hier sind die Voraussetzungen, um ein installiertes Moodle für die Zusammenarbeit mit Microsoft Teams einzurichten:
- Moodle-Administratoranmeldeinformationen.
- Microsoft Entra Administratoranmeldeinformationen.
- Ein Azure-Abonnement, in dem Sie neue Ressourcen erstellen können.
1. Installieren sie die Microsoft 365 Moodle Plugins
Die Moodle-Integration in Microsoft Teams basiert auf den Open Source Microsoft 365 Moodle-Plug-Ins.
Erforderliche Anwendungen und Plug-Ins
Laden Sie die folgenden Elemente herunter, und installieren Sie sie:
Eine aktuelle stabile Version von Moodle.
Wichtig
Wenn Sie noch keine Moodle-Website haben, wechseln Sie zum Repository Moodle in Azure, und stellen Sie schnell eine Moodle-instance bereit, und passen Sie ihn an Ihre Anforderungen an.
Laden Sie moodle OpenID Connect und die Microsoft 365 Integration-Plug-Ins herunter, und speichern Sie sie auf Ihrem lokalen Computer.
Hinweis
Die Installation der OpenID Connect- und Microsoft 365-Integrations-Plug-Ins ist für die Teams-Integration erforderlich.
Außerdem wird empfohlen, das Microsoft 365 Teams Theme-Plug-In zu installieren.
Installieren von Plug-Ins
- Laden Sie die Plug-Ins herunter, extrahieren Sie sie, und laden Sie sie in die entsprechenden Ordner hoch.
- Extrahieren Sie das OpenID Connect-Plug-In (auth_oidc) in einen Ordner namens oidc, und laden Sie es in den Authentifizierungsordner Ihres Moodle-Dokumentstamms hoch.
- Extrahieren Sie das Microsoft 365 Integration-Plug-In (local_o365) in einen Ordner namens o365, und laden Sie es in den lokalen Ordner Ihres Moodle-Dokumentstamms hoch.
- Melden Sie sich bei Ihrer Moodle-Website als Administrator an, und wählen Sie Websiteverwaltung aus.
- Nach der Erkennung neuer Plug-Ins, die installiert werden sollen, sollte Moodle Sie zur Seite neue Plug-Ins installieren umleiten. Wenn dies nicht der Fall ist, wählen Sie auf der Seite Websiteverwaltung auf der Registerkarte Allgemein die Option Benachrichtigungen aus. Diese Aktion sollte die Installation der Plug-Ins auslösen.
- Nachdem die neuen Plug-Ins installiert wurden, zeigt Moodle Ihnen eine Seite mit allen neuen Konfigurationen der installierten Plug-Ins an. Sie können diese Seite sicher überspringen, indem Sie die Standardeinstellungen anwenden. Die Plug-Ins werden in den folgenden Schritten konfiguriert.
2. Aktivieren des OpenID Connect-Authentifizierungs-Plug-Ins
Damit die Moodle-Plug-Ins mit Microsoft-Diensten kommunizieren können, muss das OpenID Connect-Authentifizierungs-Plug-In aktiviert und konfiguriert werden.
Navigieren Sie zuWebsiteverwaltungs-Plug-Ins>>Authentifizierung, und wählen Sie dann Authentifizierung verwalten aus.
Suchen Sie das OpenID Connect-Authentifizierungs-Plug-In, und wählen Sie das Augensymbol aus, um es zu aktivieren.
Wählen Sie Einstellungen für das Plug-In aus, um die Autorisierungs- und Tokenendpunkte zu überprüfen.
- Die Standardwerte sollten wie folgt sein:
- Autorisierungsendpunkt:
https://login.microsoftonline.com/common/oauth2/authorize
. - Tokenendpunkt:
https://login.microsoftonline.com/common/oauth2/token
.
- Autorisierungsendpunkt:
- Die Standardwerte sollten wie folgt sein:
Notieren Sie sich den Umleitungs-URI zur späteren Verwendung.
Hinweis
Es ist nicht erforderlich, dass alle Moodle-Benutzer das OpenID Connect-Authentifizierungs-Plug-In als Authentifizierungsmethode verwenden. Wenn sie jedoch andere Authentifizierungsmethoden verwenden, müssen ihre Moodle-Konten mit ihren entsprechenden Microsoft-Konten verbunden sein, bevor sie bestimmte Features in der Teams-Integration verwenden können, z. B. das Synchronisieren des Teams-Besitzes und der Mitgliedschaft.
3. Konfigurieren der Verbindung zwischen den Microsoft 365-Plug-Ins und Microsoft-Diensten
Sie müssen die Verbindung zwischen den Microsoft 365-Plug-Ins und Microsoft-Diensten konfigurieren, bevor diese zusammenarbeiten können.
Hinweis
Lassen Sie beim Konfigurieren der Integration Ihre Konfigurationsseite für Microsoft 365 Moodle Integration auf einer separaten Browserregisterkarte geöffnet, da Sie während des gesamten Prozesses zu dieser Gruppe von Seiten zurückkehren müssen.
Erstellen einer Azure-App
Navigieren Sie zuWebsiteverwaltungs-Plug-Ins>>Lokale Plug-Ins, und wählen Sie dann Microsoft 365-Integration aus. Dadurch wird die Konfigurationsseite für die Microsoft 365-Integration geöffnet.
Wählen Sie auf der Konfigurationsseite der Microsoft 365-Integration die Registerkarte Setup aus.
Wählen Sie die Schaltfläche PowerShell-Skript herunterladen aus, und speichern Sie es als ZIP-Ordner auf Ihrem lokalen Computer.
Hinweis
Beim Ausführen des Skripts wird eine neue Microsoft Entra Anwendung im Microsoft 365-Mandanten erstellt, die die erforderlichen Antwort-URLs und Berechtigungen einrichtet, die erforderlichen Berechtigungen erteilt und zurückgibt
AppID
Key
.Das PowerShell-Skript funktioniert nur auf Windows-Betriebssystemen.
Bereiten Sie das PowerShell-Skript aus der ZIP-Datei wie folgt vor:
- Laden Sie die Datei herunter, und extrahieren Sie sie
Moodle-AzureAD-Powershell.zip
. - Öffnen Sie den extrahierten Ordner.
- Klicken Sie mit der rechten Maustaste auf die
Moodle-AzureAD-Script.ps1
Datei, und wählen Sie Eigenschaften aus. - Aktivieren Sie auf der Registerkarte Allgemein des Eigenschaftenfenster das
Unblock
Kontrollkästchen neben dem Attribut Sicherheit am unteren Rand des Fensters. - Wählen Sie OK aus.
- Kopieren Sie den Verzeichnispfad in den extrahierten Ordner.
- Laden Sie die Datei herunter, und extrahieren Sie sie
Führen Sie PowerShell als Administrator aus:
- Wählen Sie unter Windows Start aus.
- Geben Sie
PowerShell
ein. - Klicken Sie mit der rechten Maustaste auf Windows PowerShell.
- Wählen Sie Als Administrator ausführen aus.
Navigieren Sie zum entzippten Verzeichnis, indem Sie eingeben
cd .../.../Moodle-AzureAD-Powershell
, wo.../...
der Pfad zum Verzeichnis ist.Führen Sie das PowerShell-Skript aus:
./Moodle-AzureAD-Script.ps1
eingeben.- Melden Sie sich im Popupfenster bei Ihrem Microsoft 365-Administratorkonto an, wenn Sie dazu aufgefordert werden.
- Wenn Sie gefragt werden, geben Sie den Namen der Microsoft Entra-Anwendung ein, z. B. Moodle- oder Moodle-Plug-Ins.
- Wenn Sie dazu aufgefordert werden, geben Sie die URL für Ihren Moodle-Server ein.
- Wenn Sie dazu aufgefordert werden, geben Sie die Antwort-URL ein, die von der Konfigurationsseite des OpenID Connect-Authentifizierungs-Plug-Ins kopiert wurde. Dies ist im Wesentlichen die URL Ihrer Moodle-Website, gefolgt von
\auth\oidc\
. - Möglicherweise werden Sie aufgefordert, sich in einem Popupfenster erneut bei Ihrem Microsoft 365-Konto anzumelden. Dies ist, um die Administratoreinwilligung für die Berechtigungen bereitzustellen, die der App für Ihre organization hinzugefügt wurden.
- Wenn die Ausführung des Skripts abgeschlossen ist, kopieren Sie die anwendungs-ID (
AppID
) und den Vom Skript generierten Application Key(Key
), und speichern Sie sie.
Festlegen von Azure-App-Details in Moodle
- Kehren Sie zur Konfigurationsseite des OpenID Connect-Authentifizierungs-Plug-Ins zurück.
- Fügen Sie den
AppID
Wert in das Feld Anwendungs-ID und denKey
Wert in das Feld Schlüssel ein, und wählen Sie dann Änderungen speichern aus.
Konfigurieren der Verbindung zwischen Microsoft-Plug-Ins und Microsoft-Diensten
- Wählen Sie auf der Konfigurationsseite der Microsoft 365-Integration die Registerkarte Setup aus.
- Wählen Sie unter Verbindungsmethode auswählendie Option Anwendungszugriff und dann erneut Änderungen speichern aus.
- Nachdem die Seite aktualisiert wurde, wird ein weiterer neuer Abschnitt Admin Zustimmung & zusätzlichen Informationen angezeigt.
- Wählen Sie den Link Admin Einwilligung bereitstellen aus, geben Sie Ihre Anmeldeinformationen für den globalen Microsoft 365-Administrator ein, und dann Akzeptieren, um die Berechtigungen zu erteilen.
- Wählen Sie neben dem Feld Microsoft Entra Mandanten die Schaltfläche Erkennen aus.
- Wählen Sie neben der OneDrive for Business URL die Schaltfläche Erkennen aus.
- Nachdem die Felder aufgefüllt wurden, wählen Sie erneut die Schaltfläche Änderungen speichern aus.
- Wählen Sie die Schaltfläche Aktualisieren aus, um die Installation zu überprüfen. Wenn in dieser Phase kein Fehler gemeldet wird, bedeutet dies, dass die Microsoft-Plug-Ins mit dem Microsoft-Server über Microsoft Graph-APIs kommunizieren können.
Konfigurieren der Benutzer- und Kurssynchronisierung
Synchronisieren Sie Benutzer zwischen Ihrem Moodle-Server und Microsoft Entra ID. Abhängig von Ihrer Umgebung können Sie während dieser Phase verschiedene Optionen auswählen. Erste Schritte:
Wählen Sie auf der Konfigurationsseite für die Microsoft 365-Integration die Registerkarte Synchronisierungseinstellungen aus.
Aktivieren Sie in der Einstellung Benutzer mit Microsoft Entra ID synchronisieren die Kontrollkästchen, die für Ihre Umgebung gelten. Sie müssen die folgenden Optionen auswählen:
✔ Erstellen Sie Konten in Moodle für Benutzer in Microsoft Entra ID. ✔ Aktualisieren Sie alle Konten in Moodle für Benutzer in Microsoft Entra ID.Im Abschnitt Einschränkung der Benutzererstellung können Sie einen Filter einrichten, um die Microsoft Entra Mit Moodle synchronisierten Benutzer einzuschränken.
Hinweis
Es ist nicht erforderlich, die Benutzersynchronisierung zu aktivieren. Dies erleichtert jedoch das Verbinden von Moodle-Benutzern mit Microsoft 365-Konten.
Die Benutzersynchronisierung erfolgt durch Ausführen der Synchronisierung von Benutzern mit Microsoft Entra ID geplanten Aufgabe.
Im Abschnitt Kurssynchronisierung können Sie die Anpassungsoption "Kurssynchronisierung " auswählen, um die automatische Erstellung von Teams für einige oder alle Vorhandenen Moodle-Kurse zu aktivieren.
Hinweis
Die Kurssynchronisierung erfolgt durch Ausführen der geplanten Aufgabe Zum Synchronisieren von Moodle-Kursen mit Microsoft Teams .
Speichern Sie die Änderungen.
Um die Synchronisierungskonfiguration zu überprüfen, müssen Sie die geplanten Aufgaben zum ersten Mal manuell ausführen, navigieren Sie zu Standortverwaltung>Serveraufgaben>>Geplante Aufgaben.
- Scrollen Sie nach unten, und suchen Sie nach der Aufgabe Benutzer mit Microsoft Entra ID synchronisieren, und wählen Sie Jetzt ausführen aus.
- Dadurch werden Microsoft Entra Benutzer gemäß den Benutzersynchronisierungsoptionen mit Ihrer Moodle-Website synchronisiert.
- Suchen Sie als Nächstes die Aufgabe Moodle-Kurse mit Microsoft Teams synchronisieren , und wählen Sie Jetzt ausführen aus.
- Diese Aufgabe erstellt Gruppen für alle Moodle-Kurse mit aktivierter Synchronisierungsoption sowie Teams, wenn ein Teambesitzer im Kurs gefunden werden kann.
- Die Aufgabe synchronisiert auch Moodle-Benutzer, die für den Kurs registriert sind, mit Teams als Besitzer oder Mitglieder.
- Ein Teambesitzer ist ein Moodle-Benutzer, der
- ist mit einem Microsoft 365-Konto verbunden, UND
- für den Kurs angemeldet ist, UND
- verfügt über die
local/o365:teamowner
Funktion im Kurskontext.
- Ebenso ist ein Teammitglied ein Moodle-Benutzer, der
- ist mit einem Microsoft 365-Konto verbunden, UND
- für den Kurs angemeldet ist, UND
- verfügt über die
local/o365:teamember
Funktion im Kurskontext.
- Die Standardrolle "Lehrer " verfügt über die
local/o365:teamowner
-Funktion, und die Standardrolle "Student " verfügt über dielocal/o365:teammember
-Funktion.
- Ein Teambesitzer ist ein Moodle-Benutzer, der
- Scrollen Sie nach unten, und suchen Sie nach der Aufgabe Benutzer mit Microsoft Entra ID synchronisieren, und wählen Sie Jetzt ausführen aus.
Hinweis
Die geplanten Aufgaben werden von Moodle Cron ausgelöst, das für die häufige Ausführung konfiguriert werden muss. Jeder geplante Vorgang kann über einen Standardzeitplan verfügen, der angepasst werden kann.
- Der Standardzeitplan der Aufgabe Benutzer mit Microsoft Entra ID synchronisieren ist jede Minute.
- Der Standardzeitplan der Aufgabe Moodle-Kurse mit Microsoft Teams synchronisieren ist täglich um 1:00 Uhr in der Standardzeitzone des Moodle-Servers.
Nachdem die Plug-Ins installiert und konfiguriert wurden, haben Sie folgende Möglichkeiten:
- Bereitstellen eines Moodle-Assistenten-Bots in Azure
- Hinzufügen von Moodle-Registerkarten zu Teams-Kursen.
- Fügen Sie Teams-Kurse und -Besprechungen zum Moodle LMS hinzu.
Zusätzliche Moodle-Plug-In-Dokumentation
Wenn Sie moodle es Microsoft 365 Integrationsleitfäden und Versionshinweise lesen möchten, lesen Sie die folgenden Ressourcen: