Passer au contenu principal
Pour installer ou personnaliser des extensions, vous devez utiliser un site WordPress.org auto-hébergé. Les sites WordPress.com ne permettent pas d’installer des extensions. Pour en savoir plus sur les différences, consultez WordPress.com et WordPress.org sur wordpress.com.
Cette extension peut être ajoutée à votre site WordPress à partir de l’écran Plugins dans wp-admin :
  1. Connectez-vous à un site WordPress existant en tant qu’administrateur.
  2. Dans le menu d’administration de gauche, accédez à Plugins > Add New.
  3. Recherchez “Login by Auth0”
  4. Pour l’extension Login by Auth0, cliquez sur Install Now, puis sur Activate.
Pour en savoir plus sur ce processus, consultez WordPress.com et WordPress.org sur wordpress.com. Dès que l’extension est activée, 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 poursuivre.
Auth0 ne remplacera pas vos formulaires de connexion tant qu’un Domaine, un ID client et un Secret client n’auront pas été ajoutés à l’onglet Basic de la page des paramètres.

​
Configuration multisite

L’extension Login by Auth0 est compatible avec les réseaux multisites WordPress. L’extension peut être activée à l’échelle du réseau pour protéger automatiquement les sites du réseau (une fois la configuration terminée), ou activée uniquement sur un sous-ensemble du réseau. Il existe plusieurs façons de configurer un réseau de sites dans Auth0 :
  1. Tous les sites peuvent partager à la fois une application et une connexion de base de données
    1. Exécutez toutes les étapes de l’assistant de configuration pour le site principal.
    2. Configurez manuellement tous les autres sites en utilisant le Domaine, l’ID client et le Secret client du site principal dans l’onglet Basic de la page des paramètres d’Auth0.
    3. Mettez à jour les Allowed Callback URLs, Allowed Web Origins et Allowed Logout URLs 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 de base de données
    1. Exécutez toutes les étapes de l’assistant de configuration pour le site principal.
    2. Ensuite, créez manuellement une application pour chaque site et ajoutez chacune à la connexion de base de données créée précédemment.
    3. Ajoutez les valeurs Domaine, ID client et Secret client dans l’onglet Basic de la page des paramètres d’Auth0 pour chaque site.
  3. Chaque site peut avoir sa propre application et sa propre connexion de base de données. Dans ce cas, exécutez toutes les étapes de l’assistant de configuration pour chaque site.
Chacune des options ci-dessus comporte des compromis. L’option 1 réduit au minimum le nombre d’entités à gérer dans Auth0, mais si votre réseau compte des centaines de sites et que vous n’utilisez pas de sous-domaines, vous pourriez atteindre les limites du nombre d’URL de callback. L’option 2 exigera la gestion de nombreuses applications distinctes, mais vous permettra de configurer l’application de chaque site différemment. Comme toujours, si vous avez des questions sur ce processus de configuration, publiez un message dans notre communauté et ajoutez l’étiquette « wordpress ».

​
Assistant de configuration

L’Assistant de configuration tentera de créer tous les composants nécessaires pour utiliser Auth0 sur votre site WordPress. Si vous souhaitez utiliser une application ou une connexion de base de données existante, veuillez consulter les étapes de configuration manuelle ci-dessous.

​
Option 1 : Configuration standard

