Prejsť na hlavný obsah

Problémy s prihlásením

Zabudnuté heslo​

OpSee deleguje overovanie úplne na Keycloak. Resetovanie hesla musí prebehnúť cez Keycloak:

  • Ak sa na prihlasovacej stránke zobrazuje odkaz „Zabudnuté heslo", kliknite naň a postupujte podľa e-mailového toku resetovania. Toto vyžaduje, aby bol v Keycloaku nakonfigurovaný poštový server.
  • Ak sa žiadny odkaz na resetovanie nezobrazuje, administrátor Keycloak musí vaše heslo resetovať ručne: Keycloak Admin Console → Users → vyberte svoje konto → Credentials → Reset Password.

Relácia vypršala​

OAuth2 tokeny majú obmedzenú životnosť. Keď vaša relácia vyprší, požiadavky API vracajú 401 a používateľské rozhranie vás môže bez varovania presmerovať na prihlasovaciu stránku.

Riešenie: explicitne sa odhláste pomocou ponuky avatara (vpravo hore) a potom sa znovu prihláste. Aj zatvorenie a opätovné otvorenie karty prehliadača bez predchádzajúceho odhlásenia môže vyriešiť zastaranú reláciu.

401 na každej stránke po prihlásení​

Ak vás presmeruje na prihlasovaciu stránku, úspešne sa overíte a potom okamžite znova vidíte chyby 401, token uložený vo vašom prehliadači môže byť poškodený.

Riešenie:

  1. Otvorte vývojárske nástroje prehliadača → Application → Cookies — odstráňte všetky súbory cookie pre doménu OpSee.
  2. Otvorte Local Storage — odstráňte všetky položky pre doménu OpSee.
  3. Zatvorte kartu, znovu ju otvorte a opätovne sa prihláste.

403 po prihlásení (môžete sa prihlásiť, ale nemáte prístup k ničomu)​

Chyba 403 ihneď po úspešnom prihlásení do Keycloak znamená, že konto existuje a bolo správne overené, ale v OpSee mu neboli priradené žiadne roly.

Riešenie: administrátor Keycloak musí priradiť roly vášmu kontu:

  1. Otvorte Keycloak Admin Console.
  2. Prejdite na Users → vyberte svoje konto → Role Mappings.
  3. Pod klientom OpSee priraďte vhodné roly (napr. menu:production, menu:oee, menu:admin).
  4. Požiadajte používateľa, aby sa odhlásil a znovu prihlásil, aby sa nové roly prejavili.

Keycloak je nedostupný​

Ak sa samotná prihlasovacia stránka nenačíta alebo prehliadač zobrazí chybu pripojenia pri pokuse o dosiahnutie Keycloaku, Docker kontajner Keycloak sa mohol zastaviť.

Riešenie:

  1. Pripojte sa k serveru cez SSH a spustite docker ps, aby ste videli, ktoré kontajnery bežia.
  2. Ak kontajner Keycloak nie je uvedený alebo má stav Exited, reštartujte ho: docker compose up -d keycloak.
  3. Skontrolujte logy kontajnera Keycloak kvôli chybám pri spustení: docker compose -f infra/docker-compose.yml logs keycloak.
  4. Pred ďalším pokusom o prihlásenie počkajte, kým sa Keycloak úplne nespustí (môže to trvať 30 – 60 sekúnd).

Slučka presmerovaní​

Ak prehliadač neustále preskakuje medzi aplikáciou OpSee a prihlasovacou stránkou Keycloak bez toho, aby sa niekde ustálil, pravdepodobne ide o chybu konfigurácie v OAuth2 Proxy alebo v nastaveniach klienta Keycloak.

Možné príčiny:

  • URI presmerovania zaregistrované v klientovi Keycloak nezodpovedá skutočnej URL aplikácie.
  • Tajomstvo cookie OAuth2 Proxy sa zmenilo alebo chýba.
  • Premenná prostredia SERVER_DOMAIN nezodpovedá doméne, ktorú používa prehliadač.

Riešenie: kontaktujte svojho administrátora infraštruktúry. Tento typ problému vyžaduje prístup ku konfigurácii Docker Compose a k administračnej konzole Keycloak na opravu nastavení klienta.