Informationen zum Registrieren eines LMS für einen Kursraum
Bevor du dein LMS mit einem Kursraum verknüpfen kannst, muss eine Administratorin für deine LMS-Instanz dieses so konfigurieren, dass GitHub Classroom zugelassen wird. Dann muss dein LMS bei GitHub Classroom registriert werden, um den OAuth-Handshake zu initiieren. Eine Administratorin muss diesen Registrierungsvorgang nur einmal ausführen, und jede Lehrkraft, die eine LMS-Instanz verwendet, kann ihre LMS-Kurse mit Kursräumen synchronisieren. Weitere Informationen zum Verbinden eines LMS-Kurses mit einem Kursraum findest du unter Verknüpfen eines Learning-Management-System-Kurses mit einem Kursraum.
Note
Google Classroom verwendet nicht das LTI-Protokoll und muss daher vor dem Importieren der Liste nicht mit GitHub Classroom verknüpft werden. Weitere Informationen findest du unter Verknüpfen eines Learning-Management-System-Kurses mit einem Kursraum.
Unterstützte LMS
GitHub Classroom unterstützt die Verbindung mit Lernmanagementsystemen (LMS), die LTI-Standards (Learning Tools Interoperability) implementieren.
- LTI-Version 1.3
- Vorteil von LTI
Mithilfe der LTI kannst du deine Informationen schützen. Es handelt sich dabei um ein Branchenstandardprotokoll, und die Verwendung der LTI durch GitHub Classroom ist durch das IMS Global Learning Consortium (Instructional Management System) zertifiziert. Weitere Informationen findest du in den Artikeln zur Lerntoolinteroperabilität und dem IMS Global Learning Consortium auf der Website des IMS Global Learning Consortium.
GitHub hat die Registrierung, die Verbindungsherstellung und den Import von Kurslistendaten aus den folgenden LMS in GitHub Classroom getestet und verifiziert.
- Canvas
- Moodle
- Sakai
- Google Classroom
Hinweis: Andere Lernmanagementsysteme, die LTI 1.3 implementieren, funktionieren möglicherweise auch mit GitHub Classroom, wurden aber noch nicht verifiziert. LMS-Administratoren müssen möglicherweise benutzerdefinierte Einstellungen für den Datenschutz und die Platzierung von Schaltflächen vornehmen und den Lehrkräften eine Dokumentation zur Verfügung stellen, wie sie GitHub Classroom vom LMS aus aufrufen können.
Google Classroom verwendet nicht das LTI-Protokoll und muss daher vor dem Importieren der Liste nicht mit GitHub Classroom verknüpft werden. Weitere Informationen findest du unter Verknüpfen eines Learning-Management-System-Kurses mit einem Kursraum.
Konfigurieren von Canvas für GitHub Classroom
Du kannst deine Canvas-Installation bei GitHub Classroom registrieren, damit Lehrkräfte Kurslistendaten in ihre Kursräume importieren können. Weitere Informationen zu Canvas findest du auf der Canvas-Website.
1. Registrieren von GitHub Classroom-Entwicklerschlüsseln bei Canvas
-
Melde dich bei Canvas an.
-
Klicke auf der linken Randleiste auf der Startseite auf Admin und dann auf Websiteadministrator.
-
Klicke auf Entwicklerschlüssel.
-
Klicke unter „Entwicklerschlüssel“ auf die Schaltfläche + Entwicklerschlüssel, und wähle dann im Dropdownmenü + LTI-Schlüssel aus.
-
Lege auf dem Konfigurationsbildschirm „Schlüsseleinstellungen“ die folgenden Werte für die Felder fest.
Feld für die Konfiguration der Canvas-App Wert oder Einstellung Methode Manual Entry
Titel GitHub Classroom
Hinweis: Du kannst einen beliebigen Namen verwenden, aber du musst die Lehrkräfte informieren, wenn du diese Angabe änderst.Beschreibung Sync Canvas course rosters to GitHub Classroom
(oder ähnlich)Ziellink-URI https://classroom.github.com/context-link
Initiierungs-URL für OpenID Connect https://classroom.github.com/lti1p3/openid-connect/auth
JWK-Methode Public JWK URL
Öffentliche JWK-URL https://classroom.github.com/.well-known/jwks.json
Umleitungs-URIs https://classroom.github.com/lti1p3/openid-connect/redirect
Dropdownmenü LTI Advantage-Dienste Aktiviere das Kontrollkästchen „Benutzerdaten abrufen, die dem Installationskontext des Tools zugeordnet sind“. Dropdownmenü „Zusätzliche Einstellungen“ Wähle unter „Sichtbarkeit“ die Option Public
aus.Positionierung Wähle Course Settings Sub Navigation
aus.
Hinweis: Wenn du die Positionierung änderst, musst du die Lehrkräfte darüber informieren. Unsere Dokumentation geht von dieser Positionierung der Schaltfläche aus. -
Klicke auf Speichern.
-
Notiere dir den Wert der Client-ID in der Zeile „GitHub Classroom-Entwicklerschlüssel“ (Spalte „Details“) der Tabelle auf der Seite „Entwicklerschlüssel“. Dieser muss den Lehrkräften mitgeteilt werden, damit sie das Setup abschließen können.
-
Ändere den Status des Schlüssels in der Spalte „Status“ der Tabelle auf der Seite „Entwicklerschlüssel“ in „Ein“.
2. Registrieren von Entwicklerschlüsseln bei GitHub Classroom
-
Gib die folgenden Informationen ein:
- Wähle unter „LMS-Typ“ im Dropdownmenü „Canvas“ aus.
- Aussteller-ID:
https://canvas.instructure.com
- Domäne: Die Basis-URL für deine Canvas-Instanz
- Client-ID: Die Client-ID unter „Details“ für den von dir erstellten Entwicklerschlüssel
- OIDC-Autorisierungsendpunkt: Die Basis-URL zu deiner Canvas-Instanz, der
/api/lti/authorize_redirect
angefügt wird - OAuth 2.0-URL für Tokenabruf: Die Basis-URL zu deiner Canvas-Instanz, der
/login/oauth2/token
angefügt wird - URL für Schlüsselfestlegung: Die Basis-URL zu deiner Canvas-Instanz, der
/api/lti/security/jwks
angefügt wird
-
Klicke auf Registrieren.
-
Das Banner „LMS erfolgreich registriert“ sollte oben auf dem Bildschirm angezeigt werden. Das bedeutet, dass deine LMS-Instanz registriert wurde und Lehrkräfte ihre Kursräume nun verknüpfen können.
Konfigurieren von Moodle für GitHub Classroom
Du kannst deine Moodle-Installation bei GitHub Classroom registrieren, damit Lehrkräfte Kurslistendaten in ihre Kursräume importieren können. Weitere Informationen zu Moodle findest du auf der Moodle-Website.
Du musst die Moodle-Version 3.0 oder höher verwenden.
1. Aktivieren der Veröffentlichung als LTI-Tool in Moodle
- Melde dich bei Moodle an.
- Klicke im obersten Menü auf die Registerkarte „Websiteverwaltung“.
- Klicke auf der Seite „Websiteverwaltung“ auf die Registerkarte „Plug-Ins“, scrolle dann nach unten zum Abschnitt „Authentifizierung“, und klicke auf Authentifizierung verwalten.
- Klicke neben dem Feld „LTI“ auf die Umschaltfläche, um LTI zu aktivieren.
- Klicke erneut auf die Registerkarte „Plug-Ins“, scrolle dann nach unten zu „Registrierungen“, und klicke auf Registrierungs-Plug-Ins verwalten.
- Klicke neben dem Feld „Als LTI-Tool veröffentlichen“ auf die Umschaltfläche, um die Veröffentlichung als LTI-Tool zu aktivieren.
- Kehre zur Seite „Websiteverwaltung“ zurück, indem du im obersten Menü auf die Registerkarte „Websiteverwaltung“ klickst. Scrolle dann zum Abschnitt „Sicherheit“, und klicke auf HTTP-Sicherheit.
- Aktiviere das Kontrollkästchen neben „Frameeinbettung zulassen“, um die Frameeinbettung zu aktivieren. Klicke dann auf Änderungen speichern.
2. Registrieren von GitHub Classroom als externes Tool
-
Kehre zur Moodle-Seite „Websiteverwaltung“ zurück, indem du im obersten Menü auf die Registerkarte „Websiteverwaltung“ klickst.
-
Klicke auf die Registerkarte „Plug-Ins“, und klicke dann neben dem Abschnitt „Aktivitätsmodule“ unter „Externes Tool“ auf Tools verwalten.
-
Klicke auf Tool manuell konfigurieren.
-
Gib die folgenden Werte in die Felder ein.
Feld für die Konfiguration der Moodle-App Wert oder Einstellung Name des Tools GitHub Classroom
Hinweis: Du kannst einen beliebigen Namen verwenden, aber du musst die Lehrkräfte informieren, wenn du diese Angabe änderst.Tool-URL https://classroom.github.com
LTI-Version LTI 1.3
Art des öffentlichen Schlüssels Keyset URL
Öffentliches Keyset https://classroom.github.com/.well-known/jwks.json
URL für Anmeldeinitiierung https://classroom.github.com/lti1p3/openid-connect/auth
Umleitungs-URI(s) https://classroom.github.com/lti1p3/openid-connect/redirect
Standardstartcontainer New window
-
Aktiviere das Kontrollkästchen Deep Linking (Inhaltselementnachricht) unterstützen.
-
Wähle unter dem Dropdownmenü „Dienste“ neben „Namen und Rollenbereitstellung für IMS-LTI“ die Option „Diesen Dienst zum Abrufen der Mitgliederinformationen gemäß Datenschutzeinstellungen verwenden“ aus dem Dropdownmenü aus.
-
Legen Sie unter der Dropdownliste „Datenschutz“ „Name des Startfelds mit Tool teilen“ auf „Immer“ fest, und legen Sie „E-Mail des Startfelds mit Tool teilen“ auf „Immer“ fest.
-
Klicke auf Änderungen speichern.
-
GitHub Classroom ist jetzt als externes Tool registriert. Klicke unter „Tools“ im Feld „GitHub Classroom“ auf das Menüsymbol, um den Bildschirm „Toolkonfigurationsdetails“ anzuzeigen. Dieser Bildschirm enthält wichtige Informationen, die du unten im letzten Schritt zum Registrieren deiner Instanz in GitHub Classroom eingeben musst.
3. Registrieren deiner Moodle-Instanz bei GitHub Classroom
-
Gib die folgenden Informationen ein:
- Wähle unter „LMS-Typ“ im Dropdownmenü „Moodle“ aus.
- Aussteller-ID: Die Plattform-ID aus den Toolkonfigurationsdetails des externen Tools, das du in Moodle erstellt hast
- Domäne: Die Basis-URL für deine Moodle-Instanz
- Client-ID: Die Client-ID aus den Toolkonfigurationsdetails des externen Tools, das du in Moodle erstellt hast
- URL für Authentifizierungsanforderungen: Die URL für Authentifizierungsanforderungen aus den Toolkonfigurationsdetails des externen Tools, das du in Moodle erstellt hast
- Zugriffstoken-URL: Die Zugriffstoken-URL aus den Toolkonfigurationsdetails des externen Tools, das du in Moodle erstellt hast
- Keyset-URL: Die öffentliche Keyset-URL aus den Toolkonfigurationsdetails des externen Tools, das du in Moodle erstellt hast
-
Klicke auf Registrieren.
-
Das Banner „LMS erfolgreich registriert“ sollte oben auf dem Bildschirm angezeigt werden. Das bedeutet, dass deine LMS-Instanz registriert wurde und Lehrkräfte ihre Kursräume nun verknüpfen können.
Konfigurieren von Sakai für GitHub Classroom
1. Registrieren von GitHub Classroom als externes Tool
-
Wechsle zu Sakai, und melde dich an.
-
Wechsle zu „Verwaltungsarbeitsbereich“, und wähle Externe Tools in der linken Seitenleiste aus.
-
Klicke auf LTI 1.x-Tool installieren.
-
Gib die folgenden Werte in die Felder ein.
Feld in der App-Konfiguration von Sakai Wert oder Einstellung Name des Tools GitHub Classroom – [dein Kursname]
Hinweis: Du kannst einen beliebigen Namen verwenden, aber du musst die Lehrkräfte informieren, wenn du diese Angabe änderst.Schaltflächentext (Text im Toolmenü) Dieser Text wird Lehrkräften auf der Schaltfläche zum Starten von GitHub Classroom angezeigt. Der Wert könnte beispielsweise sync
lauten.Start-URL https://classroom.github.com/context-link
Benutzernamen an externes Tool senden Aktiviere dieses Kontrollkästchen. Kursliste an externes Tool senden Aktiviere dieses Kontrollkästchen. Tool unterstützt LTI 1.3 Aktiviere dieses Kontrollkästchen. Keyset-URL für LTI 1.3-Tool https://classroom.github.com/.well-known/jwks.json
OpenID Connect-/Initialisierungsendpunkt für LTI 1.3-Tool https://classroom.github.com/lti1p3/openid-connect/auth
Umleitungsendpunkt für LTI 1.3-Tool https://classroom.github.com/lti1p3/openid-connect/redirect
-
Bei der Übermittlung zeigt Sakai dir die Informationen an, die du benötigst, um deine Sakai-Instanz bei GitHub Classroom zu registrieren.
2. Registrieren deiner Sakai-Instanz bei GitHub Classroom
-
Gib die folgenden Informationen ein:
- Wähle unter „LMS-Typ“ im Dropdownmenü „Sakai“ aus.
- LTI 1.3-Plattformaussteller: Der Inhalt des gleichnamigen Felds in Sakai
- Domäne: Die Basis-URL für deine Sakai-Instanz
- LTI 1.3-Client-ID: Der Inhalt des gleichnamigen Felds in Sakai
- OIDC-Authentifizierungs-URL der LTI 1.3-Plattform: Der Inhalt des gleichnamigen Felds in Sakai
- Abruf-URL für das OAuth2-Bearertoken der LTI 1.3-Plattform: Der Inhalt des gleichnamigen Felds in Sakai
- Bekannte/Keyset-OAuth2-URL der LTI 1.3-Plattform: Der Inhalt des gleichnamigen Felds in Sakai
-
Klicke auf Registrieren.
-
Das Banner „LMS erfolgreich registriert“ sollte oben auf dem Bildschirm angezeigt werden. Das bedeutet, dass deine LMS-Instanz registriert wurde und Lehrkräfte ihre Kursräume nun verknüpfen können.