LTI Verbindung: Unterschied zwischen den Versionen

Aus Letto-Wiki
Wechseln zu: Navigation, Suche
(Standardinstallation)
Zeile 6: Zeile 6:
 
= Installation =
 
= Installation =
 
== Standardinstallation ==
 
== Standardinstallation ==
* Der LTI-Dienst wird bei einem normalen Setup durch das Installationsscript im Verzeichnis /opt/letto/lti installiert. Hierbei wird auch die benötigte MySQL-Datenbank angelegt, welche in der Datei /opt/letto/lti/application.properties angegeben ist.
+
* Der LTI-Dienst wird bei einem normalen Setup durch das Installationsscript im Verzeichnis /opt/letto/lti installiert.  
* Nach dem ersten Start des LTI-Services muss es noch mit LeTTo verbunden werden.
+
** Hierbei wird auch die benötigte MySQL-Datenbank angelegt, welche in der Datei /opt/letto/lti/application.properties angegeben ist.
 +
** Auch die Verbindung nach aussen mit einem AJP-Connector auf Port 9099 und den zwei Endpunkten /lti und /oidc werden durch das Installationsscript im apache-proxy eingetragen.
 +
* Nach dem ersten Start des LTI-Services muss das LTI-Service noch mit LeTTo verbunden werden.
 
** Login als globaler Administrator
 
** Login als globaler Administrator
 
** LTI-Konfiguration wählen
 
** LTI-Konfiguration wählen
 
** LTI-Service initialisieren
 
** LTI-Service initialisieren
 +
** Durch "ping LTI-Service" kann die Verbindung zum LTI-Service überprüft werden.
  
 
== Docker-Installation ==
 
== Docker-Installation ==
 
Ist noch nicht fertig realisiert.
 
Ist noch nicht fertig realisiert.
 +
 +
== Moodle-Verbindung konfigurieren
 +
* In LeTTo als globaler Administrator
 +
** LTI-Konfiguration im Tab Plattformen
 +
*** Existiert noch keine Verbindung mit einem Moodle-Server oder soll eine zusätzlicher Moodle-Server verbunden werden, so kann man diesen mit '''Neue Plattform erzeugen''' anlegen. Ist der Server schon vorhanden so braucht man nur auf die Zeile klicken und die Konfiguration wird geöffnet.
 +
*** Parallel dazu sollte man am Moodle-Server ein externes Tool anlegen. Am Besten als Administrator (unter Website Administration - Plugins - externesTool - Tool Verwalten) oder wenn man kein Administrator ist bei einem Kurs als Aktivität.
 +
*** Konfigurationsparameter am LeTTo-Server:
 +
**** Primärschlüssel: bitte hier nichts verändern
 +
**** URL: Hier bitte die URL des Moodle-Servers angeben z.B.: https://letto.htlstp.ac.at/moodle
 +
**** Client-ID: Wird am Moodle-Server nach dem Anlegen des externen Tools angezeigt wenn man wieder auf die Konfiguration des Tools geht. Bitte von dort übernehmen und am LeTTo-Server eintragen.
 +
**** OIDC-Endpunkt, JWKS-Endpunkt, OAUTH2-Endpunkt ergbeben sich für Moodle aus der Moodle-Server-URL und sollte automatisch aus dieser korrekt gesetzt werden.
 +
**** Deployment-ID: Kommt vom Moodle Server und ist im Normalfall 1
 +
**** Tool-KID-ID: Ist eine ID die den LeTTo-Server beschreibt und wird aktuell noch nicht verwendet. Setze hier irgendeinen Wert ein.
 +
**** Plattform-KID: Ist eine ID die den Moodle-Server beschreibt und wird aktuell noch nicht verwendet. Setze hier irgendeinen Wert ein.
 +
**** Nach der Konfiguration des LeTTo-Servers bitte die Daten '''speichern'''.
 +
***  Konfigurationsparameter am externen Tool von Moodle:
 +
**** Name des Tools: Ist frei vergebbar aber sinnvollerweise '''LeTTo'''
 +
**** Tool-URL: Wird aus dem Formular der Plattform-Konfiguration von LeTTo übernommen.
 +
**** Tool-Beschreibung: frei wählbar
 +
**** LTI-Version: LTI 1.3
 +
**** Client-ID: Wird erst beim Speichern des externen Tools berechnet. Zum Auslesen der Client-ID muss nach dem Speichern des externen Tools nochmals das externer Tool bearbeitet werden.
 +
**** öffentlicher Schlüssel:  Wird aus dem Formular der Plattform-Konfiguration von LeTTo übernommen.
 +
**** Anmelde-URL:  Wird aus dem Formular der Plattform-Konfiguration von LeTTo übernommen.
 +
**** Umleitungs-URI(s):  Wird aus dem Formular der Plattform-Konfiguration von LeTTo übernommen.
 +
**** Angepasste Parameter: können noch frei bleiben, werden erst bei der Verwendung in einem Kurs gesetzt.
 +
