Dépanner les Universal Portals

Trouvez la cause et la solution des problèmes courants liés aux Universal Portals, notamment ceux touchant la connexion, les Organizations, les composants, les Forms et les sessions.

Chaque entrée décrit un symptôme, sa cause probable et la solution. La plupart des problèmes découlent des paramètres de l’application du portail. Pour les passer en revue, consultez Configurer une application pour Universal Portals.

Consultez d’abord le journal de votre locataire. Bon nombre d’erreurs, notamment celles liées à l’authentification et à l’accès au Portail, y sont consignées.

​

Connexion et accès

Une invite de connexion s’affiche après la fin de la session du portail

Cause possible : Lorsque la session du portail prend fin, l’utilisateur se reconnecte grâce à l’authentification unique, sans invite, tant que sa session Auth0 est toujours active. La page de connexion s’affiche uniquement lorsque la session Auth0 a elle aussi pris fin.

Solution : Ce comportement est normal. Pour que les utilisateurs puissent revenir sans invite pendant plus longtemps, prolongez la session Auth0 dans les paramètres de session de votre locataire. Pour en savoir plus, consultez Sessions et durées de vie des jetons.

Le jeton de transfert de session est rejeté et la page de connexion s’affiche

Cause possible : Le jeton a expiré après 60 secondes, a déjà été utilisé, ou l’application du portail n’accepte pas les jetons de transfert de session. Lorsque le portail est ouvert dans le contexte d’une Organisation, la valeur organization peut aussi différer de l’Organisation associée au jeton.

Solution : Échangez le jeton d’actualisation juste avant d’ouvrir le navigateur intégré à l’application, et n’utilisez chaque jeton qu’une seule fois. Vérifiez les paramètres session_transfer de l’application du portail. Recherchez le message « Single Sign-On failed » dans le journal de votre locataire. Pour en savoir plus, consultez Ouvrir un portail à partir d’une application native.

L’utilisateur arrive sur une page inattendue après la déconnexion

Cause possible : Après la déconnexion, Auth0 redirige l’utilisateur vers la première URL de la liste Allowed Logout URLs de l’application.

Solution : Placez en tête de liste l’URL vers laquelle les utilisateurs doivent être redirigés, par exemple celle de votre application.

L’utilisateur ne peut pas se connecter, car aucune connexion n’est activée

Cause possible : L’application du portail n’a aucune connexion activée, par exemple parce que vous avez désactivé toutes les connexions en passant la liste en revue.

Solution : Accédez à Auth0 Dashboard > Applications > Applications, sélectionnez l’application du portail, puis sélectionnez Connexions. Activez au moins une des connexions dont vos utilisateurs ont besoin. Si vous utilisez les Organisations, vérifiez également que l’Organisation dispose d’une connexion activée pour l’utilisateur. Pour en savoir plus, consultez Valider les connexions activées.

​

Organisations

Ces entrées s’appliquent aux Auth0 Organisations dans les portails d’entreprise.

Les composants d'Organization affichent une erreur ou aucune donnée

Cause possible : l’utilisateur a ouvert le portail sans le paramètre organization; la session n’est donc associée à aucune Organisation. Or, l’API My Organization agit sur une Organisation.

Solution : ajoutez organization à l’URL du portail. Pour en savoir plus, consultez Ouvrir un portail dans un contexte d’Organisation.

L'utilisateur ne peut pas se connecter au portail avec le paramètre organization

Cause possible : l’utilisateur n’est pas membre de l’Organisation, l’Organisation n’a aucune connexion activée pour l’utilisateur, ou l’application du portail n’autorise pas les Organisations.

Solution : vérifiez les membres et les connexions de l’Organisation. Assurez-vous que organization_usage est défini à allow pour l’application. Pour en savoir plus, consultez Contexte d’Organisation.

Un composant d'Organization affiche une erreur après que l'utilisateur a enregistré une modification

Cause possible : l’utilisateur n’a pas l’autorisation d’écriture pour l’Organisation. Les portails ne désactivent pas les boutons en fonction des autorisations; l’erreur n’apparaît donc qu’après la soumission.

Solution : accordez à l’utilisateur les autorisations d’Organisation requises par le composant. Pour en savoir plus, consultez API My Organization.

Le portail affiche l'image de marque du locataire au lieu de celle de l'Organization

Cause possible : le portail a été ouvert sans Organisation, ou Auth0 n’a pas pu charger l’image de marque de l’Organisation.

Solution : ouvrez le portail avec organization. Vérifiez qu’une image de marque est configurée pour l’Organisation.

​

Composants et appels d’API

Un composant affiche « We couldn't load this information »

Cause possible : il manque à l’application de portail une autorisation client ou une politique de jeton d’actualisation pour le serveur de ressources ou pour les permissions requises par le composant.

