Aller au contenu

Résoudre les problèmes de page de connexion

Page de connexion sans style, publication qui dure, Keycloak injoignable, thème refusé à l'import - causes et solutions.

DépannageAdministrateurDéveloppeur
Voir en Markdown

Cette page couvre ce que vous pouvez constater en testant votre thème de connexion ou en suivant sa publication dans la console.

Symptômes

Page sans style

Cause : theme.properties déclare styles= avec votre seule feuille de style. Cette propriété remplace la liste du thème parent.

Solution : recopiez la liste styles du thème parent, ajoutez votre fichier à la fin, puis faites publier une nouvelle version.

Publication longue

Cause : Keycloak redémarre pour charger la nouvelle version. Un redémarrage prend en général 1 à 3 minutes, parfois davantage.

Solution : entre 5 et 15 minutes, attendez : l'application se fait toute seule. Au-delà de 15 minutes, contactez l'équipe Wakastart en donnant le nom du thème, l'environnement et l'heure de début affichés dans le message.

Keycloak injoignable

Cause : la console ne parvient pas à lire l'état de l'instance Keycloak de l'environnement. Les états s'affichent en État inconnu.

Solution : réessayez dans quelques minutes. Un état inconnu ne signifie pas que le thème a été retiré.

Ancienne page affichée

Cause possible 1 : la publication n'est pas terminée. Vérifiez qu'aucun bandeau de publication n'est affiché pour l'environnement.

Cause possible 2 : votre navigateur garde en cache les feuilles de style de la page précédente.

Pour vérifier : ouvrez la page de connexion dans une fenêtre de navigation privée. Si vous avez ajouté un bandeau de test, il indique la version servie.

Thème refusé

Cause : le thème ne respecte pas la structure ou les limites attendues. Le message transmis par l'équipe Wakastart indique laquelle.

Solution : retrouvez le message dans la liste des messages d'erreur à l'import, corrigez le dossier, poussez la correction, puis redemandez l'import.

Version absente d'un environnement

La liste Thèmes de l'app de staging ou de prod ne contient pas la version que vous voyez en dev, ou l'application est refusée avec « Cette version n'existe pas dans la bibliothèque … ».

Cause : chaque environnement a sa propre bibliothèque. Une version ajoutée en dev n'existe pas ailleurs. C'est aussi le cas, en dev et en staging, des versions antérieures à la mise en place des bibliothèques par environnement : seule la bibliothèque de prod a été reprise.

Solution : demandez à Wakastart d'ajouter la version dans la bibliothèque de l'environnement concerné, depuis la même source que pour dev, puis de l'y appliquer.

Pour vérifier : après avoir choisi l'environnement, la version figure dans Thèmes de l'app avec le même nom qu'en dev.

Toujours bloqué ?

Rassemblez le WID de l'application, le nom de la version, l'environnement et l'heure de l'essai, puis contactez le support Wakastart.