Zum Hauptinhalt springen

Anmeldungsprobleme

Passwort vergessen​

OpSee delegiert die Authentifizierung vollständig an Keycloak. Passwort-Zurückstellungen müssen über Keycloak durchgeführt werden:

  • Wenn auf der Anmeldeseite ein Link „Passwort vergessen" angezeigt wird, klicken Sie darauf und folgen Sie dem E-Mail-Zurückstellungsablauf. Dies erfordert einen in Keycloak konfigurierten Mailserver.
  • Wenn kein Zurückstellungslink angezeigt wird, muss ein Keycloak-Administrator Ihr Passwort manuell zurücksetzen: Keycloak-Verwaltungskonsole → Benutzer → Konto auswählen → Anmeldedaten → Passwort zurücksetzen.

Sitzung abgelaufen​

OAuth2-Token haben eine begrenzte Lebensdauer. Wenn Ihre Sitzung abläuft, geben API-Anfragen 401 zurück und die UI kann Sie möglicherweise ohne Warnung zur Anmeldeseite weiterleiten.

Lösung: Melden Sie sich explizit über das Avatar-Menü (oben rechts) ab und melden Sie sich dann wieder an. Das Schließen und erneute Öffnen der Browser-Registerkarte, ohne sich vorher abzumelden, kann auch eine veraltete Sitzung beheben.

401 auf jeder Seite nach dem Anmelden​

Wenn Sie zur Anmeldeseite weitergeleitet werden, sich erfolgreich authentifizieren und dann sofort wieder 401-Fehler sehen, ist das in Ihrem Browser gespeicherte Token möglicherweise beschädigt.

Lösung:

  1. Öffnen Sie Browser-Entwicklertools → Anwendung → Cookies. Löschen Sie alle Cookies für die OpSee-Domain.
  2. Öffnen Sie den lokalen Speicher (Local Storage) und löschen Sie alle Einträge für die OpSee-Domain.
  3. Schließen Sie die Registerkarte, öffnen Sie sie erneut und melden Sie sich an.

403 nach Anmeldung (kann sich anmelden, kann aber nicht auf etwas zugreifen)​

Ein 403-Fehler unmittelbar nach einer erfolgreichen Keycloak-Anmeldung bedeutet, dass das Konto existiert und sich korrekt authentifiziert hat, aber keine Rollen in OpSee zugeordnet sind.

Lösung: Ein Keycloak-Administrator muss Ihrem Konto Rollen zuweisen:

  1. Öffnen Sie die Keycloak-Verwaltungskonsole.
  2. Navigieren Sie zu Benutzer → Konto auswählen → Rollenzuordnungen.
  3. Weisen Sie unter dem OpSee-Client die entsprechenden Rollen zu (z.B. menu:production, menu:oee, menu:admin).
  4. Bitten Sie den Benutzer, sich ab- und erneut anzumelden, damit die neuen Rollen in Kraft treten.

Keycloak ist nicht verfügbar​

Wenn die Anmeldeseite selbst nicht geladen wird oder der Browser einen Verbindungsfehler beim Zugriff auf Keycloak anzeigt, ist der Keycloak-Docker-Container möglicherweise gestoppt.

Lösung:

  1. SSH in den Server und führen Sie docker ps aus, um zu sehen, welche Container ausgeführt werden.
  2. Wenn der Keycloak-Container nicht aufgelistet ist oder den Status Exited anzeigt, starten Sie ihn neu: docker compose up -d keycloak.
  3. Überprüfen Sie die Keycloak-Container-Protokolle auf Startfehler: docker compose -f infra/docker-compose.yml logs keycloak.
  4. Warten Sie, bis Keycloak vollständig gestartet ist (kann 30-60 Sekunden dauern), bevor Sie versuchen, sich erneut anzumelden.

Umleitungsschleife​

Wenn der Browser ständig zwischen der OpSee-App und der Keycloak-Anmeldeseite springt, ohne sich jemals zu stabilisieren, ist wahrscheinlich eine Fehlkonfiguration im OAuth2-Proxy oder den Keycloak-Clienteinstellungen vorhanden.

Mögliche Ursachen:

  • Der in der Keycloak-Client registrierte Umleitungs-URI stimmt nicht mit der tatsächlichen Anwendungs-URL überein.
  • Das OAuth2-Proxy-Cookie-Geheimnis hat sich geändert oder fehlt.
  • Die Umgebungsvariable SERVER_DOMAIN stimmt nicht mit der Domäne überein, die der Browser verwendet.

Lösung: Wenden Sie sich an Ihren Infrastruktur-Administrator. Diese Art von Problem erfordert Zugriff auf die Docker-Compose-Konfiguration und die Keycloak-Verwaltungskonsole, um die Clienteinstellungen zu korrigieren.