Installation der Moodle-Integration in Microsoft Teams

Moodle, das beliebteste und Open-Source Learning Management System (LMS) der Welt, ist jetzt in Microsoft Teams integriert! Diese Integration hilft Lehrkräften und Kursteilnehmern bei der Zusammenarbeit an Moodle-Kursen, fragen zu ihren Noten und Aufgaben zu stellen und mit Benachrichtigungen auf dem Laufenden zu bleiben – direkt in Teams!

Damit IT-Administratoren diese Integration einfach festlegen können, haben wir unser Open-Source-Moodle-Plug-In mit den folgenden Funktionen aktualisiert:

• Automatische Registrierung Ihres Moodle-Servers mit Microsoft Entra ID.
• Bereitstellung Ihres Moodle Assistant-Bots für Azure mit einem Klick.
• Automatische Bereitstellung von Teams und automatische Synchronisierung von Teamregistrierungen für alle oder auswählen Moodle-Kurse.
• Automatische Installation der Moodle-Registerkarte und des Moodle-Assistenten-Bots in jedem synchronisierten Team. (Bald verfügbar)
• Veröffentlichung der Moodle-App in Ihrem privaten Teams App Store mit einem Klick. (Bald verfügbar)

Weitere Informationen zu den Funktionen, die diese Integration bietet, finden Sie unter Installieren der Moodle-Integration in Microsoft Teams.

Voraussetzungen

Um diese Anwendung installieren und konfigurieren zu können, benötigen Sie Folgendes:

1. Moodle-Administratoranmeldeinformationen
2. Microsoft Entra-Administratoranmeldeinformationen
3. Ein Azure-Abonnement, in dem Sie neue Ressourcen erstellen können

Schritt 1: Installieren des Moodle-Plug-Ins

Die Moodle-Integration in Microsoft Teams wird vom Open-Source Moodle-Plug-In-Set unterstützt. So installieren Sie das Plug-In auf Ihrem Moodle-Server:

1. Laden Sie zuerst das Moodle-Plug-In-Set herunter und speichern Sie es auf Ihrem lokalen Computer. Sie müssen Version 3.5 oder höher verwenden.
   • Wenn Sie das Plug-In local_o365 installieren, werden auch die Plug-Ins auth_oidc und boost_o365Teams installiert.
2. Melden Sie sich bei Ihrem Moodle-Server als Administrator an, und wählen Sie im linken Navigationsbereich Websiteverwaltung aus.
3. Wählen Sie die Registerkarte Plug-Ins und dann Plug-Ins installieren aus.
4. Wählen Sie im Abschnitt Plug-In aus ZIP-Datei installieren die Schaltfläche Datei auswählen aus.
5. Wählen Sie im linken Navigationsbereich die Option Datei hochladen aus, suchen Sie nach der Datei, die Sie oben heruntergeladen haben, und wählen Sie Diese Datei hochladen aus.
6. Wählen Sie im linken Navigationsbereich die Option Websiteverwaltung erneut aus, um zu Ihrem Administrator-Dashboard zurückzukehren. Scrollen Sie nach unten zu Lokale Plug-Ins , und wählen Sie den Link Microsoft Office 365-Integration aus . Lassen Sie diese Konfigurationsseite in einer separaten Browser-Registerkarte geöffnet, da Sie diese während des gesamten weiteren Verlaufs dieses Vorgangs verwenden werden.

Weitere Informationen über die Installation von Moodle-Plug-Ins finden Sie in der Moodle-Dokumentation.

Wichtiger Hinweis: Lassen Sie Ihre Konfigurationsseite für Das Microsoft 365- oder Office 365 Moodle-Plug-In auf einer separaten Browserregisterkarte geöffnet, da Sie während dieses Prozesses zu dieser Gruppe von Seiten zurückkehren.

Sie haben noch keine Moodle-Website? Vielleicht möchten Sie sich unser „Moodle on Azure“-Repository ansehen, wo Sie schnell eine Moodle-Instanz auf Azure einsetzen und an Ihre Bedürfnisse anpassen können.

Schritt 2: Konfigurieren der Verbindung zwischen dem Microsoft 365- oder Office 365-Plug-In und Microsoft Entra ID