Cette option créera et configurera une application et une connexion de base de données pour ce site. D’abord, générez un jeton de la Management API. Une fois le jeton généré, notez le nom de domaine utilisé dans le champ Identifier, sous l’onglet Settings. Par exemple, si votre Identifier 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, consultez Create Tenants. De retour dans l’assistant de configuration de l’interface d’administration WordPress, cliquez sur Standard. Dans la fenêtre modale qui s’affiche, cliquez sur Start Standard Setup. Saisissez le domaine du locataire et le jeton d’API ci-dessus. Ce jeton sert uniquement au processus de configuration et ne sera pas enregistré dans la base de données. Si la première partie de la configuration se termine correctement, l’écran « Configure your social connections » s’affichera. Cliquez sur Next pour poursuivre la configuration en migrant votre compte administrateur. Cette étape lie votre compte WordPress à un utilisateur Auth0 qui vous permettra de vous connecter. Vous pouvez choisir le même mot de passe que pour votre compte administrateur ou en choisir un autre, mais assurez-vous qu’il respecte les exigences de force du mot de passe de la connexion de base de données utilisée. Pour en savoir plus, consultez Password Strength in Auth0 Database Connections: Password Policies. L’assistant de configuration doit s’exécuter jusqu’au bout pour que votre site soit correctement configuré. Si l’assistant échoue pour quelque raison que ce soit avant l’écran « configuration réussie », consultez le journal des erreurs de l’extension à wp-admin > Auth0 > Error Log ainsi que les étapes ci-dessous pour déterminer le problème. Pour recommencer entièrement le processus, supprimez toutes les applications ou connexions de base de données créées dans le . Dans WordPress, accédez à Auth0 > Settings > Basic, supprimez les champs Domaine, et , puis cliquez sur Save. Cliquez ensuite sur assistant de configuration dans le menu d’administration pour recommencer le processus. Si vous n’arrivez toujours pas à l’installer, publiez une discussion dans notre Community en y incluant les messages d’erreur affichés dans le Error Log, et nous serons heureux de vous aider !

​
Option 2 : Configuration de la migration des utilisateurs

Cette option créera et configurera une application et une connexion de base de données, ainsi que la migration des données depuis votre base de données WordPress. Cela exige une connexion entrante depuis les serveurs Auth0 et ne pourra pas être modifié par la suite sans entraîner une perte de données. Pour en savoir plus, consultez User Migration in Login by Auth0 WordPress Plugin. ::: warning Si vous avez plus d’une connexion de base de données personnalisée dans Auth0, vous devrez vous assurer que les ID utilisateur utilisent un espace de noms afin d’éviter les conflits. Cela se fait automatiquement pour les sites qui installent la version 3.11.0 ou une version ultérieure. Si vos connexions sont ou ont été créées avec une version antérieure, consultez les étapes de dépannage dans User Migration in Login by Auth0 WordPress Plugin. ::: Une fois le processus de configuration terminé, déconnectez-vous de votre site WordPress et essayez de vous reconnecter en utilisant vos identifiants WordPress actuels dans le formulaire de connexion Auth0. Cela devrait créer un utilisateur Auth0 lié à votre compte WordPress.

​
Option 3 : Configuration manuelle

Cette option ignore la configuration automatique et vous permet de créer et de configurer votre propre application et votre propre connexion de base de données (voir ci-dessous). Utilisez cette option si vous voulez que ce site utilise une application ou une connexion de base de données existante.

​
Option 4 : Configuration par importation

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

​
Configuration terminée

Lorsque l’écran « Done » s’affiche, Auth0 est activé et prêt à accepter les connexions et, si elles sont configurées, les inscriptions. C’est le bon moment pour vérifier que les fonctions de base de votre site marchent avant de modifier les paramètres par défaut :
  1. Déconnectez-vous de WordPress et vérifiez que le formulaire Auth0 s’affiche maintenant à l’adresse /wp-login.php.
  2. Connectez-vous avec l’utilisateur Auth0 créé ci-dessus.
  3. Déconnectez-vous, puis essayez de créer un compte avec une autre adresse de courriel (si l’option « Anyone can register » est activée dans les paramètres généraux de WordPress).
  4. Essayez d’ouvrir une session à l’aide d’une connexion sociale (si vous les avez activées).
Vous êtes maintenant prêt à configurer l’application.

​
Configuration manuelle

L’extension peut être configurée à l’aide de l’assistant de configuration intégré (présenté ci-dessous) ou manuellement, en créant une application et en lui attribuant des connexions. Le processus de configuration entièrement manuel peut être utile si vous éprouvez des difficultés avec l’assistant, si vous avez déjà effectué la configuration auparavant ou si vous souhaitez partager une connexion de base de données entre plusieurs applications.
  1. Accédez à Auth0 Dashboard > Applications > Applications, puis sélectionnez Créer.
  2. Donnez à votre application un nom explicite, sélectionnez Applications Web régulières, puis sélectionnez Créer.
  3. Configurez l’application pour votre installation WordPress. Pour savoir comment configurer l’application, consultez 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é.

​
En savoir plus