Single Sign-On via Keycloak (OIDC)
Aus lernlog Hilfesystem
BITTE BEACHTEN
- Die Konfiguration der Single Sign-On Schnittstelle zu Keycloak kann nicht eigenhändig durchgeführt werden. Bitte wende dich diesbezüglich an den Support.
- Wenn du Single Sign-On in lernlog verwendest, musst du nur einmalig deine Anmeldeinformationen eingeben.
- Wenn du nicht in lernlog registriert bist, wird der Zugriff auf die Plattform durch SSO unterbunden und leitet auf eine Fehlerseite weiter.
- Um die OIDC-Schnittstelle für den Single Sign-On (SSO) via Keycloak in lernlog aktivieren zu können, sind sowohl Einstellungen innerhalb deines Keycloak-Systems und innerhalb von lernlog notwendig. Wie genau vorzugehen ist, wird im Folgenden erläutert.
- Hierbei gelangt man an alle notwendigen Informationen zur Konfiguration der OIDC-Schnittstelle.
- Leite diese bitte an den technischen Support weiter, damit sie dich bei der Einrichtung unterstützen können.
- Es ist erforderlich einen Service-Provider für lernlog in Keycloak einzurichten:
- Klicke im Hauptmenü auf den Punkt "Clients".
- Klicke dort im Untermenü auf den Punkt "Create client".

- Konfiguriere in der neuen Ansicht den neuen OIDC Service Provider (statt YOUR-SERVER den Namen deines Servers eintragen).
- Schritt 1: Client ID = Client Name (wie z.B. "lernlog_oidc").

- Schritt 2: Bitte "Client authentication" (zur Einrichtung eines Client-Secret) aktivieren und "Standard flow" auswählen.

- Schritt 3: Bitte die folgende URL eingeben unter: "Valid redirect URIs":
- https://YOUR-SERVER.lernlog.digital/login/oauth2/code/lernlog_oidc

- Wenn die Konfiguration durch den Support in lernlog aktiviert wurde, erscheint auf dem Login Screen die Login-Möglichkeit via Keycloak.
Bitte beachte, dass sich Administratoren*innen in lernlog weiterhin über das normale Authentifizierungsverfahren in lernlog einloggen müssen.

- Per Klick auf "Login via Keycloak" gelangen Nutzer*innen nun zur Authentifizierungsmaske des Keycloak und können sich darüber einloggen.


- Finde in Keycloak die REALM ID für lernlog heraus bzw. lege zuvor ein Realm hierfür an. Diese lässt sich schließlich als Teil der OpenID Connect-Metadaten-URL eintragen, um an die öffentlichen OIDC-Konfigurationsdaten in JSON-Format zu gelangen (z.B. https://KEYCLOAK-URL/realms/REALM ID/.well-known/openid-configuration):

- Für den Client kann man das Client-Secret unter dem Tab "Credential" (oder auch "Zertifikat" oder "Authentifizierung") im Kunden-Detail-Bereich finden:
