Aller au contenu principal

Problèmes de connexion

Mot de passe oublié​

OpSee délègue complètement l'authentification à Keycloak. Les réinitialisations de mot de passe doivent passer par Keycloak :

  • Si le lien « Mot de passe oublié » s'affiche sur la page de connexion, cliquez dessus et suivez le flux de réinitialisation par email. Cela nécessite un serveur de courrier configuré dans Keycloak.
  • Si aucun lien de réinitialisation n'apparaît, un administrateur Keycloak doit réinitialiser manuellement votre mot de passe : Console d'administration Keycloak → Utilisateurs → sélectionnez votre compte → Identifiants → Réinitialiser le mot de passe.

Session expirée​

Les jetons OAuth2 ont une durée de vie limitée. Lorsque votre session expire, les demandes API renvoient 401 et l'interface peut vous rediriger vers la page de connexion sans avertissement.

Correction : Déconnectez-vous explicitement en utilisant le menu avatar (en haut à droite), puis reconnectez-vous. Fermer et rouvrir l'onglet du navigateur sans d'abord se déconnecter peut également résoudre une session obsolète.

401 sur chaque page après connexion​

Si vous êtes redirigé vers la page de connexion, authentifiez-vous avec succès et voyez ensuite immédiatement des erreurs 401 à nouveau, le jeton stocké dans votre navigateur peut être corrompu.

Correction :

  1. Ouvrez les outils de développement du navigateur → Application → Cookies. Supprimez tous les cookies pour le domaine OpSee.
  2. Ouvrez le stockage local (Local Storage) et supprimez toutes les entrées pour le domaine OpSee.
  3. Fermez l'onglet, rouvrez-le et reconnectez-vous.

403 après connexion (vous pouvez vous connecter mais ne pouvez rien consulter)​

Une erreur 403 immédiatement après une connexion Keycloak réussie signifie que le compte existe et s'est authentifié correctement, mais n'a aucun rôle assigné dans OpSee.

Correction : Un administrateur Keycloak doit assigner des rôles à votre compte :

  1. Ouvrez la Console d'administration Keycloak.
  2. Accédez à Utilisateurs → sélectionnez votre compte → Correspondance des rôles.
  3. Sous le client OpSee, assignez les rôles appropriés (par exemple menu:production, menu:oee, menu:admin).
  4. Demandez à l'utilisateur de se déconnecter et de se reconnecter pour que les nouveaux rôles prennent effet.

Keycloak est inaccessible​

Si la page de connexion elle-même ne charge pas, ou si le navigateur affiche une erreur de connexion en essayant d'atteindre Keycloak, le conteneur Docker Keycloak peut s'être arrêté.

Correction :

  1. Connectez-vous via SSH au serveur et exécutez docker ps pour voir quels conteneurs s'exécutent.
  2. Si le conteneur Keycloak n'est pas listé ou affiche le statut Exited, redémarrez-le : docker compose up -d keycloak.
  3. Vérifiez les journaux des conteneurs Keycloak pour les erreurs de démarrage : docker compose -f infra/docker-compose.yml logs keycloak.
  4. Attendez que Keycloak démarre complètement (cela peut prendre 30 à 60 secondes) avant d'essayer de vous reconnecter.

Boucle de redirection​

Si le navigateur continue de rebondir entre l'application OpSee et la page de connexion Keycloak sans jamais se stabiliser, il y a probablement une mauvaise configuration dans le proxy OAuth2 ou les paramètres du client Keycloak.

Causes possibles :

  • L'URI de redirection enregistré dans le client Keycloak ne correspond pas à l'URL réelle de l'application.
  • Le secret du cookie du proxy OAuth2 a changé ou est absent.
  • La variable d'environnement SERVER_DOMAIN ne correspond pas au domaine utilisé par le navigateur.

Correction : Contactez votre administrateur d'infrastructure. Ce type de problème nécessite un accès à la configuration Docker Compose et à la console d'administration Keycloak pour corriger les paramètres du client.