Préparation au soutien (commerce B2B)

Lorsque vous commencez à préparer votre lancement, assurez-vous de lire les Politiques Auth0 et de préparer vos opérations de production selon les délais ou les responsabilités requis de votre part, conformément aux politiques.

Vous devez examiner les détails du plan de soutien acheté et les contrats SLA y étant associés, pour vous assurer qu’il répond à vos besoins. Si ce n’est pas déjà fait, explorez le centre de soutien et familiarisez-vous avec les fonctionnalités de soutien telles que l’affichage des solutions suggérées aux problèmes courants, le dépôt des billets et l’affichage de votre utilisation du quota. Il sera utile de revoir les définitions du niveau de gravité pour les billets de soutien afin de pouvoir les déposer avec la gravité correcte. Une remarque importante est qu’il n’est pas possible à ce jour dans le centre de soutien d’augmenter la gravité d’un billet de soutien. Si vous déposez un billet pour un problème de niveau moyen qui devient plus tard un problème de gravité élevée, vous devez en déposer un nouveau urgent de gravité élevée qui explique tout ce qui déclenche l’urgence et qui fait référence au billet d’origine pour plus de détails.

Vous devez également vous assurer que vos équipes de développement et de soutien connaissent le forum de la communauté Auth0, abordé plus en détail ci-dessous. Les clients peuvent souvent y trouver immédiatement des réponses aux problèmes courants, évitant ainsi d’avoir à déposer un billet. Cela devrait donc être votre premier arrêt pour les questions techniques.

Le forum de la communauté Auth0 est une mine d'informations. Si vous avez une question, il est probable que quelqu’un d’autre l’ait déjà posée sur le forum. Les réponses sont fournies à la fois par le personnel d’Auth0 et par la communauté plus grande des utilisateurs d’Auth0.

Des avis importants y sont publiés pour vous aider à rester au courant des nouvelles importantes. Assurez-vous de consulter les catégories « Communauté » et « FAQ ». La catégorie Communauté contient des publications proactives sur les annonces de produits, des informations concernant la feuille de route, des vidéos pratiques ainsi que des informations importantes sur toute dépréciation de fonctionnalités à venir.

Il est recommandé de consulter régulièrement la communauté Auth0, pas seulement lorsque vous avez des questions. Du même coup, si vous voyez une question dont vous avez la réponse, partagez votre sagesse pour aider les autres!

Nous recommandons à votre équipe de soutien de se familiariser avec nos guides de dépannage propres aux protocoles d’identité et à Auth0. Cela inclut les questions à rechercher et les informations à collecter avant de publier une question sur le forum Auth0 ou de déposer un billet de soutien. Les transactions d’authentification s’étendent souvent sur plusieurs systèmes. Il existe donc des techniques de dépannage spécialisées qu’il est utile d’apprendre.

Votre équipe aura sans doute déjà effectué quelques dépannages lors du développement de votre application, mais nous vous recommandons de vous assurer que votre équipe de soutien connaît aussi tous les outils ci-dessous qui sont pertinents pour votre projet. Si vous devez créer un ticket, l’équipe d’assistance Auth0 peut vous demander un fichier HAR (HTTP Archive) afin de l’aider à analyser le problème. Il est donc utile que votre personnel d’assistance sache comment procéder.

Un fichier HAR saisit une séquence d’interactions avec le navigateur et est un outil couramment utilisé lors du débogage des problèmes d’authentification. Le processus d’authentification d’un utilisateur implique souvent de rediriger le navigateur de l’utilisateur depuis une application vers Auth0, et éventuellement vers un autre fournisseur d’identité, selon le type de connexion utilisé. Vous pouvez saisir la redirection et les réponses et les analyser pour trouver des indices sur la cause d’un problème.

Analysez le fichier HAR pour obtenir de précieuses informations de dépannage. Il affiche la séquence de redirections du navigateur impliquée dans une transaction d’authentification, ainsi que les paramètres utilisés. Le fichier HAR indique également si le processus d’authentification s’est arrêté en cours de route et si oui, à quel moment, ce qui permet d’identifier l’emplacement du problème. Le fichier HAR contient des jetons renvoyés à l’application frontale, et ceux-ci peuvent être collés dans les afficheurs appropriés pour voir s’ils contiennent le contenu attendu.

L’outil jwt.io a été écrit par Auth0 et vous permet d’afficher le contenu d’un jeton au format JWT. Les applications qui délèguent l’authentification à Auth0 par le biais d’OIDC recevront un jeton d’ID d’Auth0. Selon votre type d’application, le jeton d’ID peut être saisit dans un fichier HAR. Le jeton d’ID est en format JWT et peut être collé dans jwt.io pour afficher son contenu.

Il existe de nombreux décodeurs SAML disponibles. Le décodeur samltool.io a été écrit par Auth0 et vous permet d’afficher le contenu d’une demande ou d’une réponse SAML. Les applications qui délèguent l’authentification à Auth0 via SAML ou utilisent un type de connexion SAML dans Auth0 utiliseront les demandes et les réponses SAML. Ces demandes et ces réponses SAML peuvent être saisies dans un fichier HAR. Les demandes et les réponses peuvent être collées dans samltool.io ou dans d’autres décodeurs SAML pour afficher le contenu de la demande ou de la réponse SAML.

Une cause potentielle de problèmes est l’utilisation de versions obsolètes de trousse SDK ou de bibliothèques. Nous recommandons fortement à votre équipe de vérifier votre pile logicielle, vos navigateurs, vos trousses SDK et vos bibliothèques par rapport à la matrice de soutien d’Auth0 pour vous assurer d’utiliser des versions à jour et compatibles. En cas de problème, l’équipe de soutien d’Auth0 peut vous demander de passer à une version compatible. Pour éviter de ralentir la progression de la résolution des problèmes, assurez-vous d’utiliser des versions à jour.

Auth0 apprécie les commentaires et les idées des clients d’Auth0. Si vous avez une suggestion pour notre équipe des produits, vous pouvez soumettre des commentaires directement sur le Portail de commentaires sur les produits.

Pour déboguer et soutenir le code personnalisé dans Auth0, y compris les actions, les règles, les hooks, les scripts de base de données personnalisés et les connexions OAuth personnalisées, la connaissance du Journal des tâches Web en temps réel est essentielle. Cela vous permet d’afficher le résultat de votre code personnalisé, y compris celui des états console.log.

Nous vous recommandons d’installer l’extension de journal des tâches Web en temps réel et de vous familiariser avec son utilisation pour afficher le résultat du journal de votre code personnalisé en tant qu’outil de débogage et de soutien.

Vous devez vous préparer à résoudre les problèmes de base à la fois pendant votre développement et après la mise en ligne de votre application ou de votre API. Assurez-vous que vos équipes de développement et de soutien connaissent les outils de dépannage et la liste des problèmes courants à vérifier lors du dépannage d’un problème.

Nous fournissons un guide de planification en format PDF que vous pouvez télécharger; vous pouvez vous y référer pour de plus amples détails concernant nos stratégies recommandées.