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
Si vos utilisateurs éprouvent des problèmes de connexion ou d’accès, consultez les conseils de dépannage suivants.Une invite de connexion s’affiche après la fin de la session du portail
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
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 Organization, la valeur
organization peut aussi différer de l’Organization 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
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
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 : Ouvrez l’application du portail dans Auth0 Dashboard et sélectionnez l’onglet Connexions. Activez au moins une des connexions dont vos utilisateurs ont besoin. Si vous utilisez les Organisations, vérifiez également que l’Organization dispose d’une connexion activée pour l’utilisateur. Pour en savoir plus, consultez Valider les connexions activées.
Organisations
Pour les Auth0 Organizations dans les portails d’entreprise, suivez les conseils de dépannage recommandés ci-dessous.Les composants d'Organization affichent une erreur ou aucune donnée
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 Organization. Or, l’API My Organization agit sur une Organization.Solution : ajoutez organization à l’URL du portail. Pour en savoir plus, consultez Ouvrir un portail dans un contexte d’Organization.L'utilisateur ne peut pas se connecter au portail avec le paramètre organization
L'utilisateur ne peut pas se connecter au portail avec le paramètre organization
Cause possible : l’utilisateur n’est pas membre de l’Organization, l’Organization 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’Organization. Assurez-vous que
organization_usage est défini à allow pour l’application. Pour en savoir plus, consultez Contexte d’Organization.Un composant d'Organization affiche une erreur après que l'utilisateur a enregistré une modification
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’Organization. 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’Organization 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
Le portail affiche l'image de marque du locataire au lieu de celle de l'Organization
Cause possible : le portail a été ouvert sans Organization, ou Auth0 n’a pas pu charger l’image de marque de l’Organization.Solution : ouvrez le portail avec
organization. Vérifiez qu’une image de marque est configurée pour l’Organization.Composants et appels d’API
Si vous rencontrez des problèmes avec les composants ou les appels d’API de Universal Portals, consultez les conseils suivants.Un composant affiche « We couldn't load this information »
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
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 »
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
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 »
Un composant affiche « Too many requests »
Cause possible : la limite anti-attaques de l’API My Account a été atteinte par les requêtes de l’utilisateur.Solution : patientez quelques instants, puis sélectionnez le bouton Réessayer du composant.
Forms
Un Form est enregistré, mais l'utilisateur n'est pas mis à jour
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
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é
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
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.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.