Pular para o conteúdo principal

Problemas de Login

Senha esquecida​

O OpSee delega toda a autenticação ao Keycloak. A redefinição de senha deve ser feita pelo Keycloak:

  • Se o link "Esqueci minha senha" for exibido na página de login, clique nele e siga o fluxo de redefinição por e-mail. Isso requer que um servidor de e-mail esteja configurado no Keycloak.
  • Se nenhum link de redefinição aparecer, um administrador Keycloak deve redefinir manualmente sua senha: Keycloak Admin Console → Users → selecione sua conta → Credentials → Reset Password.

Sessão expirada​

Os tokens OAuth2 têm tempo de vida limitado. Quando sua sessão expira, as requisições de API retornam 401 e a interface pode redirecioná-lo para a página de login sem aviso.

Solução: faça logout explicitamente usando o menu do avatar (canto superior direito) e, em seguida, faça login novamente. Fechar e reabrir a aba do navegador sem fazer logout antes também pode resolver uma sessão obsoleta.

401 em todas as páginas após o login​

Se você for redirecionado para a página de login, autenticar com sucesso e em seguida ver imediatamente erros 401 novamente, o token armazenado no seu navegador pode estar corrompido.

Solução:

  1. Abra as ferramentas de desenvolvedor do navegador → Application → Cookies — exclua todos os cookies do domínio OpSee.
  2. Abra o Local Storage — exclua todas as entradas do domínio OpSee.
  3. Feche a aba, reabra-a e faça login novamente.

403 após login (consegue logar mas não acessa nada)​

Um erro 403 imediatamente após um login Keycloak bem-sucedido significa que a conta existe e foi autenticada corretamente, mas não tem funções atribuídas no OpSee.

Solução: um administrador Keycloak deve atribuir funções à sua conta:

  1. Abra o Keycloak Admin Console.
  2. Vá em Users → selecione sua conta → Role Mappings.
  3. Sob o cliente OpSee, atribua as funções apropriadas (ex.: menu:production, menu:oee, menu:admin).
  4. Peça ao usuário para fazer logout e login novamente para que as novas funções tenham efeito.

Keycloak está inacessível​

Se a página de login não carregar, ou se o navegador exibir um erro de conexão ao tentar alcançar o Keycloak, o contêiner Docker do Keycloak pode ter parado.

Solução:

  1. Acesse o servidor via SSH e execute docker ps para ver quais contêineres estão em execução.
  2. Se o contêiner Keycloak não estiver listado ou exibir status Exited, reinicie-o: docker compose up -d keycloak.
  3. Verifique os logs do contêiner Keycloak em busca de erros de inicialização: docker compose -f infra/docker-compose.yml logs keycloak.
  4. Aguarde o Keycloak iniciar completamente (pode levar de 30 a 60 segundos) antes de tentar fazer login novamente.

Loop de redirecionamento​

Se o navegador continuar alternando entre o aplicativo OpSee e a página de login do Keycloak sem nunca se estabilizar, provavelmente há uma configuração incorreta no OAuth2 Proxy ou nas configurações do cliente Keycloak.

Possíveis causas:

  • A URI de redirecionamento registrada no cliente Keycloak não corresponde ao URL real do aplicativo.
  • O segredo do cookie do OAuth2 Proxy foi alterado ou está ausente.
  • A variável de ambiente SERVER_DOMAIN não corresponde ao domínio que o navegador está utilizando.

Solução: entre em contato com seu administrador de infraestrutura. Esse tipo de problema requer acesso à configuração do Docker Compose e ao console de administração do Keycloak para corrigir as configurações do cliente.