Bekannte Probleme

Problem

Lösung

Konfigurationsänderung wird nicht übernommen

Wenn Konfigurationsänderungen im Keycloak beim Ausführen des Keycloaks nicht angewendet werden, kann das daran liegen, dass Sie die Keycloak-Konfiguration nicht vorkompiliert haben.

Um dieses Verhalten zu vermeiden, empfiehlt es sich, den build-Befehl jedes Mal auszuführen, wenn Sie den Ausführungsmodus des Keycloak ändern. Weitere Informationen hierzu finden Sie im Abschnitt Keycloak starten.

Zugriff auf die Keycloak-Administrationskonsole ist von außen nicht möglich

Wenn der Zugriff auf den Netzwerkendpunkt für die Keycloak-Administrationskonsole (/admin) von außen nicht möglich ist, ist der Zugriff auf die Keycloak-Administrationskonsole nur über den Computer möglich, auf dem der Keycloak installiert ist.

So stellen Sie den Zugriff auf die Keycloak-Administrationskonsole lokal wieder her

1. Führen Sie in der Datei /c:/X4/keycloak/conf/keycloak.conf die folgenden Aktionen aus:

   • Kommentieren Sie proxy=edge ein.

   • Ändern Sie den Eintrag hostname=example.com in hostname=localhost.

2. Starten Sie den Keycloak im Entwicklungsmodus (siehe Keycloak starten).

Jetzt können Sie wie gewohnt durch Eingabe von http://localhost:8085/auth in einem Web-Browser auf den Keycloak zugreifen. Je nach Ihren Konfigurationseinstellungen kann sich diese URL ändern.

Wenn Sie alle Aktionen in der Keycloak-Administrationskonsole ausgeführt haben, müssen Sie die Proxy-Konfiguration in Keycloak erneut zuweisen, damit der Zugriff auf den X4 Server und die X4 Web Apps über den Proxy-Server wieder möglich ist.

Führen Sie dazu die folgenden Schritte aus:

1. Machen Sie die zuvor in der Datei /c:/X4/keycloak/conf/keycloak.confvorgenommenen Änderungen rückgängig:

   • Kommentieren Sie proxy=edge aus.

   • Ändern Sie hostname=localhost in hostname=example.com.

2. Starten Sie den Keycloak im Produktivmodus.

Datei build-system.properties fehlt

In einigen Fällen wird die Datei build-system.properties vom Dateisystem entfernt. Das führt beim Ausführen des build-Befehls zu einem Fehler mit dieser Fehlermeldung: 

Die Datei liegt im Verzeichnis /c:/X4/Keycloak/lib/quarkus/build-system.properties und enthält Metadaten zur Keycloak-Anwendung, die während der Vorkompilierung der Konfiguration verwendet werden. 

Um diesen Fehler zu beheben, legen Sie die Datei /c:/X4/Keycloak/lib/quarkus/build-system.properties an, und fügen Sie die folgenden Daten ein:

quarkus.application.name=keycloak-quarkus-server-app
quarkus.application.version=19.0.1
quarkus.version=2.7.6.Final