Registrieren eines Learning Management System bei GitHub Classroom

Du kannst ein LTI-konformes Learning Management System (LMS) bei GitHub Classroom konfigurieren.

Wer kann dieses Feature verwenden?

Organization owners who are admins for a classroom can connect learning management systems to GitHub Classroom.

In diesem Artikel

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

Note

Andere LMS, 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

  1. Melde dich bei Canvas an.

  2. Klicke auf der linken Randleiste auf der Startseite auf Admin und dann auf Websiteadministrator.

  3. Klicke auf Entwicklerschlüssel.

  4. Klicke unter „Entwicklerschlüssel“ auf die Schaltfläche + Entwicklerschlüssel, und wähle dann im Dropdownmenü + LTI-Schlüssel aus.

  5. Lege auf dem Konfigurationsbildschirm „Schlüsseleinstellungen“ die folgenden Werte für die Felder fest.

    Feld für die Konfiguration der Canvas-AppWert oder Einstellung
    MethodeManual Entry
    TitelGitHub Classroom

    Hinweis: Du kannst einen beliebigen Namen verwenden, aber du musst die Lehrkräfte informieren, wenn du diese Angabe änderst.
    BeschreibungSync Canvas course rosters to GitHub Classroom (oder ähnlich)
    Ziellink-URIhttps://classroom.github.com/context-link
    Initiierungs-URL für OpenID Connecthttps://classroom.github.com/lti1p3/openid-connect/auth
    JWK-MethodePublic JWK URL
    Öffentliche JWK-URLhttps://classroom.github.com/.well-known/jwks.json
    Umleitungs-URIshttps://classroom.github.com/lti1p3/openid-connect/redirect
    Dropdownmenü LTI Advantage-DiensteAktiviere das Kontrollkästchen „Benutzerdaten abrufen, die dem Installationskontext des Tools zugeordnet sind“.
    Dropdownmenü „Zusätzliche Einstellungen“Wähle unter „Sichtbarkeit“ die Option Public aus.
    PositionierungWä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.

  6. Klicke auf Speichern.

  7. 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.

  8. Ä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

  1. Gehe zu https://classroom.github.com/register-lms.

  2. 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

  3. Klicke auf Registrieren.

  4. 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

  1. Melde dich bei Moodle an.
  2. Klicke im obersten Menü auf die Registerkarte „Websiteverwaltung“.
  3. Klicke auf der Seite „Websiteverwaltung“ auf die Registerkarte „Plug-Ins“, scrolle dann nach unten zum Abschnitt „Authentifizierung“, und klicke auf Authentifizierung verwalten.
  4. Klicke neben dem Feld „LTI“ auf die Umschaltfläche, um LTI zu aktivieren.
  5. Klicke erneut auf die Registerkarte „Plug-Ins“, scrolle dann nach unten zu „Registrierungen“, und klicke auf Registrierungs-Plug-Ins verwalten.
  6. Klicke neben dem Feld „Als LTI-Tool veröffentlichen“ auf die Umschaltfläche, um die Veröffentlichung als LTI-Tool zu aktivieren.
  7. 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.
  8. 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

  1. Kehre zur Moodle-Seite „Websiteverwaltung“ zurück, indem du im obersten Menü auf die Registerkarte „Websiteverwaltung“ klickst.

  2. Klicke auf die Registerkarte „Plug-Ins“, und klicke dann neben dem Abschnitt „Aktivitätsmodule“ unter „Externes Tool“ auf Tools verwalten.

  3. Klicke auf Tool manuell konfigurieren.

  4. Gib die folgenden Werte in die Felder ein.

    Feld für die Konfiguration der Moodle-AppWert oder Einstellung
    Name des ToolsGitHub Classroom

    Hinweis: Du kannst einen beliebigen Namen verwenden, aber du musst die Lehrkräfte informieren, wenn du diese Angabe änderst.
    Tool-URLhttps://classroom.github.com
    LTI-VersionLTI 1.3
    Art des öffentlichen SchlüsselsKeyset URL
    Öffentliches Keysethttps://classroom.github.com/.well-known/jwks.json
    URL für Anmeldeinitiierunghttps://classroom.github.com/lti1p3/openid-connect/auth
    Umleitungs-URI(s)https://classroom.github.com/lti1p3/openid-connect/redirect
    StandardstartcontainerNew window

  5. Aktiviere das Kontrollkästchen Deep Linking (Inhaltselementnachricht) unterstützen.

  6. 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.

  7. 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.

  8. Klicke auf Änderungen speichern.

  9. 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

  1. Gehe zu https://classroom.github.com/register-lms.

  2. 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

  3. Klicke auf Registrieren.

  4. 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

  1. Wechsle zu Sakai, und melde dich an.

  2. Wechsle zu „Verwaltungsarbeitsbereich“, und wähle Externe Tools in der linken Seitenleiste aus.

  3. Klicke auf LTI 1.x-Tool installieren.

  4. Gib die folgenden Werte in die Felder ein.

    Feld in der App-Konfiguration von SakaiWert oder Einstellung
    Name des ToolsGitHub 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-URLhttps://classroom.github.com/context-link
    Benutzernamen an externes Tool sendenAktiviere dieses Kontrollkästchen.
    Kursliste an externes Tool sendenAktiviere dieses Kontrollkästchen.
    Tool unterstützt LTI 1.3Aktiviere dieses Kontrollkästchen.
    Keyset-URL für LTI 1.3-Toolhttps://classroom.github.com/.well-known/jwks.json
    OpenID Connect-/Initialisierungsendpunkt für LTI 1.3-Toolhttps://classroom.github.com/lti1p3/openid-connect/auth
    Umleitungsendpunkt für LTI 1.3-Toolhttps://classroom.github.com/lti1p3/openid-connect/redirect

  5. 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

  1. Gehe zu https://classroom.github.com/register-lms.

  2. 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

  3. Klicke auf Registrieren.

  4. 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.