Skip to main content

Avant de commencer

Vous aurez besoin de :
Auth0 CLI vous permet de mettre en œuvre et de tester les écrans de personnalisation avancée pour Universal Login (ACUL). Il simplifie la personnalisation des écrans d’authentification (comme Login, Signup, Passwordless et l’enregistrement de Passkey) pour qu’ils correspondent parfaitement à 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 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.
Accédez à l’emplacement où vous souhaitez créer votre projet, puis exécutez la commande suivante :
  1. Sélectionnez React (avec Auth0 ACUL React SDK).
  2. Sélectionnez l’écran login-id.
  3. À la question Souhaitez-vous poursuivre l’installation des dépendances requises à l’aide de ‘npm install’ ?, saisissez y.
Auth0 CLI crée un nouveau répertoire de projet avec le nom de l’application fourni.
Si vous n’avez pas sélectionné y pour installer les dépendances requises, accédez au répertoire de votre projet et exécutez la commande npm install.

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

Sélectionnez d’autres écrans pour votre projet en exécutant la commande suivante :

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

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

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

La commande auth0 acul dev génère les écrans ACUL, héberge vos ressources statiques localement et surveille en continu les mises à jour dans le répertoire des ressources statiques, ce qui vous permet de tester vos écrans en local. 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 du 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 s’actualise automatiquement avec la dernière modification.

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

À l’aide de l’Universal Login Context Inspector, vous pouvez personnaliser les données de contexte par défaut afin de tester vos écrans d’authentification selon des configurations propres au tenant.
  1. Créez une version locale des données de contexte simulées pour un écran de votre projet :
Sélectionnez l’icône Download JSON pour télécharger le fichier de données de contexte simulées.
Page ACUL de l’Auth0 Dashboard
  1. Renommez le fichier téléchargé, déplacez-le vers 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 déplacé vers /public/screens/login-id/login-id.json.
  1. Sélectionnez Local Development dans la source de données de l’Universal Login Context Inspector pour charger la version locale du contexte simulé de l’écran.
Pour en savoir plus, consultez la documentation Auth0 CLI ACUL.