**** Services: werden aktuell noch nicht verwendet
 +
**** Datenschutz - Anwendernamen an Tool übergeben: Immer
 +
**** Datenschutz - Email des Anwenders an Tool übergeben: Immer
 +
**** Datenschutz - Bewertungen aus dem Tool akzeptieren: Immer

Version vom 11. Januar 2022, 15:34 Uhr

Allgemeines zu LTI

LTI[1] kann für die Anbindung[2] von LeTTo an einen Moodle-Server[3] verwendet werden.

Die Anbindung erfolgt über ein neben LeTTo laufendes LTI-Service. Bei einer Standardinstallation wird das LTI-Service im Verzeichnis /opt/letto/lti mit Start- und Stoppscript installiert. Mit dem Script /opt/letto/status.sh wird angezeigt ob neben dem LeTTo-Server auch das LTI-Service läuft.

Installation

Standardinstallation

  • Der LTI-Dienst wird bei einem normalen Setup durch das Installationsscript im Verzeichnis /opt/letto/lti installiert.
    • Hierbei wird auch die benötigte MySQL-Datenbank angelegt, welche in der Datei /opt/letto/lti/application.properties angegeben ist.
    • Auch die Verbindung nach aussen mit einem AJP-Connector auf Port 9099 und den zwei Endpunkten /lti und /oidc werden durch das Installationsscript im apache-proxy eingetragen.
  • Nach dem ersten Start des LTI-Services muss das LTI-Service noch mit LeTTo verbunden werden.
    • Login als globaler Administrator
    • LTI-Konfiguration wählen
    • LTI-Service initialisieren
    • Durch "ping LTI-Service" kann die Verbindung zum LTI-Service überprüft werden.

Docker-Installation

Ist noch nicht fertig realisiert.

== Moodle-Verbindung konfigurieren

  • In LeTTo als globaler Administrator
    • LTI-Konfiguration im Tab Plattformen
      • Existiert noch keine Verbindung mit einem Moodle-Server oder soll eine zusätzlicher Moodle-Server verbunden werden, so kann man diesen mit Neue Plattform erzeugen anlegen. Ist der Server schon vorhanden so braucht man nur auf die Zeile klicken und die Konfiguration wird geöffnet.
      • Parallel dazu sollte man am Moodle-Server ein externes Tool anlegen. Am Besten als Administrator (unter Website Administration - Plugins - externesTool - Tool Verwalten) oder wenn man kein Administrator ist bei einem Kurs als Aktivität.
      • Konfigurationsparameter am LeTTo-Server:
        • Primärschlüssel: bitte hier nichts verändern
        • URL: Hier bitte die URL des Moodle-Servers angeben z.B.: https://letto.htlstp.ac.at/moodle
        • Client-ID: Wird am Moodle-Server nach dem Anlegen des externen Tools angezeigt wenn man wieder auf die Konfiguration des Tools geht. Bitte von dort übernehmen und am LeTTo-Server eintragen.
        • OIDC-Endpunkt, JWKS-Endpunkt, OAUTH2-Endpunkt ergbeben sich für Moodle aus der Moodle-Server-URL und sollte automatisch aus dieser korrekt gesetzt werden.
        • Deployment-ID: Kommt vom Moodle Server und ist im Normalfall 1
        • Tool-KID-ID: Ist eine ID die den LeTTo-Server beschreibt und wird aktuell noch nicht verwendet. Setze hier irgendeinen Wert ein.
        • Plattform-KID: Ist eine ID die den Moodle-Server beschreibt und wird aktuell noch nicht verwendet. Setze hier irgendeinen Wert ein.
        • Nach der Konfiguration des LeTTo-Servers bitte die Daten speichern.
      • Konfigurationsparameter am externen Tool von Moodle:
        • Name des Tools: Ist frei vergebbar aber sinnvollerweise LeTTo
        • Tool-URL: Wird aus dem Formular der Plattform-Konfiguration von LeTTo übernommen.
        • Tool-Beschreibung: frei wählbar
        • LTI-Version: LTI 1.3
        • Client-ID: Wird erst beim Speichern des externen Tools berechnet. Zum Auslesen der Client-ID muss nach dem Speichern des externen Tools nochmals das externer Tool bearbeitet werden.
        • öffentlicher Schlüssel: Wird aus dem Formular der Plattform-Konfiguration von LeTTo übernommen.
        • Anmelde-URL: Wird aus dem Formular der Plattform-Konfiguration von LeTTo übernommen.
        • Umleitungs-URI(s): Wird aus dem Formular der Plattform-Konfiguration von LeTTo übernommen.
        • Angepasste Parameter: können noch frei bleiben, werden erst bei der Verwendung in einem Kurs gesetzt.
        • Services: werden aktuell noch nicht verwendet
        • Datenschutz - Anwendernamen an Tool übergeben: Immer
        • Datenschutz - Email des Anwenders an Tool übergeben: Immer
        • Datenschutz - Bewertungen aus dem Tool akzeptieren: Immer