> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Explique comment installer l’extension Auth0 pour WordPress

# Installer Login by Auth0

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  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](https://wordpress.com/support/com-vs-org/).
</Callout>

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](https://wordpress.com/support/com-vs-org/).

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, [i**nscrivez-vous gratuitement pour en créer un**](https://auth0.com/signup) avant de poursuivre.

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  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.
</Callout>

<div id="multisite-setup">
  ## Configuration multisite
</div>

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](/fr-CA/docs/customize/integrations/cms/wordpress-plugin/configure-login-by-auth0) 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 »](https://community.auth0.com/tags/wordpress).

<div id="setup-wizard">
  ## Assistant de configuration
</div>

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.

<div id="option-1-standard-setup">
  ### Option 1 : Configuration standard
</div>

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](https://auth0.com/docs/api/management/v2/get-access-tokens-for-test#get-access-tokens-manually). 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](/fr-CA/docs/get-started/auth0-overview/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](/fr-CA/docs/authenticate/database-connections/password-strength#password-policieslicies).

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 <Tooltip tip="Auth0 Dashboard : produit principal d’Auth0 pour configurer vos services." cta="Voir le glossaire" href="/fr-CA/docs/glossary?term=Auth0+Dashboard">Auth0 Dashboard</Tooltip>. Dans WordPress, accédez à **Auth0 > Settings > Basic**, supprimez les champs Domaine, <Tooltip tip="Secret client : secret utilisé par une application pour s’authentifier auprès du serveur d’autorisation; il ne doit être connu que par l’application et le serveur d’autorisation et doit être suffisamment aléatoire pour ne pas pouvoir être deviné." cta="Voir le glossaire" href="/fr-CA/docs/glossary?term=Client+ID">ID client</Tooltip> et <Tooltip tip="ID client : valeur d’identification attribuée à votre ressource enregistrée par Auth0." cta="Voir le glossaire" href="/fr-CA/docs/glossary?term=Client+Secret">Secret client</Tooltip>, 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](https://community.auth0.com/tags/wordpress) en y incluant les messages d’erreur affichés dans le Error Log, et nous serons heureux de vous aider !

<div id="option-2-user-migration-setup">
  ### Option 2 : Configuration de la migration des utilisateurs
</div>

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](/fr-CA/docs/customize/integrations/cms/wordpress-plugin/user-migration-in-login-by-auth0).

::: 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](/fr-CA/docs/customize/integrations/cms/wordpress-plugin/user-migration-in-login-by-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 actuels dans le formulaire de connexion Auth0. Cela devrait créer un utilisateur Auth0 lié à votre compte WordPress.

<div id="option-3-manual-setup">
  ### Option 3 : Configuration manuelle
</div>

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.

<div id="option-4-import-setup">
  ### Option 4 : Configuration par importation
</div>

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é.

<div id="setup-complete">
  ## Configuration terminée
</div>

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](/fr-CA/docs/customize/integrations/cms/wordpress-plugin/configure-login-by-auth0).

<div id="manual-setup">
  ## Configuration manuelle
</div>

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](https://manage.auth0.com/#), 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](/fr-CA/docs/customize/integrations/cms/wordpress-plugin/configure-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é.

<div id="learn-more">
  ## En savoir plus
</div>

* [Intégrer WordPress](/fr-CA/docs/customize/integrations/cms/wordpress-plugin/integrate-with-wordpress)
* [Configurer le module Login by Auth0](/fr-CA/docs/customize/integrations/cms/wordpress-plugin/configure-login-by-auth0)
* [Résoudre les problèmes liés à Login by Auth0 WordPress extension](/fr-CA/docs/customize/integrations/cms/wordpress-plugin/troubleshoot-login-by-auth0)
* [Étendre Login by Auth0 WordPress extension](/fr-CA/docs/customize/integrations/cms/wordpress-plugin/extend-login-by-auth0)