Als Nächstes müssen Sie Moodle als Anwendung in Ihrer Microsoft Entra-ID registrieren. Wir haben ein PowerShell-Skript bereitgestellt, das Sie bei diesem Vorgang unterstützt. Das PowerShell-Skript stellt eine neue Microsoft Entra-Anwendung für Ihre Microsoft 365- oder Office 365-Organisation bereit, die vom Moodle-Plug-In verwendet wird. Das Skript stellt die Anwendung für Ihren Microsoft 365- oder Office 365-Mandanten bereit, richtet alle erforderlichen Antwort-URLs und Berechtigungen für die bereitgestellte Anwendung ein und gibt die App-ID und den Schlüssel zurück. Sie können die generierte AppID und den Schlüssel auf Ihrer Moodle-Plug-In-Setupseite verwenden, um Ihren Moodle-Server mit Microsoft Entra ID zu konfigurieren. Wenn Sie die detaillierten manuellen Schritte sehen möchten, die das PowerShell-Skript automatisiert, finden Sie diese in der vollständigen Dokumentation für das Plug-In.

Registerkarte "Moodle" für Microsoft Teams – Informationsfluss

1. Wählen Sie auf der Plug-In-Seite Microsoft 365- oder Office 365-Integration die Registerkarte Setup aus.
2. Wählen Sie die Schaltfläche PowerShell-Skript herunterladen aus, und speichern Sie es auf Ihrem lokalen Computer.
3. Sie müssen das PowerShell-Skript aus der ZIP-Datei vorbereiten. Gehen Sie hierzu folgendermaßen vor:
   • Herunterladen und Extrahieren der Datei Moodle-AzureAD-Powershell.zip.
   • Öffnen Sie den extrahierten Ordner.
   • Klicken Sie mit der rechten Maustaste auf die Datei Moodle-AzureAD-Script.ps1, und wählen Sie Eigenschaften aus.
   • Aktivieren Sie auf der Registerkarte Allgemein des Fensters "Eigenschaften" das Kontrollkästchen Unblockunten neben dem Attribut Sicherheit.
   • Wählen Sie OK aus.
   • Kopieren Sie den Verzeichnispfad des extrahierten Ordners.
4. Als nächstes führen Sie PowerShell als Administrator aus:
   • Wählen Sie Start aus.
   • Geben Sie PowerShell ein.
   • Klicken Sie mit der rechten Maustaste auf Windows PowerShell.
   • Wählen Sie "Als Administrator ausführen" aus.
5. Navigieren Sie zu dem nicht gezippten Verzeichnis, indem Sie cd ...\...\Moodle-AzureAD-Powershell eingeben, wobei ...\... der Pfad zum Verzeichnis ist.
6. Ausführen des PowerShell-Skripts nach:
   • Geben Sie Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser ein.
   • Geben Sie .\Moodle-AzureAD-Script.ps1 ein.
   • Melden Sie sich im Popup-Fenster bei Ihrem Microsoft 365- oder Office 365-Administratorkonto an.
   • Geben Sie den Namen der Microsoft Entra-Anwendung (z. B. Moodle/Moodle-Plug-In) ein.
   • Geben Sie die URL Ihres Moodle-Servers ein.
   • Kopieren Sie die vom Skript generierte Anwendungs-ID und den Anwendungsschlüssel und speichern Sie diese.
7. Als Nächstes müssen Sie die ID und den Schlüssel zum Moodle-Plug-In hinzufügen. Kehren Sie zur Plug-In-Administrationsseite zurück (Websiteverwaltungs-Plug-Ins >> Microsoft 365 Integration).
8. Fügen Sie auf der Registerkarte Setup die Anwendungs-ID und den Anwendungsschlüssel hinzu, die Sie zuvor kopiert haben, und wählen Sie dann Änderungen speichern aus.
9. Sobald die Seite aktualisiert wird, sollten Sie nun einen neuen Abschnitt Verbindungsmethode wählen sehen. Aktivieren Sie das Kontrollkästchen Mit der Bezeichnung Standard , und wählen Sie dann erneut Änderungen speichern aus.
10. Sobald die Seite aktualisiert wird, wird ein weiterer neuer Abschnitt Administratoreinwilligung & zusätzliche Informationen angezeigt.
    • Wählen Sie den Link Administratoreinwilligung bereitstellen aus, geben Sie Ihre Anmeldeinformationen für den globalen Microsoft 365- oder Office 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 ausgefüllt wurden, wählen Sie erneut die Schaltfläche Änderungen speichern aus.
