Installer Connexion par Auth0

Ce plugiciel peut être ajouté à votre site WordPress en utilisant l’écran Plugiciels dans wp-admin :

1. Connectez-vous à un site WordPress existant en tant qu’administrateur.

2. Allez dans Plugiciels > Ajouter nouveau dans le menu d’administration à gauche.

3. Recherchez « Connexion par Auth0 »

4. Pour le plugiciel Connexion par Auth0, cliquez sur Installer maintenant, puis sur Activer.

Pour en savoir plus sur ce processus, lisez WordPress.com et WordPress.org sur wordpress.com.

Dès que le plugiciel est activé, vous êtes redirigé vers le début de l’assistant de configuration.

Si vous n’avez pas encore de compte Auth0, inscrivez-vous gratuitement pour en créer un avant de continuer.

Le plugiciel Login by Auth0 est compatible avec les réseaux WordPress multisites. Le plugiciel peut être activé en réseau pour protéger automatiquement les sites du réseau (une fois la configuration terminée) ou activé uniquement sur un sous-ensemble du réseau.

Il y a plusieurs façons de configurer un réseau de sites dans Auth0 :

1. Tous les sites peuvent partager une application et une connexion de base de données

   1. Exécutez les étapes de l’assistant de configuration jusqu’à la fin pour le site principal.

   2. Configurez tous les autres sites manuellement en utilisant le Domaine, l’ID client et le secret client du site principal dans l’onglet Basic (Basique) de la page des paramètres Auth0.

   3. Mettez à jour les URL de rappel autorisées, Origines Web autorisées et URL de déconnexion autorisées de l’application pour inclure chaque site (des caractères génériques peuvent être utilisés si votre réseau utilise des sous-domaines).

2. Chaque site peut avoir sa propre application et partager une connexion à la base de données.

   1. Exécutez les étapes de l’assistant de configuration jusqu’à la fin pour le site principal.

   2. Ensuite, créez manuellement une application pour chaque site et ajoutez chacune d’entre elles à la connexion de base de données créée précédemment.

   3. Ajoutez les valeurs Domaine, ID Client et Secret Client à l’onglet Basique de la page des paramètres Auth0 pour chaque site.

3. Chaque site peut avoir sa propre application et sa propre connexion à la base de données. Dans ce cas, exécutez les étapes de l’assistant d’installation jusqu’à la fin pour chaque site.

Chacune des options ci-dessus comporte des compromis. L’option 1 est celle qui comporte le moins d’entités différentes à gérer dans Auth0 mais, si votre réseau compte des centaines de sites et que vous n’utilisez pas de sous-domaines, vous risquez d’être limité par le nombre d’URL de rappel. L’option 2 nécessitera la gestion d’un grand nombre d’applications différentes, mais vous permettra de configurer l’application de chaque site différemment.

Comme toujours, si vous avez des questions sur ce processus de configuration, créez un message dans notre Communauté et marquez-le « wordpress ».

L’assistant de configuration va tenter de créer tous les composants nécessaires à l’utilisation d’Auth0 sur votre site WordPress. Si vous avez une application existante ou une connexion de base de données que vous souhaitez utiliser, veuillez consulter les étapes de l’installation manuelle ci-dessous.

Cette option permet de créer et de configurer une application et une connexion à la base de données pour ce site.

Tout d’abord, générez un jeton de Management API. Une fois le jeton généré, notez le nom de domaine utilisé dans le champ Identifiant sous l’onglet Paramètres. Par exemple, si votre identifiant est https://tenant-name.auth0.com/api/v2/, le domaine du locataire est tenant-name.auth0.com. Pour en savoir plus sur les domaines de locataire, lisez Créer des locataires.

De retour dans l’assistant de configuration de l’administrateur WordPress, cliquez sur Standard. Dans la fenêtre modale qui s’affiche, cliquez sur Démarrer la configuration standard.

Saisissez le domaine du locataire et le jeton API ci-dessus. Ce jeton n’est utilisé que pour le processus d’installation et ne sera pas sauvegardé dans la base de données.

Si la première partie de la configuration se termine avec succès, l’écran « Configurez vos connexions sociales » s’affiche. Cliquez sur Suivant pour poursuivre le processus d’installation en migrant votre compte administrateur.

Cette étape connecte votre utilisateur WordPress avec un utilisateur Auth0 qui vous autorise à vous connecter. Vous pouvez choisir le même mot de passe que votre compte administrateur ou un mot de passe différent, mais assurez-vous qu’il soit conforme aux politiques de force de mot de passe pour la base de données Connexion utilisée. Pour en savoir plus, lisez Force du mot de passe dans les connexions de base de données Auth0 : Politiques en matière de mots de passe.

