Passer au contenu principal

Avant de commencer

Vous avez besoin de :
Auth0 CLI vous permet d’implémenter et de tester les écrans ACUL (Advanced Customization for Universal Login). Elle simplifie la personnalisation des écrans d’authentification (comme la connexion, l’inscription, l’authentification sans mot de passe et l’inscription de passkeys) pour qu’ils correspondent exactement à vos applications Web. Suivez ces étapes pour créer un projet ACUL et un écran login_id personnalisé à l’aide d’Auth0 CLI :

​
1. Initialiser une application d’exemple ACUL

Si vous n’avez pas configuré votre tenant de développement avec Auth0 CLI, utilisez la commande auth0 login pour configurer votre tenant.
Placez-vous dans le répertoire où vous souhaitez créer votre projet, puis exécutez la commande suivante : 
auth0 acul init "Your_App_Name"
  1. Sélectionnez React (with ACUL React SDK).
  2. Sélectionnez l’écran login-id.
  3. À la question Would you like to proceed with installing the required dependencies using ‘npm install’?, entrez y.
Auth0 CLI crée un nouveau répertoire de projet avec le nom d’application fourni.
Si vous n’avez pas choisi y pour installer les dépendances nécessaires, accédez au répertoire de votre projet et exécutez la commande npm install.

​
2. (Facultatif) Ajouter d’autres écrans à votre projet

Sélectionnez d’autres écrans pour votre projet en exécutant la commande suivante : 
auth0 acul screen add SCREEN_NAME

​
3. Lancer l’écran Login Id avec Universal Login Context Inspector

Utilisez l’inspecteur de contexte UL pour lancer l’écran Login Id :
  1. Accédez au répertoire de votre projet et exécutez la commande suivante :
  auth0 acul dev
  1. Confirmez le répertoire du projet
  2. Sélectionnez le port pour partager les ressources locales, par défaut le port 55444
L’outil Universal Login Context Inspector ouvre une nouvelle fenêtre de navigateur avec l’écran Login Id.

​
4. Mettre à jour l’écran Login Id de l’exemple

La commande auth0 acul dev génère les écrans ACUL, héberge vos ressources en local et surveille en continu les mises à jour du répertoire des ressources, ce qui vous permet de tester vos écrans localement. Pour en savoir plus, consultez la documentation de la commande Auth0 CLI acul.
  1. Dans le répertoire de votre projet, modifiez le fichier /src/index.css et mettez à jour le widget de logo avec l’URL de votre logo :
--ul-theme-widget-logo-url: "Your-Logo-URL";
  1. Enregistrez la modification.
Le serveur de développement local se met automatiquement à jour avec la dernière modification.

​
5. Personnaliser les données de contexte pour vos écrans d’authentification

À l’aide de l’outil Universal Login Context Inspector, vous pouvez personnaliser les données de contexte par défaut pour tester vos écrans d’authentification en fonction des configurations propres à un tenant donné.
  1. Créez une version locale des données de contexte simulées pour un écran dans votre projet :
Sélectionnez l’icône Download JSON pour télécharger le fichier de données de contexte simulées.
Page ACUL dans Auth0 Dashboard
  1. Renommez et déplacez le fichier téléchargé dans public/screens/{prompt}/{screen} et ajoutez-le au fichier public/manifest.json dans le répertoire de votre projet.
Par exemple, le fichier téléchargé login-id-login-id-context.json est renommé login-id.json et est déplacé vers /public/screens/login-id/login-id.json.
  1. Sélectionnez Local Development dans Data source d’Universal Login Context Inspector pour charger la version locale des données de contexte simulées pour l’écran.
Pour en savoir plus, consultez la documentation d’Auth0 CLI ACUL.