11. Wählen Sie die Schaltfläche Aktualisieren aus, um die Installation zu überprüfen, und klicken Sie dann auf Änderungen speichern.
12. Als Nächstes müssen Sie Benutzer zwischen Ihrem Moodle-Server und Microsoft Entra ID synchronisieren. Je nach Umgebung können Sie in dieser Phase unterschiedliche Optionen auswählen. Die hier festgelegte Konfiguration wird mit jeder Moodle-Cron-Ausführung (in der Regel einmal am Tag) ausgeführt, um alles synchron zu halten. Erste Schritte:
    • Wechseln Sie zur Registerkarte Einstellungen synchronisieren
    • Aktivieren Sie im Abschnitt Benutzer mit Microsoft Entra ID synchronisieren die Kontrollkästchen, die für Ihre Umgebung gelten. In der Regel würden Sie mindestens Folgendes auswählen:
      • Erstellen von Konten in Moodle für Benutzer in Microsoft Entra ID
      • Aktualisieren aller 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-Benutzer einzuschränken, die mit Moodle synchronisiert werden.
    • Im Abschnitt Benutzerfeldzuordnung können Sie die Feldzuordnung von Microsoft Entra ID zu Moodle-Benutzerprofil anpassen.
    • Im Abschnitt Teams-Synchronisierung können Sie auswählen, dass Gruppen (d. h. Teams) für einige oder alle Ihrer vorhandenen Moodle-Kurse automatisch erstellt werden sollen.
13. Um die Cron-Aufträge zu überprüfen (und sie bei der ersten Ausführung manuell auszuführen), wählen Sie im Abschnitt Benutzer mit Microsoft Entra-ID synchronisieren den Link Verwaltungsseite für geplante Aufgaben aus. Dadurch gelangen Sie zur Seite Geplante Aufgaben.
    • Scrollen Sie nach unten, und suchen Sie nach dem Auftrag Benutzer mit Microsoft Entra ID synchronisieren , und wählen Sie Jetzt ausführen aus.
    • Wenn Sie sich dafür entschieden haben, Gruppen auf der Grundlage bestehender Kurse zu erstellen, können Sie auch den Auftrag Benutzergruppen in Office 365 erstellen ausführen.
14. Kehren Sie zur Seite für die Plug-In-Verwaltung zurück (Websiteverwaltungs-Plug-Ins >> Microsoft 365 Integration), und wählen Sie die Seite Teams-Einstellungen aus. Sie müssen einige Sicherheitseinstellungen konfigurieren, um die Integration der Teams-App zu ermöglichen.
    • Um OpenID Connect zu aktivieren, klicken Sie auf den Link Authentifizierung verwalten , und klicken Sie auf das Augensymbol in der OpenId Connect-Zeile , wenn sie abgeblendet ist.
    • Als nächstes müssen Sie die Frame-Einbettung aktivieren. Wählen Sie den Link HTTP-Sicherheit aus, und aktivieren Sie dann das Kontrollkästchen neben Frameeinbettung zulassen.
    • Der nächste Schritt besteht darin, Webdienste zu aktivieren, wodurch die Moodle-API-Features aktiviert werden. Klicken Sie auf den Link Erweiterte Features, und stellen Sie sicher, dass das Kontrollkästchen neben Webdienste 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 auf Bearbeiten in der Zeile Moodle Office 365-Webdienste.
      • Aktivieren Sie das Kontrollkästchen neben Aktiviert, und klicken Sie dann auf Änderungen speichern
    • Als nächstes müssen Sie die Berechtigungen für authentifizierte Benutzer bearbeiten, damit Sie Webdienst-Token erstellen können. Klicken Sie auf den Link Bearbeitungsrolle "Authentifizierter Benutzer". Scrollen Sie nach unten und suchen Sie die Funktion Webdienst-Token erstellen und aktivieren Sie das Kontrollkästchen Zulassen.

Schritt 3: Bereitstellen des Moodle Assistant-Bots für Azure

Der kostenlose Moodle Assistant Bot für Microsoft Teams hilft Lehrern und Schülern, Fragen zu ihren Kursen, Aufgaben, Noten und anderen Informationen in Moodle zu beantworten. Der Bot sendet außerdem direkt innerhalb der Teams Moodle-Benachrichtigungen an Schüler und Lehrkräfte. Bei diesem Bot handelt es sich um ein Open-Source-Projekt, das von Microsoft verwaltet wird und auf GitHub verfügbar ist.

Moodle-Bot – Informationsfluss

Um den Bot zu installieren, müssen Sie ihn zuerst auf der Microsoft Identity Platform registrieren. Auf diese Weise kann Ihr Bot sich gegen Ihre Microsoft-Endpunkte authentifizieren. So registrieren Sie den Bot:

