Vérifier les messages d’erreur

Recherchez les messages d’erreur affichés dans l’un des emplacements suivants :

  • Navigateurs et réponses des pages HTML

  • Onglets du réseau et de la console des outils de développement

  • Réponses du serveur d’autorisation

  • Erreurs d’obsolescence

Vérifier les erreurs du navigateur

Un fichier HAR est un journal au format JSON des interactions d’un navigateur Web avec un serveur Web. Si l’authentification ne fonctionne pas comme prévu, vous pouvez générer et analyser des fichiers HAR pour trouver des problèmes.

Vérifier l’écran de connexion

Le gadget logiciel de connexion Lock affiche des messages d’erreur pour certains types de problèmes, tels qu’un nom d’utilisateur ou un mot de passe incorrect. Vérifiez le lien Plus d’informations si vous utilisez la page d’erreur standard d’Auth0.

Vérifier les journaux

Auth0 stocke les données du journal, notamment les actions d’administration du Dashboard, les authentifications réussies et échouées des utilisateurs, ainsi que les demandes de changement de mot de passe. Vous pouvez consulter les journaux dans le Dashboard.

Certains types d’erreurs n’apparaissent pas dans les journaux. Par exemple, si une erreur se produit sur un Fournisseur d’identité distant, où l’authentification n’est pas terminée et l’utilisateur n’est jamais renvoyé à Auth0, il n’y aura aucune entrée dans les journaux.

Vous pouvez exporter les journaux Auth0 et les stocker vous-même ou les envoyer automatiquement vers des services de journaux externes. Cette fonctionnalité peut vous aider à répondre aux exigences de conservation des données, ainsi qu’aux exigences d’analyse des journaux. Vous pouvez installer et configurer une extension Auth0 pour exporter automatiquement les journaux vers un autre fournisseur comme Sumo Logic ou Loggly. Pour en savoir plus, accédez à nos solutions de streaming de journaux sur Auth0 Marketplace.

Vous pouvez également utiliser le Management API pour exporter les journaux et les stocker. Il existe deux points de terminaison disponibles, chacun fournissant des informations légèrement différentes.

Point de terminaison /get_logs pour rechercher dans tous les journaux

Le point de terminaison Rechercher les événements de journaux permet de récupérer les entrées de journal qui correspondent aux critères de recherche que vous avez fournis. Si vous ne fournissez aucun critère de recherche, vous obtiendrez une liste de toutes les entrées disponibles.

Vous pouvez fournir des critères de recherche en utilisant le paramètre q et récupérer des champs spécifiques à l’aide du paramètre fields.

Pour accéder à l’API, vous avez besoin d’un jeton d’accès à Management APIv2.

Cet exemple de requête récupère tous les journaux des connexions réussies (l’acronyme d’événement pour une connexion réussie est s). La liste des champs que nous récupérerons par entrée de journal est : date, description, client_id, et log_id.

Pour plus de détails sur les critères de recherche que vous pouvez utiliser et une liste avec les acronymes d’événements, veuillez consulter le Point de terminaison Rechercher les événements de journaux.

Point de terminaison /get_logs_by_id pour obtenir une seule entrée de journal

Le point de terminaison Obtenir un événement de journal par ID récupère l’entrée de journal associée avec l’ID fourni.

Cet exemple de requête récupère une seule entrée de journal avec l’ID 90020180129170850881585554625888895190928456277777449010.

Vérifier les journaux pour des erreurs d’obsolescence

En cas de fonctionnalités d’Auth0 devenues obsolètes, il peut y avoir des erreurs ou des avis dans les journaux des locataires qui s’affichent pour indiquer que vos applications utilisent des fonctionnalités obsolètes. Vous pouvez rechercher dans les journaux des entrées d’obsolescence spécifiques qui peuvent indiquer qu’une fonctionnalité est obsolète.

Limites d’utilisation et autres erreurs

Auth0 fournit un code d’erreur unique pour les erreurs signalées lorsque la limite d’utilisation est dépassée. Vous devriez configurer l’analyse automatique des journaux pour vérifier les erreurs de limite d’utilisation afin de pouvoir traiter de manière proactive les activités qui dépassent ces limites avant qu’elles ne gênent trop vos utilisateurs. Auth0 publie également des codes d’erreur pour d’autres types d’erreurs. Il vous sera donc utile de rechercher dans les journaux les erreurs d’authentification ainsi que les erreurs liées aux appels vers Management API (les codes d’erreur de Management API sont affichés sous chaque appel dans l’Explorateur Management API).

Veuillez noter également que l’appel à Management API pour récupérer des informations sur le profil utilisateur à partir d’une Règle est une cause fréquente d’erreurs de limite d’utilisation, car ces appels API peuvent être exécutés pour chaque connexion ainsi que pour des vérifications périodiques de la session

Vérifiez la console d’erreur des journaux Realtime WebTask

Vous pouvez insérer des instructions console.log() dans les actions et les scripts de base de données personnalisés. Les résultats de ces instructions seront visibles en temps réel dans le journal Web.

En savoir plus