Einrichten und Konfigurieren der Moodle LMS-Plug-Ins für Open LMS
In diesem Artikel erfahren Sie, wie Sie die Moodle LMS-Plug-Ins installieren und konfigurieren, um Microsoft Teams in Ihre Open LMS-Umgebung zu integrieren.
Voraussetzungen
So richten Sie ein installiertes Open LMS für die Zusammenarbeit mit Microsoft Teams ein und konfigurieren sie:
- Vergewissern Sie sich, dass Moodle OpenID Connect und die Microsoft 365-Integrations-Plug-Ins aktiv sind.
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 Microsoft 365-Integrationskonfigurationsseite auf einer separaten Browserregisterkarte geöffnet, da Sie während des gesamten Prozesses zu diesen Seiten zurückkehren müssen.
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 Open LMS-Benutzer das OpenID Connect-Authentifizierungs-Plug-In als Authentifizierungsmethode verwenden. Wenn sie jedoch andere Authentifizierungsmethoden verwenden, müssen ihre Open LMS-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.
Voraussetzungen
Registrieren Sie Open LMS mithilfe des PowerShell-Skripts als Anwendung in Ihrem Microsoft Entra ID. Das Skript stellt die folgenden Elemente zur Seite:
- Eine neue Microsoft Entra Anwendung für Ihren Microsoft 365-Mandanten, die von den Microsoft 365 Moodle-Plug-Ins verwendet wird.
- Die App für Ihren Microsoft 365-Mandanten richtet die erforderlichen Antwort-URLs und Berechtigungen für die bereitgestellte App ein und gibt zurück
AppID
Key
. - Auf Betriebssystemen, die nicht Windows sind, sollten Sie nur den manuellen Prozess ausführen, um Ihre Open LMS-instance in Azure zu registrieren. Weitere Informationen finden Sie weiter unten im Abschnitt Wichtige Warnung.
Wichtig
Weitere Informationen zum manuellen Registrieren Ihrer Open LMS-instance finden Sie unter Registrieren Ihrer Open LMS-instance als Anwendung.
Nachdem Sie Ihre App registriert haben, überprüfen Sie, ob alle Azure-App-Berechtigungen angewendet wurden. Weitere Informationen finden Sie unter Azure-App-Berechtigungen.
Registrieren der Anwendung in Azure mithilfe von PowerShell
Schritt 1: 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 Skript funktioniert in PowerShell nicht auf Betriebssystemen, die nicht Windows sind.
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:
- Öffnen Sie unter Windows das Startmenü.
- 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 dazu aufgefordert werden, geben Sie den Namen der Microsoft Entra-Anwendung ein. Beispielsweise Open LMS-, Moodle- oder Moodle-Plug-Ins.
- Wenn Sie dazu aufgefordert werden, geben Sie die URL für Ihren Open LMS-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 die URL Ihrer Open LMS-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.
Schritt 2: Festlegen von Azure-App-Details in OpenID Connect
- 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.
Schritt 3: 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.
Schritt 4: Konfigurieren der Benutzer- und Kurssynchronisierung
Synchronisieren Sie Benutzer zwischen Ihrem Open LMS-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 Open LMS für Benutzer in Microsoft Entra ID. ✔ Aktualisieren Sie alle Konten in Open LMS für Benutzer in Microsoft Entra ID.Im Abschnitt Einschränkung der Benutzererstellung können Sie einen Filter einrichten, um die Microsoft Entra Benutzer einzuschränken, die mit Open LMS synchronisiert werden.
Hinweis
Es ist nicht unbedingt erforderlich, um die Benutzersynchronisierung zu aktivieren. Dies erleichtert jedoch das Verbinden von Open LMS-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 Open LMS-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 Open LMS-Website synchronisiert.
- Suchen Sie als Nächstes die Aufgabe Moodle-Kurse mit Microsoft Teams synchronisieren , und wählen Sie Jetzt ausführen aus.
- Mit dieser Aufgabe werden Gruppen für alle Open LMS-Kurse mit aktivierter Synchronisierungsoption sowie Teams erstellt, wenn ein Teambesitzer im Kurs gefunden werden kann.
- Diese Aufgabe synchronisiert auch Open LMS-Benutzer, die für den Kurs registriert sind, mit Teams als Besitzer oder Mitglieder.
- Ein Teambesitzer ist ein Open LMS-Benutzer, der alle folgenden Kriterien erfüllt:
- ist mit einem Microsoft 365-Konto verbunden.
- ist für den Kurs angemeldet.
- verfügt über die
local/o365:teamowner
Funktion im Kurskontext.
- Ebenso ist ein Teammitglied ein Open LMS-Benutzer, der alle folgenden Kriterien erfüllt:
- ist mit einem Microsoft 365-Konto verbunden.
- ist für den Kurs angemeldet.
- 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 Open LMS-Benutzer, der alle folgenden Kriterien erfüllt:
- 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 und angepasst werden.
- 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 Uhr in der Standardzeitzone des Open LMS-Servers.
Nachdem die Plug-Ins installiert und konfiguriert wurden, haben Sie folgende Möglichkeiten:
- Fügen Sie Teams-Kurse und -Besprechungen zu Open LMS hinzu.
- Bereitstellen eines Moodle-Assistenten-Bots in Azure
- Hinzufügen von Moodle-Registerkarten zu Teams-Kursen.
Zusätzliche Moodle-Plug-In-Dokumentation
Wenn Sie die Microsoft 365-Integrationsleitfäden und Versionshinweise von Open LMS lesen möchten, lesen Sie die folgenden Ressourcen: