ILIAS anbinden

Die Anbindung an ILIAS besteht aus zwei Teilen:

1. LTI-Anbindung: Ask Alma wird als globaler LTI-Provider angelegt. Danach können Lehrende in ihren Kursen ein Objekt LTI-Konsument anlegen und dabei einen Kursinhalt (Assistent, Quiz, Lernkarten oder Lernsession) auswählen. Studierende öffnen ihn anschließend direkt aus dem Kurs heraus.
2. Dateiimport: Ask Alma darf die Materialien eines Kurses aus ILIAS lesen, damit Assistenten die Unterlagen des Kurses kennen. Dieser Teil ist optional und nutzt die WebDAV-Schnittstelle von ILIAS, nicht LTI.

Sie benötigen für beide Teile Administrationsrechte in ILIAS. Die Bezeichnungen der Menüpunkte entsprechen der deutschen ILIAS-Oberfläche.

LTI-Anbindung

Ask Alma ist bei Ihnen bereits ohne Deep Linking eingerichtet?

Dann müssen Sie nicht bei Schritt 1 neu anfangen. Es genügt, Deep Linking nachträglich einzurichten.

1. Einen Provider anlegen

Administration → Ilias erweitern → LTI → ILIAS als LTI-Konsument → Globalen Provider für alle Benutzer hinzufügen

Feld	Wert
Titel	Ask Alma
Beschreibung	frei wählbar
Icon	optional, siehe Hinweise
Verfügbarkeit	in neuen und bestehenden Objekten
LTI Version	Version 1.3

Nach der Wahl von Version 1.3 erscheinen die weiteren Felder:

Feld	Wert
Launch URL	https://api.ask-alma.de/launch/
Initiate Login URL	https://api.ask-alma.de/oidc/
Redirection URIs	https://api.ask-alma.de/launch/
Typ des öffentlichen Schlüssels	URL (Json Web Token)
URL	https://api.ask-alma.de/jwks
Unterstützung für Deep Linking	✓
Inhalts-URL	https://api.ask-alma.de/launch/

Die restlichen Einstellungen können Sie unverändert lassen.

Speichern

2. Die Werte abholen, die ILIAS vergibt

Öffnen Sie den gespeicherten Provider erneut. Unten im Abschnitt Authentifizierung zeigt ILIAS jetzt ein nicht editierbares Feld mit sechs Werten:

Platform ID:                  https://ilias.example
Client ID:                    <von ILIAS vergeben>
Deployment ID:                <von ILIAS vergeben>
Public keyset URL:            https://ilias.example/lticerts.php
Access token URL:             https://ilias.example/ltitoken.php
Authentication request URL:   https://ilias.example/ltiauth.php

https://ilias.example steht hier für die Adresse Ihrer ILIAS-Installation. Übernehmen Sie die Werte aus diesem Feld und verwenden Sie sie in den folgenden Schritten.

3. Werte an Ask Alma übermitteln

Schicken Sie die sechs Werte aus Schritt 2 an Ihre Ansprechperson bei Ask Alma und geben Sie an, dass sie zu dieser ILIAS-Installation gehören. Ask Alma trägt die Werte ein und aktiviert 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 wählen Sie Neues Objekt hinzufügen → Inhalt → LTI-Konsument.
2. Wählen Sie den Provider Ask Alma.
3. ILIAS öffnet die Auswahlseite von Ask Alma (Deep Linking). Wählen Sie einen Kursinhalt (Assistent, Quiz, Lernkarten oder Lernsession) aus oder die vollständige Anwendung Ask Alma und bestätigen Sie.
4. ILIAS legt das Objekt im Kurs an.

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

Kursdateien

Sollen Assistenten auch die Materialien des Kurses kennen, richten Sie zusätzlich den Dateiimport ein. Dafür nutzt Ask Alma die WebDAV-Schnittstelle von ILIAS, nicht LTI.

Häufige Probleme