Solution : ajoutez l’autorisation client et la politique de jeton d’actualisation pour l’API My Account ou l’API My Organization, avec les permissions requises par le composant. Pour connaître ces permissions, consultez la Référence de la bibliothèque de composants de portail.

Les composants échouent par intermittence en utilisation normale

Cause possible : la rotation des jetons d’actualisation est activée dans l’application de portail. Les portails ne la prennent pas en charge.

Solution : désactivez la rotation dans l’application de portail. Pour en savoir plus, consultez Paramètres à ne pas modifier.

Une requête échoue avec une erreur 403 et le message « This audience is not allowed »

Cause possible : une requête a demandé un public autre que l’API My Account ou l’API My Organization de votre locataire.

Solution : les composants appellent uniquement l’API My Account et l’API My Organization. Vérifiez que l’application de portail dispose d’une autorisation client pour le serveur de ressources. Pour en savoir plus, consultez Serveurs de ressources autorisés.

Le défi d’authentification multifacteur (MFA) n’apparaît pas lorsque l’utilisateur supprime un authentifiant

Cause possible : le défi s’ouvre dans une fenêtre contextuelle que le navigateur a bloquée.

Solution : autorisez les fenêtres contextuelles pour le domaine du portail, puis réessayez. Pour en savoir plus, consultez Authentification renforcée.

Un composant affiche « Too many requests »

Cause possible : l’utilisateur a envoyé trop de requêtes et une limite anti-attaques a été atteinte. En plus des limites anti-attaques de Universal Portals, les composants sont comptabilisés dans les limites anti-attaques des serveurs de ressources qu’ils appellent, comme l’API My Account. Un utilisateur peut ouvrir un portail et tout de même atteindre une limite après des requêtes répétées d’un composant.

Solution : patientez quelques instants, puis sélectionnez le bouton Réessayer du composant. Pour en savoir plus, consultez Limites anti-attaques.

​

Forms

Un Form est enregistré, mais l'utilisateur n'est pas mis à jour

Cause possible : le flux du Form n’a aucune connexion au coffre-fort Forms, ou l’application associée à la connexion ne dispose pas des permissions nécessaires pour mettre à jour les utilisateurs.

Solution : créez une connexion au coffre-fort qui s’appuie sur une application de communication entre machines dotée des permissions requises par le flux. Pour en savoir plus, consultez Forms qui mettent à jour les utilisateurs.

​

Sessions et déconnexion

Les composants échouent après que l’utilisateur s’est déconnecté d’une autre application

Cause possible : La déconnexion met fin à la session Auth0 de l’utilisateur et invalide le jeton d’actualisation que le portail utilise pour générer des jetons d’accès. Le témoin de session du portail demeure valide jusqu’à son expiration; le portail peut donc rester ouvert alors que ses composants échouent.

Solution : Demandez à l’utilisateur de se déconnecter du portail, puis de l’ouvrir de nouveau. Pour en savoir plus, consultez Sessions et durées de vie des jetons.

Les clés d'identification cessent de fonctionner après le passage à un domaine personnalisé

Cause possible : Les clés d’identification sont liées au domaine sur lequel l’utilisateur les a inscrites.

Solution : Les utilisateurs doivent inscrire de nouveau leurs clés d’identification sur le nouveau domaine. Pour éviter cette situation, utilisez un domaine personnalisé dès le départ.

​

Mise en page

Les paramètres de masquage n'ont aucun effet

Cause possible : le nom ou la valeur du paramètre est incorrect. Le portail accepte uniquement hide_sidebar=true, hide_topbar=true et hide_user_menu=true.

Solution : utilisez les noms exacts et la valeur true. Pour en savoir plus, consultez Masquer la navigation du portail dans les navigateurs intégrés aux applications.

​

Pages d’erreur

Lorsqu’une requête échoue avant le chargement du portail, le navigateur affiche une page d’erreur indiquant un code d’état HTTP et un message.

État	Message	Signification	Solution
401	Unauthorized	La requête ne comporte aucune session de portail valide.	Ouvrez de nouveau l’URL du portail et connectez-vous.
403	Forbidden	Le portail a refusé la requête.	Vérifiez la configuration de l’application du portail. Pour en savoir plus, consultez Configurer une application pour les Universal Portals.
404	Portail not found	Aucun portail ne correspond à ce slug sur ce domaine.	Vérifiez le slug et le domaine dans l’URL du portail.
404	Page not found	Le portail ne contient aucune page correspondant à ce slug.	Vérifiez le slug de la page ainsi que la page par défaut du portail.
500	Internal server error	Le portail n’a pas pu traiter la requête.	Réessayez. Si l’erreur persiste, communiquez avec Auth0 Support en précisant l’heure et le slug du portail.

​

Prochaines étapes

Configurer une application pour les Universal Portals

Vérifiez les paramètres d’application à l’origine de la plupart des erreurs de portail.