Skip to main content
Skip table of contents

Bekannte Probleme

ProblemLö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

 

Hinweis:

Wenn sich die Keycloak-Version ändert, sind diese Daten nicht gültig. Verwenden Sie in diesem Fall den Inhalt der Datei build-system.properties aus einer funktionsfähigen Keycloak-Instanz.



JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.