Symptom	Ursache
Das Objekt lässt sich öffnen, aber das Bestätigen der Auswahl beim Anlegen endet mit einer ILIAS-Fehlerseite („Es ist ein Fehler aufgetreten … Error Code …")	Der ILIAS-Server kann die URL des öffentlichen Schlüssels nicht erreichen. Stellen Sie sicher, dass der Server die JWKS-URL aufrufen kann.
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.
Der Provider erscheint beim Anlegen eines LTI-Konsumenten nicht	Verfügbarkeit steht nicht auf für neue und bestehende Objekte.
Die Auswahlseite von Ask Alma erscheint nicht	Unterstützung für Deep Linking ist nicht angehakt oder die Inhalts-URL fehlt.

Hinweise zur LTI-Anbindung

ILIAS muss Ask Alma erreichen. Die URL des öffentlichen Schlüssels ruft der ILIAS-Server auf. Falls Ihr Server ausgehende Verbindungen nur eingeschränkt erlaubt (Firewall, Proxy), geben Sie die Adresse von Ask Alma frei.

Symbol des Providers. Im Provider-Formular können Sie unter Icon eine Bilddatei hochladen, die ILIAS neben dem Objekt anzeigt. Ein passendes Logo erzeugen Sie mit dem Logo-Konfigurator. Öffnen Sie den erzeugten Link im Browser und speichern Sie das Logo als Datei.

ILIAS-Verwaltungsobjekt

Ob eine Person einen Kursbereich in Ask Alma verwalten darf (Kursassistenten, Quizze, Lernkarten und Lernsessions anlegen und bearbeiten), legt bei ILIAS nicht jeder Start fest, sondern nur der Start über das ILIAS-Verwaltungsobjekt des Kurses:

• Festlegen: Das erste ILIAS-Objekt, über das eine Lehrperson Ask Alma im Kurs öffnet, wird automatisch zum Verwaltungsobjekt. Infrage kommen nur Objekte, die die vollständige Anwendung öffnen (angelegt mit Vollständig einbinden oder ohne Deep Linking), nicht Objekte für einen einzelnen Kursinhalt.
• Wirkung: Wer Ask Alma über das Verwaltungsobjekt öffnet, erhält oder verliert Verwaltungsrechte für den Kursbereich: Lehrende werden Admin, Lernende nicht. Starts über andere Objekte, etwa in Gruppen oder Ordnern oder über Direktlinks, ändern keine Rechte. Wer Ask Alma zum ersten Mal über ein solches Objekt öffnet, hat zunächst keine Verwaltungsrechte.
• Ausnahme: Administrator:innen von Ask Alma haben in jedem Kurs Verwaltungsrechte, unabhängig vom Objekt.

Empfehlung: Öffnen Sie Ask Alma in einem Kurs zuerst über ein Objekt, das direkt im Kurs liegt. Liegt das Verwaltungsobjekt in einer Gruppe oder einem Ordner, erhalten deren Admins Verwaltungsrechte für den gesamten Kursbereich.

Welches Objekt das Verwaltungsobjekt ist, sehen Lehrende mit Verwaltungsrechten und Administrator:innen in Ask Alma in der Kurskonfiguration: Drei-Punkte-Menü neben dem Kursnamen in der Seitenleiste → Konfiguration, Abschnitt ILIAS-Verwaltungsobjekt, mit Titel, Ref-ID und dem Zeitpunkt des letzten Starts. Ist versehentlich das falsche Objekt festgelegt, klicken Sie dort auf Zurücksetzen und dann auf Zurücksetzen bestätigen. Öffnen Sie Ask Alma gleich danach über das Objekt, das direkt im Kurs liegt, denn das nächste Objekt, über das eine Lehrperson startet, wird zum neuen Verwaltungsobjekt.

Dateiimport

Damit Assistenten die Unterlagen eines Kurses kennen, kann Ask Alma die Materialien des Kurses aus ILIAS lesen. Ask Alma nutzt dafür die WebDAV-Schnittstelle von ILIAS. Dieses Kapitel beschreibt, wie Sie WebDAV freischalten und einen Account mit Leserechten anlegen, mit dem Ask Alma zugreift.

Voraussetzung ist, dass Ask Alma bereits als LTI-Provider angelegt ist. Ohne den Dateiimport funktioniert die Anbindung trotzdem, Assistenten haben dann lediglich keinen Zugriff auf die Kursdateien.

Wie der Zugriff funktioniert

Ask Alma meldet sich mit einem festen ILIAS-Account per WebDAV an, liest den Dateibaum des Kurses, aus dem Ask Alma geöffnet wurde, und lädt Dateien bei Bedarf über denselben Weg. Den Account legen Sie in diesem Kapitel an. Er braucht nur Leserechte.

1. WebDAV einschalten

Administration → ILIAS erweitern → WebDAV → Allgemeine Einstellungen

Feld	Wert
WebDAV Zugriff aktivieren	✓

Speichern

2. Einen Account für Ask Alma anlegen

Administration → Benutzer und Rollen → Benutzer → Benutzer hinzufügen

Feld	Wert
Benutzername	z. B. askalma
Passwort	ein sicheres, selbst gewähltes Passwort
Vorname / Nachname	z. B. Ask / Alma
E-Mail	eine erreichbare Adresse, z. B. eine Funktionsadresse Ihrer Hochschule

Zwei Dinge sind dabei wichtig:

• Lokale Anmeldung. Der Account muss sich direkt in ILIAS anmelden können. Accounts, die über LDAP, Shibboleth oder ein anderes Single Sign-on authentifiziert werden, funktionieren für WebDAV nicht.
• Nutzungsvereinbarung. Verlangt Ihre Installation beim ersten Login die Zustimmung zu einer Nutzungsvereinbarung, melden Sie sich einmal im Browser mit dem neuen Account an und bestätigen Sie sie. Vorher weist ILIAS den WebDAV-Zugriff ab.

3. Eine Rolle mit Leserechten anlegen

WebDAV nutzt die normalen Rechte des ILIAS-Repositorys. Der Account braucht auf jedem Objekt, das Ask Alma sehen soll (Kurs, Ordner, Datei), die Rechte Sichtbar und Lesen. Am einfachsten geht das mit einer eigenen globalen Rolle.

Administration → Benutzer und Rollen → Rollen → Rolle hinzufügen

Feld	Wert
Titel	Ask Alma
Rechte schützen	✓

Rechte schützen ist wichtig: Ohne diesen Haken reduziert ILIAS die Rechte einer globalen Rolle innerhalb von Kursen und Gruppen auf die Vorlage für Nichtmitglieder, und die endet bei Sichtbar. Die Rolle sähe dann den Kurs, aber nichts darin.

Öffnen Sie danach den Reiter Rechte der Rolle und kreuzen Sie für die folgenden Objekttypen jeweils Sichtbar und Lesen an:

Objekttyp	Sichtbar	Lesen
Kurs	✓	✓
Gruppe	✓	✓
Ordner	✓	✓
Datei	✓	✓

Weitere Rechte wie Download oder Schreibrechte braucht Ask Alma nicht. Kreuzen Sie beim Speichern Vorhandene Objekte ändern an, damit die Rechte auch für bereits bestehende Kurse gelten.

4. Dem Account die Rolle zuweisen

Öffnen Sie die Rolle Ask Alma und fügen Sie im Reiter Benutzerzuweisung den Account aus Schritt 2 hinzu.

5. Den Mandanten herausfinden

ILIAS kann mehrere Mandanten (Clients) betreiben, und der Mandant ist Teil der WebDAV-Adresse. Er steht in der Adresse Ihrer Anmeldeseite als client_id=… oder in der Datei ilias.ini.php. Bei einer Standardinstallation heißt er default. Dieser Wert hat nichts mit der Client ID aus der LTI-Anbindung zu tun.

6. Den Zugang in Ask Alma eintragen

Öffnen Sie Ask Alma aus ILIAS heraus, klicken Sie unten links in der Seitenleiste auf Einstellungen & Hilfe und wählen Sie Administration. Der Eintrag ist nur für Administrator:innen sichtbar, also für Personen mit der LTI-Rolle Administrator in ILIAS oder für in Ask Alma ernannte Administrator:innen.

Admin-Dashboard → Verwaltung → Lernplattform-Zugriffe → Hinzufügen

Im Dialog Lernplattform-Zugang hinzufügen tragen Sie ein:

Feld	Wert
Zugriffsart	Dateizugriff für Kursassistenten
Domain	die Basis-Adresse Ihrer Installation, z. B. https://ilias.example
ILIAS-Client	der Mandant aus Schritt 5
Benutzername oder E-Mail-Adresse	der Benutzername des Accounts aus Schritt 2
Passwort	das Passwort dieses Accounts

Das Passwort können Sie während der Eingabe über das Auge-Symbol (Wert anzeigen) prüfen. Nach dem Speichern zeigt Ask Alma es nicht mehr an.

Lernplattform-Zugang hinzufügen.

Der Dateiimport ist damit aktiv. Der Zugang erscheint in der Karte unter Zugriffsart als Dateizugriff für Kursassistenten. Wie Sie ihn später bearbeiten oder entfernen, beschreibt Verwaltung → Lernplattform-Zugriffe.

Hinweise zum Dateiimport

Kein Zugriff ohne Anlass. Ask Alma ruft nicht von sich aus oder in regelmäßigen Abständen Dateien oder Kursinformationen ab. Die Dateiliste eines Kurses wird nur abgerufen, wenn Lehrende dort einen Kursassistenten anlegen oder bearbeiten oder einen Lerninhalt erstellen, um ihnen die verfügbaren Dateien zur Auswahl anzuzeigen. Heruntergeladen wird eine Datei erst, wenn Lehrende sie dort aktiv auswählen.

Zugriff nur auf den aktuellen Kurs. ILIAS übermittelt beim Öffnen die Kennung des Kurses (oder der Gruppe), in dem das Ask-Alma-Objekt liegt, und nur den Dateibaum unterhalb dieses Kurses liest Ask Alma. Andere Kurse werden nicht abgerufen.

Offline geschaltete Kurse und Dateien bleiben unsichtbar, unabhängig von den Rechten der Rolle. Für Kursmaterial ist das in der Regel erwünscht.

Dateinamen. WebDAV liefert den Titel des ILIAS-Objekts, nicht den ursprünglich hochgeladenen Dateinamen. Meist ist beides gleich. Fehlt dem Titel die Dateiendung, ergänzt Ask Alma sie anhand des Dateityps.

Der Account gehört Ask Alma, nicht der Person, die Ask Alma öffnet. Ask Alma sieht damit alles, was der Account lesen darf. Wenn Sie den Account löschen oder ihm Rechte entziehen, wirkt sich das sofort auf den Dateiimport aus. Ändern Sie das Passwort des Accounts, entfernen Sie den Zugang im Admin-Dashboard und legen Sie ihn mit dem neuen Passwort neu an, siehe Lernplattform-Zugriffe.

Das Passwort liegt verschlüsselt in Ask Alma. Ask Alma speichert Domain, ILIAS-Client, Benutzername und Passwort verschlüsselt und zeigt das Passwort nach dem Speichern nicht mehr an, auch nicht im Admin-Dashboard. Es wird ausschließlich für den Zugriff über WebDAV verwendet.