Ga naar hoofdinhoud

Aanmeldproblemen

Wachtwoord vergeten​

OpSee delegeert de authenticatie volledig aan Keycloak. Het opnieuw instellen van wachtwoorden moet via Keycloak verlopen:

  • Als de link "Wachtwoord vergeten" wordt weergegeven op de aanmeldpagina, klikt u erop en volgt u de e-mailprocedure voor herstel. Hiervoor moet er een mailserver in Keycloak zijn geconfigureerd.
  • Als er geen herstellink verschijnt, moet een Keycloak-beheerder uw wachtwoord handmatig opnieuw instellen: Keycloak Admin Console → Users → selecteer uw account → Credentials → Reset Password.

Sessie verlopen​

OAuth2-tokens hebben een beperkte levensduur. Wanneer uw sessie verloopt, retourneren API-aanroepen 401 en kan de UI u zonder waarschuwing terugbrengen naar de aanmeldpagina.

Oplossing: meld u expliciet af via het avatarmenu (rechtsboven) en log opnieuw in. Het tabblad sluiten en opnieuw openen zonder eerst af te melden kan ook een verlopen sessie oplossen.

401 op elke pagina na het aanmelden​

Als u wordt doorverwezen naar de aanmeldpagina, succesvol authenticeert en daarna onmiddellijk opnieuw 401-fouten ziet, is het in uw browser opgeslagen token mogelijk beschadigd.

Oplossing:

  1. Open de ontwikkelaarstools van uw browser → Application → Cookies — verwijder alle cookies voor het OpSee-domein.
  2. Open Local Storage — verwijder alle items voor het OpSee-domein.
  3. Sluit het tabblad, open het opnieuw en log weer in.

403 na het aanmelden (u kunt zich aanmelden, maar nergens bij)​

Een 403-fout direct na een geslaagde Keycloak-aanmelding betekent dat het account bestaat en correct is geauthenticeerd, maar geen rollen heeft toegewezen in OpSee.

Oplossing: een Keycloak-beheerder moet rollen aan uw account toewijzen:

  1. Open de Keycloak Admin Console.
  2. Ga naar Users → selecteer uw account → Role Mappings.
  3. Wijs onder de OpSee-client de juiste rollen toe (bijv. menu:production, menu:oee, menu:admin).
  4. Vraag de gebruiker zich af te melden en opnieuw aan te melden zodat de nieuwe rollen van kracht worden.

Keycloak is onbereikbaar​

Als de aanmeldpagina zelf niet laadt, of als de browser een verbindingsfout toont bij een poging Keycloak te bereiken, is mogelijk de Keycloak Docker-container gestopt.

Oplossing:

  1. Maak via SSH verbinding met de server en voer docker ps uit om te zien welke containers actief zijn.
  2. Als de Keycloak-container niet wordt vermeld of de status Exited heeft, start deze dan opnieuw: docker compose up -d keycloak.
  3. Bekijk de logs van de Keycloak-container voor opstartfouten: docker compose -f infra/docker-compose.yml logs keycloak.
  4. Wacht tot Keycloak volledig is opgestart (dit kan 30-60 seconden duren) voordat u opnieuw probeert in te loggen.

Doorverwijzingslus​

Als de browser blijft heen-en-weer springen tussen de OpSee-app en de Keycloak-aanmeldpagina zonder ooit tot rust te komen, is er waarschijnlijk een configuratiefout in de OAuth2 Proxy of in de Keycloak-clientinstellingen.

Mogelijke oorzaken:

  • De redirect-URI die in de Keycloak-client is geregistreerd, komt niet overeen met de werkelijke applicatie-URL.
  • Het cookie-secret van OAuth2 Proxy is gewijzigd of ontbreekt.
  • De omgevingsvariabele SERVER_DOMAIN komt niet overeen met het domein dat de browser gebruikt.

Oplossing: neem contact op met uw infrastructuurbeheerder. Dit type probleem vereist toegang tot de Docker Compose-configuratie en de Keycloak-beheerconsole om de clientinstellingen te corrigeren.