L’assistant d’installation doit s’exécuter jusqu’au bout pour que votre site soit correctement configuré. Si l’assistant échoue pour une raison quelconque avant l’écran « installation réussie », vérifiez le journal des erreurs du plugiciel à wp-admin > Auth0 > Journal des erreurs et les étapes ci-dessous pour déterminer le problème.

Pour recommencer complètement le processus, supprimez toutes les applications ou connexions de base de données qui ont été créées dans Auth0 Dashboard. Dans WordPress, allez à Auth0 > Settings (Paramètres)> Basic (Basique), supprimez les champs Domain (Domaine), Client ID (ID Client), et Client Secret (Secret Client), puis cliquez sur Save (Enregistrer). Cliquez ensuite sur Setup Wizard (Assistant d’installation) dans le menu d’administration pour recommencer le processus.

Si vous n’arrivez toujours pas à installer le plugiciel, publiez un message dans notre Communauté avec les messages d’erreur que vous voyez dans le journal d’erreurs, et nous serons heureux de vous aider!

Cette option permet de créer et de configurer une application et une connexion à la base de données, ainsi que la migration des données depuis votre base de données WordPress. Cela nécessite une connexion entrante à partir des serveurs Auth0 et ne peut pas être modifié ultérieurement sans perdre des données. Pour en savoir plus, lisez migration des utilisateurs dans le plugiciel WordPress Login par Auth0.

::: avertissement Si vous avez plus d’une connexion à une base de données personnalisée dans Auth0, vous devrez vous assurer que les identifiants des utilisateurs comportent des espaces de noms pour éviter les conflits. Cela est fait automatiquement pour les sites qui installent la version 3.11.0 ou une version ultérieure. Si vos connexions ont été créées avec une version antérieure, lisez les étapes de dépannage dans Migration des utilisateurs dans le plugiciel WordPress Login par Auth0. :::

Une fois le processus de configuration terminé, déconnectez-vous de votre site WordPress et essayez de vous reconnecter en utilisant vos identifiants WordPress existants dans le formulaire de connexion Auth0. Cela devrait créer un utilisateur Auth0 lié à votre compte WordPress.

Cette option vous permet d’ignorer la configuration automatique et de créer et de configurer votre propre application et votre connexion à la base de données (voir ci-dessous). Cette option doit être utilisée si vous souhaitez que ce site utilise une application ou une connexion de base de données existante.

Le site peut également être configuré en important les paramètres d’un autre site. Cette option est utile si vous migrez d’un environnement à l’autre ou si vous avez un site WordPress similaire déjà configuré.

Lorsque vous voyez l’écran « Terminé », Auth0 est activé et prêt à accepter les connexions et, si configuré, les inscriptions.

C’est le bon moment pour confirmer que les bases fonctionnent pour votre site avant de modifier les paramètres par défaut :

1. Déconnectez-vous de WordPress et confirmez que le formulaire Auth0 apparaît maintenant à /wp-login.php.

2. Connectez-vous avec l’utilisateur Auth0 créé ci-dessus.

3. Déconnectez-vous et essayez de créer un compte avec une adresse courriel différente (si l’option « Tout le monde peut s’enregistrer » est activée dans les paramètres généraux de WordPress).

4. Essayez de vous connecter en utilisant une connexion sociale (si vous l’avez activée).

Vous êtes maintenant prêt à configurer l’application.

Le plugiciel peut être configuré à l’aide de l’assistant de configuration intégré (voir ci-dessous) ou manuellement en créant une application et en attribuant des connexions. Le processus de configuration entièrement manuel peut être utilisé si vous avez des difficultés avec l’assistant, si vous avez déjà suivi le processus de configuration ou si vous souhaitez partager une connexion de base de données entre les applications.

1. Allez à Auth0 Dashboard > Applications > Applications, et sélectionnez Créer.

2. Donnez un nom descriptif à votre application, sélectionnez Applications Web ordinaires, puis Créer.

3. Configurez l’application pour votre installation WordPress. Pour savoir comment configurer l’application, lisez Configurer Login by Auth0 et suivez toutes les sections jusqu’à « Mettre à jour les paramètres Auth0 dans WordPress ».

Une fois les étapes ci-dessus terminées, votre site sera configuré et prêt à être utilisé.

• Intégration à WordPress
• Connexion par Auth0
• Dépannage du plugiciel WordPress Login by Auth0
• Plugiciel WordPress Extend Login by Auth0