Passer au contenu principal
Auth0 vous permet d’ajouter l’authentification à presque tous les types d’applications. Ce guide explique comment intégrer Auth0, ajouter l’authentification et afficher les informations de profil utilisateur dans n’importe quelle application Vue à l’aide de la trousse SDK Vue Auth0.
Ce guide rapide est conçu pour l’utilisation de Vue Auth0 avec des applications Vue 3. Si vous utilisez Vue 2, veuillez plutôt consulter le tutoriel Vue 2 avec la trousse SDK Auth0 SPA ou le guide Vue.js Authentication 2 By Example.
Pour utiliser ce guide rapide, vous aurez besoin de :
  • Un compte Auth0 gratuit ou une connexion à Auth0.
  • Un projet Vue fonctionnel avec lequel vous souhaitez vous intégrer OU vous pouvez télécharger un exemple d’application après vous être connecté.
    1

    Configuration d’Auth0

    Pour utiliser les services Auth0, vous devez avoir une application installée dans Auth0 Dashboard. L’application Auth0 est l’endroit où vous allez configurer le fonctionnement de l’authentification pour le projet que vous développez.

    ​
    Configurer une application

    Utilisez le sélecteur interactif pour créer une nouvelle application Auth0 ou sélectionner une application existante qui représente le projet avec lequel vous souhaitez effectuer l’intégration. Dans Auth0, il est attribué à chaque application un identifiant client unique alphanumérique que votre code d’application utilisera pour appeler les API Auth0 via la trousse SDK.Tous les paramètres que vous configurez à l’aide de ce guide rapide seront automatiquement mis à jour pour votre application dans le Dashboard, qui est l’endroit où vous pourrez gérer vos applications à l’avenir.Si vous préférez explorer une configuration complète, consultez plutôt un exemple d’application.

    ​
    Configuration des URL de rappel

    Une URL de rappel est une URL intégrée dans votre application vers laquelle vous souhaitez qu’Auth0 redirige les utilisateurs après leur authentification. Si elle n’est pas définie, les utilisateurs ne seront pas redirigés vers votre application après s’être connectés.
    Si vous suivez notre projet à titre d’exemple, définissez ceci sur http://localhost:3000.

    ​
    Configuration des URL de déconnexion

    Une URL de déconnexion est une URL intégrée dans votre application vers laquelle vous souhaitez qu’Auth0 redirige les utilisateurs après leur déconnexion. Si elle n’est pas définie, les utilisateurs ne pourront pas se déconnecter de votre application et recevront un message d’erreur.
    Si vous suivez notre projet à titre d’exemple, définissez ceci sur http://localhost:3000.

    ​
    Configurer les origines Web autorisées

    Une origine Web autorisée est une URL que vous souhaitez autoriser à accéder à votre flux d’authentification. Elle doit contenir l’URL de votre projet. Si elle n’est pas configurée adéquatement, votre projet ne pourra pas actualiser silencieusement les jetons d’authentification, ce qui entraînera la déconnexion de vos utilisateurs lorsque prochainement ils visiteront votre application ou lors de l’actualisation d’une page.
    Si vous suivez notre projet à titre d’exemple, définissez ceci sur http://localhost:3000.
    2

    Installer la trousse SDK Auth0 Vue

    Auth0 propose une trousse SDK Vue pour simplifier le processus d’implémentation de l’authentification et de l’autorisation Auth0 dans les applications Vue 3.Installez la trousse SDK Auth0 Vue en exécutant les commandes suivantes dans votre terminal :
    cd <your-project-directory>
