Andere LMS anbinden

Ask Alma ist mit allen Lernplattformen kompatibel, die LTI 1.3 unterstützen. Für Moodle, ILIAS und Canvas gibt es eigene Anleitungen mit den genauen Menüpfaden. Diese Seite beschreibt die Anbindung allgemein, für alle anderen Plattformen, zum Beispiel OpenOlat oder Stud.IP: welche Werte Sie in der Plattform eintragen und welche Werte Sie anschließend an Ask Alma übermitteln.

Die Felder heißen von Plattform zu Plattform anders. Die Tabellen nennen deshalb jeweils gängige Bezeichnungen. Was Launch und Deep Linking bedeuten, steht im Überblick zur LTI-Anbindung.

Voraussetzungen

• Ihre Plattform unterstützt LTI 1.3 einschließlich Deep Linking (oft als LTI Advantage bezeichnet). LTI 1.1 und LTI 2.0 reichen nicht aus.
• Sie haben Administrationsrechte und können externe Tools plattformweit registrieren.
• Der Server der Plattform kann https://api.ask-alma.de per HTTPS erreichen, siehe Hinweise.

1. Ask Alma als externes Tool registrieren

Legen Sie in der Administration Ihrer Plattform ein neues externes Tool an (je nach Plattform LTI-Tool, LTI-Provider, LTI-Registrierung oder Externes Werkzeug) und wählen Sie LTI 1.3. Tragen Sie folgende Werte ein:

Angabe (gängige Bezeichnungen)	Wert
Name, Titel	Ask Alma
Tool-URL, Launch-URL, Target Link URI	https://api.ask-alma.de/launch/
Initiate Login URL, OIDC Login URL, Login-Initiierungs-URL	https://api.ask-alma.de/oidc/
Weiterleitungs-URI(s), Redirect URI(s)	https://api.ask-alma.de/launch/
Öffentlicher Schlüssel: Art	Keyset-URL (auch JWKS URL, Public JWK URL), nicht ein einzelner Schlüssel
Keyset-URL, JWKS URL	https://api.ask-alma.de/jwks
Deep Linking, Content-Item Message	aktivieren
Deep-Linking-URL, Inhaltsauswahl-URL, Content Selection URL	https://api.ask-alma.de/launch/, sofern es ein eigenes Feld gibt. Sonst gilt die Tool-URL.
Icon, Symbol-URL	optional, Link aus dem Logo-Konfigurator

Speichern.

Nutzerdaten und LTI-Dienste

Ask Alma braucht keine personenbezogenen Daten aus der Plattform, also weder Namen noch E-Mail-Adressen. Bietet die Plattform eine Datenschutzeinstellung für das Tool, wählen Sie die restriktivste Stufe (anonyme oder pseudonyme Nutzerkennung). Übermittelt werden müssen:

• eine gleichbleibende, pseudonyme Nutzerkennung (sub),
• die Rollen der Person im Kurs (Lehrende oder Lernende),
• der Kurskontext mit Kennung und Titel des Kurses.

Weitere LTI-Dienste wie den Namen- und Rollenabruf (Names and Role Provisioning) oder die Notenübermittlung (Assignment and Grade Services) nutzt Ask Alma nicht. Sie können sie ausgeschaltet lassen.

Platzierungen

Manche Plattformen legen zusätzlich fest, an welchen Stellen ein Tool erscheint (Platzierungen, Placements) und welche Nachricht dabei gesendet wird. Lehrende müssen Ask Alma beim Anlegen eines Kursinhalts auswählen können, und an dieser Stelle muss die Nachricht LtiDeepLinkingRequest verwendet werden. Nur dann öffnet sich die Auswahlseite, auf der Lehrende einen Kursinhalt (Assistent, Quiz, Lernkarten oder Lernsession) wählen.

2. Die Werte abholen, die die Plattform vergibt

Nach dem Speichern vergibt die Plattform Kennungen für das Tool und stellt ihre eigenen LTI-Endpunkte bereit. Ask Alma braucht sechs Werte:

Angabe (gängige Bezeichnungen)	Beispiel
Platform ID, Issuer, Aussteller	https://lms.example
Client ID	von der Plattform vergeben
Deployment ID, Bereitstellungs-ID	von der Plattform vergeben
Public keyset URL, JWKS URL der Plattform	https://lms.example/…/jwks
Access token URL, OAuth2 Token URL	https://lms.example/…/token
Authentication request URL, OIDC Auth URL, Authorization Endpoint	https://lms.example/…/auth

https://lms.example steht hier für die Adresse Ihrer Installation. Viele Plattformen zeigen alle sechs Werte in den Details des gespeicherten Tools an. Die drei URLs sind für die gesamte Installation gleich und stehen sonst in der LTI-Dokumentation des Herstellers. Übernehmen Sie die Werte aus der Plattform, statt sie selbst zusammenzusetzen.

3. Werte an Ask Alma übermitteln

Schicken Sie die sechs Werte aus Schritt 2 an Ihre Ansprechperson bei Ask Alma und geben Sie an, um welche Plattform (Produkt und Version) es sich handelt. Ask Alma trägt die Werte ein und aktiviert damit das Tool.

4. Ausprobieren

Warten Sie die Rückmeldung von Ask Alma ab, dass das Tool aktiviert ist, bevor Sie testen.

1. Öffnen Sie einen Testkurs und legen Sie einen neuen Inhalt mit einem externen Tool an. Wählen Sie dort Ask Alma.
2. Die Plattform öffnet die Auswahlseite von Ask Alma (Deep Linking). Wählen Sie einen Kursinhalt (Assistent, Quiz, Lernkarten oder Lernsession) aus und bestätigen Sie.
3. Die Plattform legt den Inhalt im Kurs an.

Ein Klick auf den Inhalt öffnet Ask Alma mit dem gewählten Kursinhalt. Damit ist die Anbindung inklusive Deep Linking eingerichtet.

Häufige Probleme

Symptom	Ursache
Die Auswahlseite von Ask Alma erscheint nicht, stattdessen öffnet sich Ask Alma direkt	Deep Linking ist für das Tool nicht aktiviert, oder die Platzierung sendet LtiResourceLinkRequest statt LtiDeepLinkingRequest.
Das Bestätigen der Auswahl endet mit einer Fehlerseite der Plattform	Der Server der Plattform kann https://api.ask-alma.de/jwks nicht erreichen, siehe Hinweise.
Ask Alma meldet beim Öffnen einen Fehler zur Registrierung oder Plattform	Platform ID, Client ID oder Deployment ID stimmen nicht mit den Werten aus Schritt 2 überein. Kontaktieren Sie Ihre Ansprechperson bei Ask Alma.

Hinweise

Die Plattform muss Ask Alma erreichen. Die Keyset-URL ruft nicht der Browser auf, sondern der Server der Plattform, um Signaturen von Ask Alma zu prüfen. Falls Ihr Server ausgehende Verbindungen nur eingeschränkt erlaubt (Firewall, Proxy), geben Sie die Adresse von Ask Alma frei. Fehlt die Erreichbarkeit, funktioniert der Launch, aber Deep Linking scheitert.

Ein Tool, viele Kurse. Die Registrierung gilt für die gesamte Installation. Lehrende müssen nichts weiter einrichten, sie wählen beim Anlegen eines Kursinhalts lediglich Ask Alma aus.

Kursdateien. Der Dateiimport, mit dem Assistenten die Materialien eines Kurses kennen, ist derzeit für Moodle, ILIAS und Canvas beschrieben. Ob und wie er für Ihre Plattform möglich ist, klären Sie mit Ihrer Ansprechperson bei Ask Alma.