Guide de démarrage Auth0

Détectez votre framework et commencez avec l'authentification Auth0.

Étape 1 : Détectez votre framework

Exécutez cette commande pour identifier votre framework :

# Vérifiez les dépendances package.json (projets Node.js)
cat package.json | grep -E "react|next|vue|nuxt|angular|express|fastify|@nestjs|expo"

# Ou vérifiez les fichiers du projet
ls -la | grep -E "angular.json|vue.config.js|next.config|app.json|Package.swift|build.gradle"

Tableau de détection de framework :

Framework	Détection	Skill à utiliser
React (Vite/CRA)	`"react"` dans package.json, pas de Next.js	`auth0-react`
Next.js	`"next"` dans package.json	`auth0-nextjs`
Vue.js	`"vue"` dans package.json, pas de Nuxt	`auth0-vue`
Nuxt	`"nuxt"` dans package.json	`auth0-nuxt`
Angular	`angular.json` existe ou `"@angular/core"`	`auth0-angular`
Express.js	`"express"` dans package.json	`auth0-express`
Fastify (application web)	`"fastify"` dans package.json, a `@fastify/view`	`auth0-fastify`
Fastify (API)	`"fastify"` dans package.json, pas de moteur de vue	`auth0-fastify-api`
React Native	`"react-native"` ou `"expo"` dans package.json	`auth0-react-native`
Flask	`"flask"` dans requirements.txt, Pipfile, ou pyproject.toml	`auth0-flask`
Node.js API	`"express-oauth2-jwt-bearer"` dans package.json	`express-oauth2-jwt-bearer`

Votre framework n'est pas listé ? Voir les Frameworks Tier 2 ci-dessous.

Étape 2 : Configuration du compte Auth0

Installez Auth0 CLI

macOS/Linux :

brew install auth0/auth0-cli/auth0

Windows :

scoop install auth0
# Ou : choco install auth0-cli

Guide d'installation complet : Voir CLI Reference

Connectez-vous à Auth0

auth0 login

Cela ouvre votre navigateur pour vous authentifier auprès d'Auth0.

Étape 3 : Créez une application Auth0

Choisissez le type d'application en fonction de votre framework :

Single Page Applications (React, Vue, Angular) :

auth0 apps create --name "My App" --type spa \
  --callbacks "http://localhost:3000" \
  --logout-urls "http://localhost:3000" \
  --metadata "created_by=agent_skills"

Applications web classiques (Next.js, Nuxt, Express, Fastify) :

auth0 apps create --name "My App" --type regular \
  --callbacks "http://localhost:3000/api/auth/callback" \
  --logout-urls "http://localhost:3000" \
  --metadata "created_by=agent_skills"

Applications natives (React Native) :

auth0 apps create --name "My App" --type native \
  --callbacks "myapp://callback" \
  --logout-urls "myapp://logout" \
  --metadata "created_by=agent_skills"

Récupérez vos identifiants :

auth0 apps list          # Trouvez votre application
auth0 apps show <app-id> # Obtenez l'ID client et le secret

Plus de commandes CLI : Voir CLI Reference

Étape 4 : Utilisez la skill spécifique au framework

En fonction de la détection de votre framework, utilisez la skill appropriée :

Frameworks Tier 1 (Skills dédiées)

Frontend :

auth0-react - React SPAs (Vite, Create React App)
auth0-nextjs - Next.js (App Router et Pages Router)
auth0-vue - Applications Vue.js 3
auth0-nuxt - Applications Nuxt 3/4
auth0-angular - Applications Angular 12+

Backend :

auth0-express - Applications web Express.js
auth0-flask - Applications web Flask
auth0-fastify - Applications web Fastify
auth0-fastify-api - Authentification API Fastify
express-oauth2-jwt-bearer - Validation JWT Bearer pour Node.js/Express API

Mobile :

auth0-react-native - React Native et Expo (iOS/Android)

Frameworks Tier 2 (Utilisez la documentation Auth0)

Pas encore disponibles en tant que skills séparées. Utilisez la documentation Auth0 :

Frontend :

Backend :

Mobile :

Migration depuis d'autres fournisseurs

Vous migrez depuis un autre fournisseur d'auth ? Utilisez la skill auth0-migration.

La skill de migration couvre :

Export d'utilisateurs depuis Firebase, Cognito, Supabase, Clerk, etc.
Import en masse vers Auth0
Patterns de migration de code (exemples avant/après)
Mises à jour de la validation JWT
Stratégies de migration progressive

Documentation de référence

Variables d'environnement

Configuration des variables d'environnement spécifiques au framework :

Concepts Auth0

Concepts fondamentaux et dépannage :

Commandes CLI

Référence complète Auth0 CLI :

Erreurs courantes

Erreur	Solution
Type d'application incorrect	Les SPAs ont besoin de « Single Page Application », les applications serveur de « Regular Web Application », les mobiles de « Native »
URL de callback non configurée	Ajoutez l'URL de callback de votre application aux URLs de callback autorisées dans le tableau de bord Auth0
Mauvais identifiants utilisés	Client Secret nécessaire seulement pour les Regular Web Apps, pas pour les SPAs
Identifiants codés en dur dans le code	Utilisez toujours les variables d'environnement, ne commitez jamais les secrets dans git
Pas de test en local d'abord	Configurez les URLs localhost dans Auth0 avant de déployer en production
Mélange de types d'application	N'utilisez pas le SDK SPA pour les applications côté serveur ou vice versa

Skills connexes

Intégration principale

auth0-migration - Migrer depuis d'autres fournisseurs d'auth

Skills SDK

auth0-spa-js - Intégration SPA
auth0-react - Intégration React SPA
auth0-nextjs - Intégration Next.js
auth0-vue - Intégration Vue.js
auth0-nuxt - Intégration Nuxt 3/4
auth0-angular - Intégration Angular
auth0-express - Intégration Express.js
auth0-flask - Intégration application web Flask
auth0-fastify - Intégration application web Fastify
auth0-fastify-api - Intégration API Fastify
express-oauth2-jwt-bearer - Validation JWT Bearer pour Node.js/Express API
auth0-react-native - Intégration React Native CLI (bare workflow)
auth0-expo - Intégration Expo (managed workflow)
auth0-android - Intégration Android (Kotlin/Java)
auth0-swift - Intégration iOS/macOS (Swift)
auth0-fastapi-api - Authentification API FastAPI
auth0-aspnetcore-api - Authentification API ASP.NET Core

Fonctionnalités avancées

auth0-mfa - Authentification multifacteur

auth0-quickstart