npm install @auth0/auth0-vue

    ​
    Enregistrer le plugiciel

    Pour que la trousse SDK fonctionne, vous devez enregistrer le plugiciel dans votre application Vue à l’aide des propriétés suivantes :
    • domain : Le domaine de votre locataire Auth0. Cette valeur se trouve dans Auth0 Dashboard dans les Settings (Paramètres) de votre application dans le champ Domain (Domaine). Si vous utilisez un domaine personnalisé, définissez-le plutôt sur la valeur de votre domaine personnalisé.
    • clientId : L’identifiant de l’application Auth0 que vous avez configurée précédemment dans le démarrage rapide. Vous le trouverez dans Auth0 Dashboard sous les paramètres de votre application dans le champ Client ID (Identifiant client).
    • authorizationParams.redirect_uri : L’URL dans votre application vers laquelle vous souhaitez qu’Auth0 redirige les utilisateurs après leur authentification. Cela correspond à l’URL de rappel que vous avez configurée précédemment dans ce démarrage rapide. Cette valeur se trouve dans Auth0 Dashboard, dans les Paramètres de votre application, dans le champ URL de rappel. Assurez-vous que ce que vous saisissez dans votre code correspond à ce que vous avez configuré précédemment, au cas contraire, vos utilisateurs verront une erreur.
    Le plugiciel enregistrera la trousse SDK en utilisant à la fois provide et app.config.globalProperties. Cela permet d’activer à la fois l’API de composition et l’API d’options.
    Point de contrôle
    Le plugiciel est maintenant configuré. Exécutez votre application pour vérifier que: la trousse SDK est correctement initialisée, votre application ne génère aucune erreur liée à Auth0.
    3

    Ajouter une fonctionnalité de connexion à votre application

    Vous allez ensuite configurer une connexion pour votre projet. Vous utiliserez la fonction loginWithRedirect de la trousse SDK exposée à la valeur de retour de useAuth0, à laquelle vous pouvez accéder dans la fonction de configuration de votre composant. Elle redirigera les utilisateurs vers la page de connexion universelle Auth0 et, après l’authentification de l’utilisateur, elle le redirigera vers l’URL de rappel que vous avez configurée plus tôt dans ce guide rapide.

    ​
    Utilisation d’Options API

    Si vous utilisez Options API, vous pouvez utiliser la même méthode loginWithRedirect à partir de la propriété globale $auth0 via l’accesseur this.
    Point de contrôle
    Vous devriez maintenant être en mesure de vous connecter en utilisant la connexion universelle Auth0.Appuyez sur le bouton de connexion et vérifiez que:
    • Votre application Vue vous redirige vers la page de connexion universelle Auth0.
    • Vous pouvez vous connecter ou vous inscrire.
    • Auth0 vous redirige vers votre application en utilisant la valeur authorizationParams.redirect\_uri que vous avez utilisée pour configurer le plugiciel.
    4

    Ajouter une fonctionnalité de déconnexion à votre application

    Les utilisateurs qui se connectent à votre projet auront également besoin d’un moyen de se déconnecter. Quand les utilisateurs se déconnectent, votre application les redirige vers votre point de terminaison Déconnexion Auth0, qui les redirige ensuite vers le paramètre logoutParams.returnTo indiqué.Utilisez la fonction logout exposée sur la valeur de retour useAuth0, à laquelle vous pouvez accéder dans la fonction setup de votre composant, pour déconnecter l’utilisateur de votre application.

    ​
    Utilisation d’Options API

    Avec l’Options API, vous pouvez utiliser la même méthode logout à partir de la propriété globale $auth0 via l’accesseur this.
    Point de contrôle
    Exécutez votre application et cliquez sur le bouton de déconnexion, vérifiez que:
    • votre application Vue vous redirige vers l’adresse logoutParams.returnTo ,
    • vous n’êtes plus connecté à votre application.
    5

    Afficher les informations du profil utilisateur

    Vous allez ensuite configurer la manière de récupérer les informations de profil associées aux utilisateurs authentifiés. Par exemple, vous voudrez peut-être pouvoir afficher le nom ou la photo de profil d’un utilisateur connecté dans votre projet. Une fois l’utilisateur authentifié, la trousse SDK extrait les informations du profil utilisateur et les stocke en mémoire. L’application peut accéder au profil utilisateur à l’aide de la propriété réactive user. Pour accéder à cette propriété, examinez la fonction setup de votre composant et trouvez la valeur de retour de userAuth0.La propriété user contient des informations sensibles relatives à l’identité de l’utilisateur. Elle n’est disponible qu’en fonction de l’état d’authentification de l’utilisateur. Pour éviter les erreurs de rendu, vous devez toujours :
    • utiliser la propriété isAuthenticated pour déterminer si Auth0 a authentifié l’utilisateur avant que Vue ne rende un composant qui consomme la propriété user.
    • vous assurer que la trousse SDK a fini de se charger en vérifiant que isLoading est false avant d’accéder à la propriété isAuthenticated.

    ​
    Utilisation de l’API Options

    Pour l’API Options, utilisez les mêmes propriétés réactives user, isLoading et isAuthenticated de la propriété globale $auth0 via l’accesseur this.
    Point de contrôle
    Vérifiez que:
    • vous pouvez afficher user ou l’une des propriétés de l’utilisateur correctement dans un composant, après vous être connecté.

​
Étapes suivantes

Beau travail! Si vous en êtes arrivé là, vous devriez avoir la connexion, la déconnexion et les informations de profil utilisateur actives dans votre application.Cela conclut notre tutoriel de démarrage rapide, mais il y a tellement plus à explorer. Pour en savoir plus sur ce que vous pouvez faire avec Auth0, consultez :
  • Auth0 Dashboard : apprenez à configurer et gérer votre locataire et vos applications Auth0
  • Trousse SDK auth0-spa-js : explorez en détail la trousse SDK utilisée dans ce tutoriel
  • Auth0 Marketplace : découvrez des intégrations que vous pouvez activer pour étendre les fonctionnalités d’Auth0
⌘I