Passa al contenuto principale

Problemi di accesso

Password dimenticata​

OpSee delega completamente l'autenticazione a Keycloak. La reimpostazione della password deve avvenire tramite Keycloak:

  • Se il link "Password dimenticata" è visualizzato nella pagina di accesso, fai clic su di esso e segui il flusso di reimpostazione via email. Questo richiede che un server di posta sia configurato in Keycloak.
  • Se non appare alcun link di reimpostazione, un amministratore Keycloak deve reimpostare manualmente la tua password: Console di amministrazione Keycloak → Utenti → seleziona il tuo account → Credenziali → Reimposta password.

Sessione scaduta​

I token OAuth2 hanno una durata limitata. Quando la sessione scade, le richieste API restituiscono 401 e l'interfaccia può reindirizzarti alla pagina di accesso senza preavviso.

Soluzione: disconnettiti esplicitamente utilizzando il menu dell'avatar (in alto a destra), quindi accedi nuovamente. Anche chiudere e riaprire la scheda del browser senza disconnettersi prima può risolvere una sessione scaduta.

401 su ogni pagina dopo l'accesso​

Se vieni reindirizzato alla pagina di accesso, ti autentichi correttamente e poi vedi immediatamente di nuovo errori 401, il token memorizzato nel browser potrebbe essere corrotto.

Soluzione:

  1. Apri gli strumenti per sviluppatori del browser → Applicazione → Cookie — elimina tutti i cookie per il dominio OpSee.
  2. Apri il Local Storage — elimina tutte le voci per il dominio OpSee.
  3. Chiudi la scheda, riaprila e accedi di nuovo.

403 dopo l'accesso (puoi accedere ma non puoi raggiungere nulla)​

Un errore 403 immediatamente dopo un accesso Keycloak riuscito significa che l'account esiste e si è autenticato correttamente, ma non ha ruoli assegnati in OpSee.

Soluzione: un amministratore Keycloak deve assegnare ruoli al tuo account:

  1. Apri la Console di amministrazione Keycloak.
  2. Vai su Utenti → seleziona il tuo account → Mappature ruoli.
  3. Sotto il client OpSee, assegna i ruoli appropriati (es. menu:production, menu:oee, menu:admin).
  4. Chiedi all'utente di disconnettersi e riconnettersi affinché i nuovi ruoli abbiano effetto.

Keycloak non è raggiungibile​

Se la pagina di accesso stessa non si carica, o il browser mostra un errore di connessione quando cerca di raggiungere Keycloak, il container Docker di Keycloak potrebbe essersi arrestato.

Soluzione:

  1. Connettiti via SSH al server ed esegui docker ps per vedere quali container sono in esecuzione.
  2. Se il container Keycloak non è elencato o mostra lo stato Exited, riavvialo: docker compose up -d keycloak.
  3. Controlla i log del container Keycloak per individuare errori di avvio: docker compose -f infra/docker-compose.yml logs keycloak.
  4. Attendi che Keycloak si avvii completamente (può richiedere 30-60 secondi) prima di tentare nuovamente l'accesso.

Loop di reindirizzamento​

Se il browser continua a rimbalzare tra l'app OpSee e la pagina di accesso Keycloak senza mai stabilizzarsi, è probabile che ci sia un errore di configurazione nell'OAuth2 Proxy o nelle impostazioni del client Keycloak.

Cause possibili:

  • L'URI di reindirizzamento registrato nel client Keycloak non corrisponde all'URL effettivo dell'applicazione.
  • Il segreto del cookie di OAuth2 Proxy è cambiato o è mancante.
  • La variabile d'ambiente SERVER_DOMAIN non corrisponde al dominio utilizzato dal browser.

Soluzione: contatta il tuo amministratore di infrastruttura. Questo tipo di problema richiede l'accesso alla configurazione Docker Compose e alla console di amministrazione Keycloak per correggere le impostazioni del client.