1. Kehren Sie zur Plug-In-Administrationsseite zurück (Websiteverwaltungs-Plug-Ins >> Microsoft 365 Integration), und wählen Sie die Registerkarte Teams-Einstellungen aus.
2. Klicken Sie auf den Link Microsoft Application Registration Portal , und melden Sie sich mit Ihrer Microsoft-ID an.
3. Geben Sie einen Namen für Ihre App ein (z. B. MoodleBot), und klicken Sie auf die Schaltfläche Erstellen .
4. Kopieren Sie die Anwendungs-ID, und fügen Sie diese in das Feld Bot-Anwendungs-ID auf der Seite Teams-Einstellungen ein.
5. Klicken Sie auf die Schaltfläche Neues Kennwort generieren. Kopieren Sie das generierte Kennwort, und fügen Sie es auf der Seite Teameinstellungen in das Feld Botanwendungskennwort ein.
6. 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 Botanwendungs-ID, das Botanwendungskennwort und das Moodle-Geheimnis befinden sich auf der Seite Teameinstellungen , und die Azure-Informationen befinden sich auf der Seite Setup ). Sobald Sie das Formular ausgefüllt haben, klicken Sie auf das Kontrollkästchen, um den Bedingungen zuzustimmen, und klicken Sie dann auf die Schaltfläche Kaufen (alle Azure-Ressourcen werden auf den Free-Tarif bereitgestellt).

Sobald die Bereitstellung der Ressourcen in Azure abgeschlossen ist, müssen Sie das Moodle-Plug-In mit seinem Messagingendpunkt konfigurieren. Zuerst müssen Sie den Endpunkt aus Ihrem Bot in Azure abrufen. Gehen Sie dazu wie folgt vor:

1. Wenn Sie noch nicht angemeldet sind, melden Sie sich beim Azure-Portal an.
2. Wählen Sie im linken Bereich Ressourcengruppen aus.
3. Wählen Sie aus der Liste die Ressourcengruppe aus, die Sie während der Bereitstellung Ihres Bot gerade verwendet (oder erstellt) haben.
4. Wählen Sie die Ressource WebApp-Bot aus der Liste der Ressourcen in der Gruppe aus.
5. Kopieren Sie den Messaging-Endpunkt aus dem Abschnitt Übersicht.
6. Öffnen Sie in Moodle die Seite Teams-Einstellungen Ihres Moodle-Plug-Ins.
7. Fügen Sie in das Feld Bot-Endpunkt die URL ein, die Sie gerade kopiert haben, und ändern Sie das Wort Nachrichten in Webhook. Die URL sollte nun wie folgt aussehen https://botname.azurewebsites.net/api/webhook
8. Klicken Sie auf Änderungen speichern
9. Sobald Sie Ihre Änderungen gespeichert haben, gehen Sie zurück zur Registerkarte Teams-Einstellungen, 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: Bereitstellen Ihrer Microsoft Teams-App

Nachdem Sie Ihren Bot bei Azure bereitgestellt und so konfiguriert haben, dass er mit Ihrem Moodle-Server kommuniziert, ist es an der Zeit, Ihre Microsoft Teams-App bereitzustellen. Dazu laden Sie die Manifestdatei, die Sie im vorherigen Schritt von der Seite Moodle-Plug-In-Teameinstellungen heruntergeladen haben.

Bevor Sie die App installieren können, müssen Sie sicherstellen, dass externe Apps und das Querladen von Apps aktiviert sind. Führen Sie dazu die folgenden Schritte aus. Nachdem Sie sichergestellt haben, dass externe Apps aktiviert sind, können Sie die folgenden Schritte ausführen, um die App bereitzustellen.

1. Öffnen Sie Microsoft Teams.
2. Klicken Sie unten links auf der Navigationsleiste auf das Symbol Store .
3. Klicken Sie in der Liste der Optionen auf den Link Benutzerdefinierte App hochladen. 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, zu denen Sie gehören ("Querladen").
4. Wählen Sie das manifest.zip-Paket aus, das Sie zuvor heruntergeladen haben, und klicken Sie auf Speichern. Falls Sie das Manifest-Paket noch nicht heruntergeladen haben, können Sie dies über die Registerkarte Teams-Einstellungen der Konfigurationsseite des Plug-Ins in Moodle tun.

Nachdem Sie die App installiert haben, können Sie die Registerkarte 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 Anwendung aus der Liste aus. Folgen Sie den Eingabeaufforderungen, um das Hinzufügen Ihrer Registerkarte "Moodle-Kurs" zu einem Kanal abzuschließen.

Das ist alles. Jetzt können Sie und Ihr Team direkt von Microsoft Teams aus mit Ihren Moodle-Kursen arbeiten.

Um Funktionsanfragen oder Feedback mit uns zu teilen, besuchen Sie unser Feedbackportal.