Ajouter l’authentification à votre application Nuxt.js

Ce guide explique comment intégrer Auth0, ajouter l’authentification et afficher les renseignements du profil de l’utilisateur dans une application à page unique (SPA) qui utilise Nuxt.js, à l’aide du SDK Auth0 Nuxt.js.

Ce guide de démarrage rapide est actuellement en bêta. Nous aimerions connaître votre avis!

Utiliser l’IA pour intégrer Auth0

Si vous utilisez un assistant de programmation IA comme Claude Code, Cursor ou GitHub Copilot, vous pouvez ajouter l’authentification Auth0 automatiquement en quelques minutes à l’aide des agent skills.

Installer :

npx skills add https://github.com/auth0/agent-skills --skill auth0-nuxt

Ensuite, demandez à votre assistant d’IA :

Add Auth0 authentication to my Nuxt app

Votre assistant d’IA créera automatiquement votre application Auth0, récupérera les identifiants, installera @auth0/auth0-nuxt, configurera le module et mettra en place vos routes. Documentation complète sur les agent skills →

Prérequis : Avant de commencer, assurez-vous d’avoir installé ce qui suit :

• Node.js 20 LTS ou une version ultérieure
• npm 10+ ou yarn 1.22+ ou pnpm 8+
• jq - Requis pour configurer Auth0 CLI

Compatibilité des versions de Nuxt : Ce guide de démarrage rapide fonctionne avec Nuxt 3.x sans configuration supplémentaire. Pour Nuxt 4.x, assurez-vous d’utiliser Nuxt 4.2+.

​

Pour commencer

Ce guide de démarrage rapide explique comment ajouter l’authentification Auth0 à une application Nuxt.js. Vous créerez une application monopage sécurisée avec des fonctionnalités de connexion, de déconnexion et de profil utilisateur à l’aide du SDK Nuxt d’Auth0.

1. Créer un nouveau projet

   Créez un nouveau projet Nuxt pour ce guide de démarrage rapide

   npx nuxi@latest init auth0-nuxt-app
   

   Ouvrez le projet

   cd auth0-nuxt-app
   
2. Installez le SDK Nuxt d’Auth0

   npm add @auth0/auth0-nuxt && npm install
   
3. Configurez votre application Auth0

   Ensuite, créez une nouvelle application sur votre locataire Auth0 et ajoutez les variables d’environnement à votre projet.

   Vous pouvez effectuer cette opération automatiquement en exécutant une commande CLI ou manuellement via le tableau de bord :

   CLI

   Exécutez la commande shell suivante à la racine de votre projet pour créer une application Auth0 et générer un fichier .env :

   Mac

   AUTH0_APP_NAME="My Nuxt App" && brew tap auth0/auth0-cli && brew install auth0 && auth0 login --no-input && auth0 apps create -n "${AUTH0_APP_NAME}" -t regular -c http://localhost:3000/auth/callback -l http://localhost:3000 -o http://localhost:3000 --reveal-secrets --json > auth0-app-details.json && CLIENT_ID=$(jq -r '.client_id' auth0-app-details.json) && CLIENT_SECRET=$(jq -r '.client_secret' auth0-app-details.json) && DOMAIN=$(auth0 tenants list --json | jq -r '.[] | select(.active == true) | .name') && echo "NUXT_AUTH0_DOMAIN=${DOMAIN}" > .env && echo "NUXT_AUTH0_CLIENT_ID=${CLIENT_ID}" >> .env && echo "NUXT_AUTH0_CLIENT_SECRET=${CLIENT_SECRET}" >> .env && echo "NUXT_AUTH0_SESSION_SECRET=$(openssl rand -hex 64)" >> .env && echo "NUXT_AUTH0_APP_BASE_URL=http://localhost:3000" >> .env && rm auth0-app-details.json && echo ".env file created with your Auth0 details:" && cat .env
   

   Tableau de bord

   Avant de commencer, créez un fichier .env à la racine de votre projet

   .env

   NUXT_AUTH0_DOMAIN=YOUR_AUTH0_APP_DOMAIN
   NUXT_AUTH0_CLIENT_ID=YOUR_AUTH0_APP_CLIENT_ID
   NUXT_AUTH0_CLIENT_SECRET=YOUR_AUTH0_APP_CLIENT_SECRET
   NUXT_AUTH0_SESSION_SECRET=YOUR_SESSION_SECRET
   NUXT_AUTH0_APP_BASE_URL=http://localhost:3000
   

   1. Accédez au Auth0 Dashboard
   2. Cliquez sur Applications > Applications > Create Application
   3. Dans la fenêtre contextuelle, entrez un nom pour votre application, sélectionnez Regular Web Application comme type d’application, puis cliquez sur Create
   4. Passez à l’onglet Settings de la page des détails de l’application
   5. Remplacez les valeurs du fichier .env par celles de Domaine, ID client et Secret client du tableau de bord
   6. Générez un secret de session en exécutant : openssl rand -hex 64, puis utilisez-le pour NUXT_AUTH0_SESSION_SECRET

   Enfin, dans l’onglet Settings de la page des détails de votre application, configurez les URL suivantes :

   Allowed Callback URLs:

   http://localhost:3000/auth/callback
   

   URLs de déconnexion autorisées :

   http://localhost:3000
   

   Origines Web autorisées :

   http://localhost:3000
   

   Allowed Callback URLs est une mesure de sécurité essentielle pour garantir que les utilisateurs sont redirigés en toute sécurité vers votre application après l’authentification. Sans URL correspondante, le processus de connexion échouera et les utilisateurs verront une page d’erreur Auth0 au lieu d’accéder à votre application.

   Allowed Logout URLs est essentiel pour offrir une expérience utilisateur fluide lors de la déconnexion. Sans URL correspondante, les utilisateurs ne seront pas redirigés vers votre application après la déconnexion et resteront plutôt sur une page Auth0 générique.

   Allowed Web Origins est essentiel pour l’authentification silencieuse. Sans cela, les utilisateurs seront déconnectés lorsqu’ils actualiseront la page ou reviendront plus tard dans votre application.

