Moodle, das weltweit beliebteste quelloffene Lernmanagementsystem (LMS), ist jetzt nahtlos in Microsoft Teams integriert! Diese leistungsstarke Integration ermöglicht es Lehrenden und Studierenden, effizienter in Moodle-Kursen zusammenzuarbeiten, Fragen zu Noten und Aufgaben direkt in Teams zu stellen und stets über Benachrichtigungen auf dem Laufenden zu bleiben. Für IT-Administratoren, die diese Integration implementieren möchten, wurde das quelloffene Moodle-Plugin mit erweiterten Funktionen ausgestattet, um den Einrichtungsprozess zu vereinfachen.
Zu den neuen Funktionen gehören die automatische Registrierung Ihres Moodle-Servers bei Microsoft Entra ID, die Ein-Klick-Bereitstellung des Moodle Assistant Bots in Azure und die automatische Bereitstellung von Teams sowie die Synchronisierung von Team-Registrierungen für ausgewählte oder alle Moodle-Kurse. Zukünftig wird auch die automatische Installation des Moodle-Tabs und des Moodle Assistant Bots in jedes synchronisierte Team sowie die Ein-Klick-Veröffentlichung der Moodle-App in Ihrem privaten Teams App Store verfügbar sein.
Die Integration zwischen Moodle und Microsoft Teams schafft eine kohärente Lernumgebung, die die Stärken beider Plattformen bündelt. Während Moodle die robuste Struktur für Kursinhalte, Aufgaben und Bewertungen bietet, ergänzt Teams dies durch Echtzeit-Kommunikation, kollaborative Arbeitsbereiche und eine zentrale Anlaufstelle für den Austausch. Diese Synergie steigert nicht nur die Produktivität, sondern fördert auch eine engagiertere Lerngemeinschaft.
Voraussetzungen für die Installation
Bevor Sie mit der Installation und Konfiguration der Anwendung beginnen, stellen Sie sicher, dass Sie über die folgenden Zugangsdaten und Ressourcen verfügen:
- Moodle-Administrator-Zugangsdaten
- Microsoft Entra-Administrator-Zugangsdaten
- Ein Azure-Abonnement, in dem Sie neue Ressourcen erstellen können
Schritt 1: Installation des Moodle-Plugins
Die Moodle-Integration in Microsoft Teams basiert auf dem quelloffenen Moodle-Plugin-Set von Microsoft. Befolgen Sie diese Schritte, um das Plugin auf Ihrem Moodle-Server zu installieren:
- Laden Sie das Moodle-Plugin-Set herunter und speichern Sie es lokal. Sie benötigen Version 3.5 oder neuer.
- Melden Sie sich als Administrator bei Ihrem Moodle-Server an und wählen Sie im linken Navigationsbereich Website-Administration.
- Wählen Sie den Tab Plugins und dann Plugins installieren.
- Wählen Sie im Abschnitt „Plugin aus ZIP-Datei installieren“ die Schaltfläche Datei auswählen.
- Wählen Sie die Option Datei hochladen aus der linken Navigation, suchen Sie die zuvor heruntergeladene Datei und wählen Sie Diese Datei hochladen.
- Wählen Sie erneut die Option Website-Administration im linken Navigationsbereich, um zu Ihrem Admin-Dashboard zurückzukehren. Scrollen Sie nach unten zu den Lokalen Plugins und wählen Sie den Link Microsoft Office 365 Integration. Halten Sie diese Konfigurationsseite in einem separaten Browser-Tab geöffnet, da Sie sie während des gesamten weiteren Prozesses benötigen werden.
Weitere Informationen zur Installation von Moodle-Plugins finden Sie in der Moodle-Dokumentation.
Wichtiger Hinweis: Lassen Sie Ihre Microsoft 365 oder Office 365 Moodle Plugin-Konfigurationsseite in einem separaten Browser-Tab geöffnet, da Sie während dieses Prozesses immer wieder zu diesen Seiten zurückkehren werden.
Sie haben noch keine Moodle-Site? Besuchen Sie unser Moodle on Azure Repository, wo Sie schnell eine Moodle-Instanz auf Azure bereitstellen und an Ihre Bedürfnisse anpassen können.
Schritt 2: Konfigurieren der Verbindung zwischen dem Microsoft 365 oder Office 365 Plugin und Microsoft Entra ID
Als Nächstes müssen Sie Moodle als Anwendung in Ihrer Microsoft Entra ID registrieren. Ein PowerShell-Skript hilft Ihnen dabei. Das Skript stellt eine neue Microsoft Entra-Anwendung für Ihre Microsoft 365- oder Office 365-Organisation bereit, die vom Moodle-Plugin verwendet wird. Es richtet die App für Ihren Microsoft 365- oder Office 365-Mandanten ein, konfiguriert alle erforderlichen Antwort-URLs und Berechtigungen für die bereitgestellte App und gibt die AppID und den Schlüssel zurück. Diese können Sie in der Moodle-Plugin-Setup-Seite verwenden, um Ihren Moodle-Server mit Microsoft Entra ID zu konfigurieren. Ausführliche manuelle Schritte, die das PowerShell-Skript automatisiert, finden Sie in der vollständigen Dokumentation des Plugins.
Informationsfluss des Moodle-Tabs für Microsoft Teams
- Wählen Sie auf der Seite des Microsoft 365 oder Office 365 Integrations-Plugins den Tab Setup.
- Wählen Sie die Schaltfläche PowerShell-Skript herunterladen und speichern Sie es auf Ihrem lokalen Computer.
- Sie müssen das PowerShell-Skript aus der ZIP-Datei vorbereiten:
- Laden Sie die Datei
Moodle-AzureAD-Powershell.zipherunter und extrahieren Sie sie. - Öffnen Sie den extrahierten Ordner.
- Klicken Sie mit der rechten Maustaste auf die Datei
Moodle-AzureAD-Script.ps1und wählen Sie Eigenschaften. - Aktivieren Sie im Tab Allgemein des Eigenschaftenfensters das Kontrollkästchen Entsperren neben dem Sicherheitsattribut unten.
- Wählen Sie OK.
- Kopieren Sie den Verzeichnispfad des extrahierten Ordners.
- Laden Sie die Datei
- Als Nächstes führen Sie PowerShell als Administrator aus:
- Wählen Sie Start.
- Geben Sie „PowerShell“ ein.
- Klicken Sie mit der rechten Maustaste auf Windows PowerShell.
- Wählen Sie „Als Administrator ausführen“.
- Navigieren Sie zu dem entpackten Verzeichnis, indem Sie
cd ......Moodle-AzureAD-Powershelleingeben, wobei......der Pfad zum Verzeichnis ist. - Führen Sie das PowerShell-Skript aus:
- Geben Sie
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserein. - Geben Sie
.Moodle-AzureAD-Script.ps1ein. - Melden Sie sich in dem Pop-up-Fenster mit Ihrem Microsoft 365- oder Office 365-Administratorkonto an.
- Geben Sie den Namen der Microsoft Entra-Anwendung ein (z. B. Moodle/Moodle-Plugin).
- Geben Sie die URL Ihres Moodle-Servers ein.
- Kopieren Sie die vom Skript generierte Anwendungs-ID und den Anwendungsschlüssel und speichern Sie diese.
- Geben Sie
- Als Nächstes müssen Sie die ID und den Schlüssel dem Moodle-Plugin hinzufügen. Kehren Sie zur Plugin-Administrationsseite zurück (Website-Administration > Plugins > Microsoft 365 Integration).
- Fügen Sie auf dem Tab Setup die zuvor kopierte Anwendungs-ID und den Anwendungsschlüssel hinzu und wählen Sie dann Änderungen speichern.
- Nachdem die Seite aktualisiert wurde, sollte ein neuer Abschnitt Verbindungsmethode auswählen sichtbar sein. Aktivieren Sie das Kontrollkästchen Standard und wählen Sie erneut Änderungen speichern.
- Nach dem Aktualisieren der Seite wird ein weiterer neuer Abschnitt Admin-Zustimmung & zusätzliche Informationen angezeigt.
- Klicken Sie auf den Link Admin-Zustimmung erteilen, geben Sie Ihre Microsoft 365- oder Office 365 Global Administrator-Anmeldeinformationen ein und Akzeptieren Sie, um die Berechtigungen zu gewähren.
- Wählen Sie neben dem Feld Microsoft Entra-Mandant die Schaltfläche Erkennen.
- Wählen Sie neben der OneDrive for Business URL die Schaltfläche Erkennen.
- Nachdem die Felder ausgefüllt sind, wählen Sie erneut die Schaltfläche Änderungen speichern.
- Wählen Sie die Schaltfläche Aktualisieren, um die Installation zu überprüfen, und anschließend Änderungen speichern.
- Als Nächstes müssen Sie Benutzer zwischen Ihrem Moodle-Server und Microsoft Entra ID synchronisieren. Je nach Ihrer Umgebung können Sie in dieser Phase verschiedene Optionen wählen. Die hier vorgenommene Konfiguration wird bei jedem Moodle-Cron-Lauf (typischerweise einmal täglich) ausgeführt, um alles synchron zu halten. Um zu beginnen:
- Wechseln Sie zum Tab Synchronisierungseinstellungen.
- Aktivieren Sie im Abschnitt Benutzer mit Microsoft Entra ID synchronisieren die Kontrollkästchen, die für Ihre Umgebung zutreffen. Typischerweise würden Sie mindestens Folgendes auswählen:
- Konten in Moodle für Benutzer in Microsoft Entra ID erstellen
- Alle Konten in Moodle für Benutzer in Microsoft Entra ID aktualisieren
- Im Abschnitt Benutzererstellungsbeschränkung können Sie einen Filter einrichten, um die Microsoft Entra-Benutzer zu begrenzen, die mit Moodle synchronisiert werden.
- Der Abschnitt Benutzerfeldzuordnung ermöglicht es Ihnen, die Zuordnung von Microsoft Entra ID zu Moodle-Benutzerprofilfeldern anzupassen.
- Im Abschnitt Teams-Synchronisierung können Sie wählen, ob Gruppen (d. h. Teams) für einige oder alle Ihrer bestehenden Moodle-Kurse automatisch erstellt werden sollen.
- Um die Cron-Jobs zu validieren (und sie bei Bedarf für den ersten Lauf manuell auszuführen), klicken Sie im Abschnitt Benutzer mit Microsoft Entra ID synchronisieren auf den Link Seite zur Verwaltung geplanter Aufgaben. Dies führt Sie zur Seite Geplante Aufgaben.
- Scrollen Sie nach unten, suchen Sie den Job Benutzer mit Microsoft Entra ID synchronisieren und wählen Sie Jetzt ausführen.
- Wenn Sie sich entschieden haben, Gruppen basierend auf bestehenden Kursen zu erstellen, können Sie auch den Job Benutzergruppen in Office 365 erstellen ausführen.
- Kehren Sie zur Plugin-Administrationsseite zurück (Website-Administration > Plugins > Microsoft 365 Integration) und wählen Sie die Seite Teams-Einstellungen. Sie müssen einige Sicherheitseinstellungen konfigurieren, um die Teams-App-Integration zu ermöglichen.
- Um OpenID Connect zu aktivieren, klicken Sie auf den Link Authentifizierung verwalten und klicken Sie auf das Augensymbol in der Zeile OpenId Connect, falls es ausgegraut ist.
- Als Nächstes müssen Sie das Frame-Embedding aktivieren. Klicken Sie auf den Link HTTP-Sicherheit und aktivieren Sie dann das Kontrollkästchen neben Frame-Embedding zulassen.
- Der nächste Schritt ist die Aktivierung von Webservices, welche die Moodle-API-Funktionen ermöglichen. Klicken Sie auf den Link Erweiterte Funktionen und stellen Sie sicher, dass das Kontrollkästchen neben Webservices aktivieren aktiviert ist.
- Schließlich müssen Sie die externen Dienste für Microsoft 365 oder Office 365 aktivieren. Klicken Sie auf den Link Externe Dienste und dann:
- Klicken Sie in der Zeile Moodle Office 365 Webservices auf Bearbeiten.
- Aktivieren Sie das Kontrollkästchen neben Aktiviert und klicken Sie dann auf Änderungen speichern.
- Als Nächstes müssen Sie die Berechtigungen Ihrer authentifizierten Benutzer bearbeiten, um ihnen das Erstellen von Webdienst-Tokens zu ermöglichen. Klicken Sie auf den Link Rolle ‘Authentifizierter Benutzer’ bearbeiten. Scrollen Sie nach unten, suchen Sie die Funktion Ein Webdienst-Token erstellen und markieren Sie das Kontrollkästchen Zulassen.
Schritt 3: Bereitstellung des Moodle Assistant Bots in Azure
Der kostenlose Moodle Assistant Bot für Microsoft Teams hilft Lehrenden und Studierenden, Fragen zu ihren Kursen, Aufgaben, Noten und anderen Informationen in Moodle zu beantworten. Der Bot sendet auch Moodle-Benachrichtigungen direkt in Teams an Studierende und Lehrende. Dieser Bot ist ein quelloffenes Projekt, das von Microsoft gepflegt wird und auf GitHub verfügbar ist.
Hinweis: In diesem Abschnitt stellen Sie Ressourcen in Ihrem Azure-Abonnement bereit, und alle Ressourcen werden im kostenlosen Tarif konfiguriert. Je nach Nutzung Ihres Bots müssen Sie diese Ressourcen möglicherweise skalieren. Wenn Sie nur den Moodle-Tab ohne den Bot verwenden möchten, springen Sie zu Schritt 4.
Informationsfluss des Moodle-Bots
Um den Bot zu installieren, müssen Sie ihn zuerst auf der Microsoft Identity Platform registrieren. Dies ermöglicht es Ihrem Bot, sich gegenüber Ihren Microsoft-Endpunkten zu authentifizieren. Um Ihren Bot zu registrieren:
- Kehren Sie zur Plugin-Administrationsseite zurück (Website-Administration > Plugins > Microsoft 365 Integration) und wählen Sie den Tab Teams-Einstellungen.
- Klicken Sie auf den Link Microsoft Application Registration Portal und melden Sie sich mit Ihrer Microsoft ID an.
- Geben Sie einen Namen für Ihre App ein (z. B. MoodleBot) und klicken Sie auf die Schaltfläche Erstellen.
- Kopieren Sie die Anwendungs-ID und fügen Sie sie in das Feld Bot-Anwendungs-ID auf der Seite Team-Einstellungen ein.
- Klicken Sie auf die Schaltfläche Neues Kennwort generieren. Kopieren Sie das generierte Kennwort und fügen Sie es in das Feld Bot-Anwendungskennwort auf der Seite Team-Einstellungen ein.
- Scrollen Sie zum Ende des Formulars und klicken Sie auf Änderungen speichern.
Nachdem Sie Ihre Anwendungs-ID und Ihr Kennwort generiert haben, ist es an der Zeit, Ihren Bot in Azure bereitzustellen. Klicken Sie auf die Schaltfläche In Azure bereitstellen und füllen Sie das Formular mit den erforderlichen Informationen aus (die Bot-Anwendungs-ID, das Bot-Anwendungskennwort und der Moodle-Geheimnis befinden sich auf der Seite Team-Einstellungen, und die Azure-Informationen befinden sich auf der Seite Setup). Nachdem Sie das Formular ausgefüllt haben, aktivieren Sie das Kontrollkästchen, um den Geschäftsbedingungen zuzustimmen, und klicken Sie dann auf die Schaltfläche Kaufen (alle Azure-Ressourcen werden im kostenlosen Tarif bereitgestellt).
Sobald die Ressourcen in Azure bereitgestellt wurden, müssen Sie das Moodle-Plugin mit seinem Messaging-Endpunkt konfigurieren. Zuerst müssen Sie den Endpunkt von Ihrem Bot in Azure abrufen. Dazu:
- Wenn Sie noch nicht angemeldet sind, melden Sie sich beim Azure-Portal an.
- Wählen Sie im linken Bereich Ressourcengruppen.
- Wählen Sie aus der Liste die Ressourcengruppe aus, die Sie gerade beim Bereitstellen Ihres Bots verwendet (oder erstellt) haben.
- Wählen Sie die Ressource WebApp Bot aus der Liste der Ressourcen in der Gruppe aus.
- Kopieren Sie den Messaging-Endpunkt aus dem Abschnitt Übersicht.
- Öffnen Sie in Moodle die Seite Team-Einstellungen Ihres Moodle-Plugins.
- Fügen Sie im Feld Bot-Endpunkt die soeben kopierte URL ein und ändern Sie das Wort messages in webhook. Die URL sollte nun wie folgt aussehen:
https://botname.azurewebsites.net/api/webhook. - Klicken Sie auf Änderungen speichern.
- Nachdem Ihre Änderungen gespeichert wurden, kehren Sie zum Tab Team-Einstellungen zurück, klicken Sie auf die Schaltfläche Manifestdatei herunterladen und speichern Sie das Manifestpaket auf Ihrem Computer (Sie werden es im nächsten Abschnitt verwenden).
Schritt 4: Bereitstellung Ihrer Microsoft Teams-App
Nachdem Sie Ihren Bot in Azure bereitgestellt und für die Kommunikation mit Ihrem Moodle-Server konfiguriert haben, ist es an der Zeit, Ihre Microsoft Teams-App bereitzustellen. Dazu laden Sie die Manifestdatei hoch, die Sie zuvor von der Seite „Team-Einstellungen“ des Moodle-Plugins heruntergeladen haben.
Bevor Sie die App installieren können, müssen Sie sicherstellen, dass externe Apps und das Sideloading von Apps aktiviert sind. Dazu können Sie diesen Schritten folgen. Nachdem Sie sichergestellt haben, dass externe Apps aktiviert sind, können Sie die folgenden Schritte ausführen, um Ihre App bereitzustellen.
- Öffnen Sie Microsoft Teams.
- Klicken Sie auf das Symbol Store unten links in der Navigationsleiste.
- Klicken Sie auf den Link Benutzerdefinierte App hochladen aus der Liste der Optionen. Hinweis: Wenn Sie als globaler Administrator angemeldet sind, haben Sie die Möglichkeit, die App in den App Store Ihrer Organisation hochzuladen; andernfalls können Sie die App nur für Teams laden, in denen Sie Mitglied sind („Sideloading“).
- Wählen Sie das zuvor heruntergeladene
manifest.zip-Paket aus und klicken Sie auf Speichern. Falls Sie das Manifestpaket noch nicht heruntergeladen haben, können Sie dies auf dem Tab Team-Einstellungen der Plugin-Konfigurationsseite in Moodle tun.
Nachdem die App installiert ist, können Sie den Tab zu jedem Kanal hinzufügen, auf den Sie Zugriff haben. Navigieren Sie dazu zum Kanal, klicken Sie auf das +-Symbol und wählen Sie Ihre App aus der Liste aus. Folgen Sie den Anweisungen, um Ihren Moodle-Kurs-Tab zu einem Kanal hinzuzufügen.
Das war’s! Sie und Ihr Team können jetzt direkt aus Microsoft Teams mit Ihren Moodle-Kursen arbeiten.
Um Funktionsanfragen oder Feedback mit uns zu teilen, besuchen Sie unser Feedbackportal.
