Copyright (c) 2020-2023 Institut fuer Lern-Innovation, Friedrich-Alexander-Universitaet Erlangen-Nuernberg, GPLv3, see LICENSE
Die Weiterentwicklung wird durch die Databay AG angeboten.
Plugin Versionen für verschiedene ILIAS-Releases liegen in verschiedenen Branches dieses Repositories. Siehe CHANGELOG.md zu den Versionen.
Das Plugin kann im Zusammenhang mit der Standard-Shibboleth-Authentifizierung von ILAS eingesetzt werden und ermöglicht die automatische Zuordnung von ILIAS-Kursen beim Login aus dem Shibboleth-Verbund der Virtuellen Hochschule Bayern (vhb). Zusätzlich werden Kurslinks aus dem vhb-Portal unterstützt, so dass ein Student nach dem Kogin automatisch im gewünschten Kurs landet.
Wenn Sie das Plugin als ZIP-Datei aus GitHub herunterladen, benennen Sie das entpackte Verzeichnis bitte als VhbShibAuth (entfernen Sie das Branch-Suffix, z.B. -master und verwenden Sie die Groß-/Kleinschreibung wie angegeben).
- Kopieren Sie das Plugin-Verzeichnis in Ihrer ILIAS-Installation unter
Customizing/global/plugins/Services/AuthShibboleth/ShibbolethAuthenticationHook(erzeugen Sie die Unterverzeichnisse, falls nötig) - Führen Sie ein
composer duim Installationsverzeichnis von ILIAS aus - Wechseln Sie zu Administration > ILIAs erweitern > Plugins
- Installieren und aktivieren Sie das Plugin
Richten Sie zunächst Ihren Webserver als Service-Provider im vhb-Verbund wie auf der folgenden Seite beschrieben ein: https://doc.vhb.org/aai/shibboleth_service_provider_config_vhb
Die Apache-Konfiguration erfolgt ähnlich der für Moodle. Damit das Sitzungs-Cookie von ILIAS auch bei der Weiterleitung nach dem Shibboleth-Login gültig bleibt, muss die Location "vhb" der Shibboleth-Sitzung auf der gleichen Ebene des URL-Pfads liegen, wie das Skript "shib_login.php" von ILIAS. Der Standard-Aufruf "vhb/resolver.php " für Deep-Links aus dem vhb-Kursportal muss daher noch vor der Initialisierung der Shibboleth-Sitzung auf "vhb" ohne Unterpfad weitergeleitet werden.
In der folgenden Beispiel-Konfiguration wird davon ausgegangen, dass ILIAS direkt (ohne Unterpfad) im DOCUMENT ROOT von www.demo.odl.org installiert ist:
## Shibboleth-Login bei ILIAS
Alias /__vhb__ /srv/www/vhosts/demo/htdocs/shib_login.php
## Fuer Deeplinks aus dem Kursbuchungsportal
# Weiterleitung auf Shibboleth-Sitzung ohne Unterpfad
# Sonst werden die Sitzungs-Cookies von ILIAS falsch gesetzt
<LocationMatch "/__vhb__/resolver.php">
RedirectMatch "/__vhb__/resolver.php(.*)" "https://www.demo.odl.org/__vhb__$1"
</LocationMatch>
## Shibboleth-Sitzung
<LocationMatch "/__vhb__">
AuthType shibboleth
ShibRequireSession On
# zum Testen mit anderen IdPs
# require valid-user
# im Produktivbetrieb
require shib-attr eduPersonEntitlement urn:mace:vhb.org:entitlement:vhb-access
# applicationId aus shibboleth2.xml verwenden
ShibRequestSetting applicationId vhbblock
# Fehlerseiten mit Infos der vhb
ErrorDocument 401 /Customizing/global/plugins/Services/AuthShibboleth/ShibbolethAuthenticationHook/VhbShibAuth/templates/accessDenied.html
ErrorDocument 403 /Customizing/global/plugins/Services/AuthShibboleth/ShibbolethAuthenticationHook/VhbShibAuth/templates/accessDenied.html
# Korrekte Weiterleitung nach dem ILIAS-Login
RedirectMatch "/__vhb__/goto.php(.*)" "https://www.demo.odl.org/goto.php$1"
RedirectMatch "/__vhb__/ilias.php(.*)" "https://www.demo.odl.org/ilias.php$1"
RedirectMatch "/__vhb__/error.php(.*)" "https://www.demo.odl.org/error.php$1"
# Spezialfall: Weiterleitung zur Kursauswahl, wenn mehrere Kurse passen
RewriteEngine On
RewriteCond %{QUERY_STRING} ^target=ilias.php(.*)$
RewriteRule .*/goto.php https://www.demo.odl.org.de/ilias.php%1 [L]
</LocationMatch>
Konfigurieren und aktivieren Sie zunächst unter "Administration > Authentifizierung / Neuanmeldung > Shibboleth" die Standard-Shibboleth-Authentifizierung von ILIAS. Treffen Sie dabei die notwendigen Einstellungen:
- Shibboleth-Authentifizierung aktivieren: ja
- Erlaube lokale Authentifizierung: ja
- Generelle Rolle für Shibboleth-Benutzer: User (oder andere, je nach Ihrer ILIAS-Installation)
- Name der Shibboleth-Föderation: vhb
- Auswahl der Organisation: Anmeldebereich selber gestalten
- Eindeutiges Shibboleth Attribut: eduPersonPrincipalName
- Attribut für Vornamen: givenName
- Attribut für Nachnamen: sn
- Attribut für E-Mailadresse: mail
In der Regel wird die Authentifizierung durch Klick auf den Kurs-Link im vhb-Portal angestoßen und dabei der gewünschte Kurs als "Deep-Link" übergeben. Wenn Sie die vhb-Authentifizierung auf der Login-Seite von ILIAS verlinken möchten, können Sie dort einfach einen Link auf den Start der Shiboleth-Sitzung eintragen, im obigen Beispiel: https://www.demo.odl.org/__vhb__
- Wechseln Sie zu Administration > Plugins
- Wählen Sie die Aktion "Konfigurieren" für das VhbShibAuth-Plugin
- Beachten Sie dabei die Hinweise zu den Eingabefeldern.
- Rufen Sie in einem Kurs die Metadaten auf.
- Tragen Sie für die LV-Nummer als Schlagwort ein. Sie muss mit "LV_" beginnen.
Das Plugin erkennt auch LV-Nummern, die in älteren ILIAS-Versionen im Metadaten-Bereich "Allgemein" als Kennungen mit dem Katalog "vhb" eingetragen wurden. Da die Bearbeitung in diesem Bereich hakelig ist, sollten neue LV-Nummern nur noch als Schlagworte eingetragen werden. Damit sie schnell gefunden werden, sollte in der ILIAS-Datenbank der folgende Index ergänzt werden:
ALTER TABLE `il_meta_keyword` ADD INDEX `temp_keyword` (`keyword`);Ein ILIAS-Kurs kann mehrere LV-Nummerm zugeordnet haben und damit Mitglieder aus mehreren vhb-Kursen, z.B. unterschiedlicher Semester aufnehmen. Sie Können bei der LV-Nummer auch Wildcards (? und *) verwenden. Werden bei der Authentifizierung zu einer vhb-Kursbuchung mehrere passende ILIAS-Kurse gefunden, erscheint für Studierende eine Auswahlseite. Evaluatoren und Gäste werden automatisch in alle passenden Kurse eingeschrieben, sofern sie eine entsprechnende Rolle enthalten.