4. Configurer le module Nuxt Auth0

   nuxt.config.ts

   export default defineNuxtConfig({
     devtools: { enabled: true },
     modules: ['@auth0/auth0-nuxt'],
     runtimeConfig: {
       auth0: {
         domain: process.env.NUXT_AUTH0_DOMAIN,
         clientId: process.env.NUXT_AUTH0_CLIENT_ID,
         clientSecret: process.env.NUXT_AUTH0_CLIENT_SECRET,
         sessionSecret: process.env.NUXT_AUTH0_SESSION_SECRET,
         appBaseUrl: process.env.NUXT_AUTH0_APP_BASE_URL,
       },
     },
   })
   

5. Créer des composants de connexion, de déconnexion et de profil

   Créer des fichiers

   mkdir -p app/components && touch app/components/LoginButton.vue && touch app/components/LogoutButton.vue && touch app/components/UserProfile.vue
   

   Et ajoutez les extraits de code suivants

   app/components/LoginButton.vue

   <template>
    <a 
       href="/auth/login" 
       class="button login"
     >
       Log In
     </a>
   </template>
   
   <style scoped>
   .button {
     padding: 1.1rem 2.8rem;
     font-size: 1.2rem;
     font-weight: 600;
     border-radius: 10px;
     border: none;
     cursor: pointer;
     transition: all 0.3s cubic-bezier(0.25, 0.8, 0.25, 1);
     box-shadow: 0 8px 20px rgba(0, 0, 0, 0.4);
     text-transform: uppercase;
     letter-spacing: 0.08em;
     outline: none;
   }
   
   .button:focus {
     box-shadow: 0 0 0 4px rgba(99, 179, 237, 0.5);
   }
   
   .button.login {
     background-color: #63b3ed;
     color: #1a1e27;
   }
   
   .button.login:hover:not(:disabled) {
     background-color: #4299e1;
     transform: translateY(-5px) scale(1.03);
     box-shadow: 0 12px 25px rgba(0, 0, 0, 0.5);
   }
   
   .button:disabled {
     opacity: 0.7;
     cursor: not-allowed;
     transform: none;
   }
   </style>
   
6. Lancez votre application

   npm run dev
   

Point de contrôle

Vous devriez maintenant avoir une page de connexion Auth0 entièrement fonctionnelle qui s’exécute sur votre localhost