Passer au contenu principal

Avant de commencer

Vous avez besoin de :
Auth0 CLI vous permet d’implémenter et de tester les écrans de personnalisation avancée pour la connexion universelle (ACUL). Il simplifie la personnalisation des écrans d’authentification (tels que Login, Signup, Passwordless, et Passkey enrollment) 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 un exemple d’application ACUL

Si vous n’avez pas configuré votre tenant de développement avec Auth0 CLI, utilisez la commande auth0 login pour configurer votre tenant.
Naviguez vers un emplacement pour construire votre projet et 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. À 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. <Callout icon=“file-lines” color=“#0EA5E9” iconType=“regular”> Si vous n’avez pas sélectionné y pour installer les dépendances requises, naviguez vers votre répertoire de projet et exécutez la commande npm install. </Callout>

​
2. (Optionnel) Ajouter des écrans supplémentaires à votre projet

Sélectionnez des écrans supplémentaires pour votre projet en exécutant la commande suivante : 
auth0 acul screen add SCREEN_NAME

​
3. Lancer l’écran Login Id avec l’Inspecteur de Contexte Connexion Universelle

Utilisez l’inspecteur de contexte UL pour lancer l’écran Login ID:
  1. Naviguez vers votre répertoire de 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 assets locaux, par défaut le Port 55444
L’Inspecteur de Contexte Connexion universelle ouvre une nouvelle fenêtre de navigateur avec l’écran Login Id.

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

<Callout icon=“file-lines” color=“#0EA5E9” iconType=“regular”> La commande auth0 acul dev construit les écrans ACUL, héberge vos assets localement, et surveille en permanence les mises à jour du répertoire des assets; vous permettant de tester vos écrans localement. Pour en savoir plus, lisez la documentation de la commande Auth0 CLI acul. </Callout>
  1. Dans votre répertoire de projet, modifiez le répertoire /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 rafraîchit automatiquement avec la dernière modification.

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

En utilisant l’Inspecteur de Contexte Connexion universelle, vous pouvez personnaliser les données de contexte par défaut pour tester vos écrans d’authentification par rapport aux configurations spécifiques au tenant.
  1. Créez une version locale des données de contexte factices pour un écran de votre projet :
Sélectionnez l’icône Télécharger JSON pour télécharger le fichier de données de contexte factices. <Frame><img src=“/docs/images/cdy7uua7fh8z/ACUL/ULContextInspectorDownload.png” alt=“Page ACUL du Dashboard Auth0” /></Frame>
  1. Renommez et déplacez le fichier téléchargé vers public/screens/{prompt}/{screen} et ajoutez-le au fichier public/manifest.json file dans le répertoire de votre projet. Par exemple, le fichier login-id-login-id-context.json téléchargé est renommé login-id.json et est déplacé vers /public/screens/login-id/login-id.json.
  2. Sélectionnez Développement Local dans la Source de données de l’Inspecteur de Contexte Universal Login pour charger la version locale du contexte factice pour l’écran.
Pour en savoir plus, lisez la documentation Auth0 CLI ACUL documentation.