Keycloak

Keycloak ist eine Open-Source-Identitäts- und Zugriffsverwaltungslösung, die eine zentrale Benutzerverwaltung für moderne Anwendungen und Dienste ermöglicht. Als robuste Authentifizierungs- und Autorisierungsplattform bietet Keycloak:

• Single Sign-On (SSO) für Web-Anwendungen und RESTful Webservices
• Unterstützung für verschiedene Authentifizierungsprotokolle (OpenID Connect, OAuth 2.0, SAML)
• Integration mit externen Benutzerverzeichnissen (LDAP, Active Directory)
• Zwei-Faktor-Authentifizierung und Social Login
• Benutzer-Federation und Identity Brokering
• Umfangreiche Administrative Funktionen und Benutzer-Self-Service

Die Plattform ermöglicht eine sichere und effiziente Verwaltung von Benutzeridentitäten und Zugriffsrechten über eine zentrale Stelle.

Bisher wird Keycloak ausschließlich vom InGrid-Editor verwendet. Weitere Komponenten werden folgen, mit dem Ziel, Keycloak in allen InGrid-Komponenten zu verwenden.

Systemvoraussetzungen¶

Installation¶

Am einfachsten ist die Installation über Docker und unser bereitgestelltes Docker-Image. Dies beinhaltet folgende Konfigurationen:

• neuer Realm für InGrid
• angepasstes Theme, das sich an die InGrid-Komponenten angliedert
• einfache Konfiguration der Emails für das Zurücksetzen des Passworts
• Erstellung der benötigten Rollen
• Erstellung der Clients
• Erstellung des Super-Admins für die Verwaltung des InGrid-Editors
• Verzögerter Start bis Datenbank bereit ist

Docker¶

services:

    keycloak:
        image: docker-registry.wemove.com/keycloak:${KEYCLOAK_VERSION}
        restart: unless-stopped
        environment:
          - KC_BOOTSTRAP_ADMIN_USERNAME=admin
          - KC_BOOTSTRAP_ADMIN_PASSWORD=admin
          - KC_HTTP_RELATIVE_PATH=/keycloak
          - KC_HOSTNAME=http://${HOST_URL}/keycloak
          - KC_HTTP_ENABLED=true
          - KC_DB=postgres
          - KC_DB_URL_HOST=db
          - KC_DB_USERNAME=${DB_USERNAME}
          - KC_DB_PASSWORD=${DB_PASSWORD}
          - MAIL_SMTP=mailrelay
          - MAIL_FROM=${MAIL_FROM}
          - IGE_SUPER_USER_LOGIN=ige
          - IGE_SUPER_USER_PASSWORD=ige
          - IGE_SUPER_USER_FIRSTNAME=Max
          - IGE_SUPER_USER_LASTNAME=Mustermann
          - IGE_SUPER_USER_EMAIL=max.mustermann@beispiel.de
        networks:
          - informationgrid-network

In einer weiteren Datei .env werden die Variablen für die docker-compose.yml Datei gesetzt.

Umgebungsvariablen¶

Da als Basis das Original-Keycloak-Image verwendet wird, können hier alle Umgebungsvariablen für Keycloak verwendet werden (Keycloak-Umgebungsvariablen). Zusätzlich werden von uns die folgenden Umgebungsvariablen bereitgestellt: