DGTLMS & LMSDISPATCHER Guide

Authentifizierung und SSO

Keycloak anbinden (OpenID Connect)

Ermöglichen Sie Ihren Benutzern, sich über OpenID Connect mit ihrem Keycloak-Konto bei DGTLMS anzumelden – mit automatischem Import der Konfiguration.

Administrator~10 MinutenMittel
  • Ein Zugang als Keycloak-Administrator (um einen Client zu erstellen) und als DGTLMS-Administrator.
  • Die URL Ihres Keycloak-Realms.

In Keycloak

  1. Einen Client erstellen

    Erstellen Sie in Ihrem Realm einen OpenID-Connect-Client (vertraulicher Typ).

  2. Die Weiterleitungs-URL eintragen

    Fügen Sie die Rücksprung-URL von DGTLMS hinzu (wird von DGTLMS bei der Konfiguration angezeigt).

  3. Die Zugangsdaten abrufen

    Notieren Sie die Client ID und das Client Secret.

In DGTLMS

  1. Die Konfiguration öffnen

    Administration → Konfiguration der Authentifizierung → Eine Authentifizierungmethode hinzufügen → OAuth2 / OpenID Connect.

  2. Die Konfiguration importieren

    Fügen Sie die Discovery-URL Ihres Realms ein — https://<keycloak>/realms/<realm>/.well-known/openid-configuration — und klicken Sie dann auf Importer depuis discovery (Aus Discovery importieren). Die Endpunkte (Autorisierung, Token, Userinfo, Abmeldung) werden automatisch ausgefüllt.

  3. Die Client-Zugangsdaten eingeben

    Geben Sie die in Keycloak erhaltene Client ID und das Client Secret ein.

  4. Das Attribut-Mapping prüfen

    Stellen Sie sicher, dass E-Mail, Nachname und Vorname den entsprechenden Keycloak-Feldern zugeordnet sind.

  5. Speichern und testen

    Bestätigen Sie und testen Sie anschließend die Anmeldung über die Login-Seite.

Multiprofil-Benutzer (Lernende und Schulungsleiter…)

Dieselbe Person kann in DGTLMS mehrere Rollen haben (Lernende, Schulungsleiter, benutzerdefiniertes Niveau). Mit Keycloak funktioniert das ohne Entwicklungsaufwand — Es ist eine reine Konfigurationsfrage:

  1. Beide Optionen aktivieren

    In Administration → Einstellungen: „Multiprofil-Anwender aktivieren“ (Auswahl des Profils bei der Anmeldung) und „Den Profilselektor anzeigen“ (Wechsel während der Sitzung, oben rechts). Lassen Sie „Automatische Verbindung der Multiprofil-Anwender als Lerner“ deaktiviert, sonst wird die Auswahl übersprungen.

  2. Die von Keycloak gesendete Benutzerkennung abgleichen

    DGTLMS verknüpft eine Person über den Stamm der Benutzerkennung (die Kennung ohne das Rollensuffix _APP/_FOR…) mit ihren verschiedenen Profilen. Der Claim, den Keycloak als Login übermittelt, muss daher diesem Stamm entsprechen (oft preferred_username), nicht unbedingt der E-Mail-Adresse. Fügen Sie bei Bedarf einen Keycloak-Mapper hinzu, der genau diese Kennung ausgibt. Das ist der einzige wirklich spezifische Punkt, den Sie prüfen müssen — Insbesondere für Ihre bereits vorhandenen Konten mit _FOR/_APP.

  3. Die zusätzlichen Rollen anlegen

    Ein neuer, unbekannter Benutzer wird automatisch als Lernender angelegt. Um ihm eine zweite Rolle zu geben (z. B. Schulungsleiter), fügt ein Administrator das Profil über sein Datenblatt hinzu: DGTLMS versieht die Konten dann automatisch mit einem Suffix (_APP, _FOR…). Die Person sieht anschließend die Auswahl bei der Anmeldung und den Selektor in der Sitzung.

> Die Verknüpfung mit der Keycloak-Identität stützt sich auf die stabile Kennung des Anbieters (Claim sub): Sie übersteht Änderungen der E-Mail-Adresse und bleibt auch beim Hinzufügen einer Rolle erhalten.

  • Die Discovery-URL muss HTTPS verwenden.
  • Keycloak lässt sich auch per SAML anbinden, aber OIDC ist einfacher dank des automatischen Imports.
  • Das Konto muss in DGTLMS vorhanden sein (oder bereitgestellt werden), damit die Anmeldung gelingt.

Siehe auch