> ## Documentation Index
> Fetch the complete documentation index at: https://auth0.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

> [!WARNING]
>
> **La fonctionnalité Auth0 Universal Portals est en .**

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](https://auth0.com/docs/fr-ca/customize/portals/configure-portal-application.md).

Consultez d’abord le [journal](https://auth0.com/docs/fr-ca/deploy-monitor/logs.md) 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.

> [accordion] 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](https://auth0.com/docs/fr-ca/authenticate/single-sign-on), 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](https://auth0.com/docs/fr-ca/customize/portals/architecture.md#sessions-and-token-lifetimes).

> [accordion] 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](https://auth0.com/docs/fr-ca/authenticate/single-sign-on/native-to-web). 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](https://auth0.com/docs/fr-ca/secure/tokens/refresh-tokens) 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](https://auth0.com/docs/fr-ca/customize/portals/access-portals.md#open-a-portal-from-a-native-application).

> [accordion] 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**](https://auth0.com/docs/fr-ca/get-started/applications/application-settings.md#application-uris) 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.

> [accordion] 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**](https://auth0.com/docs/fr-ca/get-started/applications/set-up-database-connections.md). Activez au moins une des connexions dont vos utilisateurs ont besoin. Si vous utilisez les [Organisations](https://auth0.com/docs/fr-ca/manage-users/organizations.md), 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](https://auth0.com/docs/fr-ca/customize/portals/configure-portal-application.md#validate-enabled-connections).

## Organisations

Pour les [Auth0 Organizations](https://auth0.com/docs/fr-ca/manage-users/organizations.md) dans les portails d'entreprise, suivez les conseils de dépannage recommandés ci-dessous.

> [accordion] 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](https://auth0.com/docs/fr-ca/manage-users/my-organization-api.md) agit sur une Organization.
>
> **Solution** : ajoutez `organization` à l'URL du portail. Pour en savoir plus, consultez [Ouvrir un portail dans un contexte d'Organization](https://auth0.com/docs/fr-ca/customize/portals/access-portals.md#open-a-portal-in-an-organization-context).

> [accordion] 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](https://auth0.com/docs/fr-ca/customize/portals/configure-portal-application.md#organization-context).

> [accordion] 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](https://auth0.com/docs/fr-ca/manage-users/my-organization-api.md).

> [accordion] 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](https://auth0.com/docs/fr-ca/manage-users/organizations/configure-organizations/create-organizations.md) 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.

> [accordion] Un composant affiche « We couldn't load this information »
>
> **Cause possible** : il manque à l’application de portail une [autorisation client](https://auth0.com/docs/fr-ca/get-started/applications/application-access-to-apis-client-grants.md) ou une politique de [jeton d’actualisation](https://auth0.com/docs/fr-ca/secure/tokens/refresh-tokens) pour le [serveur de ressources](https://auth0.com/docs/fr-ca/get-started/apis) 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](https://auth0.com/docs/fr-ca/manage-users/my-account-api.md) ou l’[API My Organization](https://auth0.com/docs/fr-ca/manage-users/my-organization-api.md), 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](https://auth0.com/docs/fr-ca/customize/portals/portal-components.md#universal-components).

> [accordion] Les composants échouent par intermittence en utilisation normale
>
> **Cause possible** : la [rotation des jetons d’actualisation](https://auth0.com/docs/fr-ca/secure/tokens/refresh-tokens/refresh-token-rotation) 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](https://auth0.com/docs/fr-ca/customize/portals/configure-portal-application.md#settings-you-must-not-change).

> [accordion] 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](https://auth0.com/docs/fr-ca/manage-users/my-account-api.md) ou l’[API My Organization](https://auth0.com/docs/fr-ca/manage-users/my-organization-api.md) 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](https://auth0.com/docs/fr-ca/get-started/applications/application-access-to-apis-client-grants.md) pour le [serveur de ressources](https://auth0.com/docs/fr-ca/get-started/apis). Pour en savoir plus, consultez [Serveurs de ressources autorisés](https://auth0.com/docs/fr-ca/customize/portals/architecture.md#allowed-resource-servers).

> [accordion] 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](https://auth0.com/docs/fr-ca/customize/portals/architecture.md#step-up-authentication).

> [accordion] Un composant affiche « Too many requests »
>
> **Cause possible** : la limite anti-attaques de l’[API My Account](https://auth0.com/docs/fr-ca/manage-users/my-account-api.md) a été atteinte par les requêtes de l’utilisateur.
>
> **Solution** : patientez quelques instants, puis sélectionnez le bouton Réessayer du composant.

## Forms

> [accordion] Un Form est enregistré, mais l'utilisateur n'est pas mis à jour
>
> **Cause possible** : le [flux](https://auth0.com/docs/fr-ca/customize/forms/flows.md) du Form n'a aucune connexion au [coffre-fort Forms](https://auth0.com/docs/fr-ca/customize/forms/vaults.md), 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](https://auth0.com/docs/fr-ca/get-started/auth0-overview/create-applications/machine-to-machine-apps.md) dotée des permissions requises par le flux. Pour en savoir plus, consultez [Forms qui mettent à jour les utilisateurs](https://auth0.com/docs/fr-ca/customize/portals/configure-portal-application.md#forms-that-update-users).

## Sessions et déconnexion

> [accordion] 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](https://auth0.com/docs/fr-ca/secure/tokens/refresh-tokens) 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](https://auth0.com/docs/fr-ca/customize/portals/architecture.md#sessions-and-token-lifetimes).

> [accordion] Les clés d'identification cessent de fonctionner après le passage à un domaine personnalisé
>
> **Cause possible** : Les [clés d'identification](https://auth0.com/docs/fr-ca/authenticate/database-connections/passkeys) 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é](https://auth0.com/docs/fr-ca/customize/custom-domains.md) dès le départ.

## Mise en page

> [accordion] 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](https://auth0.com/docs/fr-ca/customize/portals/access-portals.md#hide-portal-navigation-for-in-app-browsers).

## 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](https://auth0.com/docs/fr-ca/customize/portals/configure-portal-application.md). |
| **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 le problème persiste, communiquez avec Auth0 Support en précisant l'heure et le slug du portail. |

## Prochaines étapes

> [card] [Configurer une application pour les Universal Portals](https://auth0.com/docs/fr-ca/customize/portals/configure-portal-application.md)
>
> Vérifiez les paramètres d'application à l'origine de la plupart des erreurs de portail.