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

# Installer Connexion par Auth0

> Explique comment installer le plugiciel WordPress Auth0

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Pour installer ou personnaliser des plugiciels, vous devez utiliser un site WordPress.org autohébergé. L’utilisation d’un site WordPress.com ne permet pas d’installer des plugiciels. 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>

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

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**](https://auth0.com/signup) avant de continuer.

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Auth0 ne remplacera pas vos formulaires de connexion jusqu’à ce qu’un **domaine**, un **ID client** et un **secret client** aient été ajoutés à l’onglet Basique de la page de configuration.
</Callout>

## Configuration multisite

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

## Assistant de configuration

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.

### Option 1 : Configuration standard

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](/docs/fr-ca/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 **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](/docs/fr-ca/get-started/auth0-overview/create-tenants).

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](/docs/fr-ca/connections/database/password-strength#password-policies).

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 <Tooltip href="/docs/fr-ca/glossary?term=auth0-dashboard" tip="Auth0 Dashboard
Principal produit d’Auth0 pour configurer vos services." cta="Voir le glossaire">Auth0 Dashboard</Tooltip>. Dans WordPress, allez à **Auth0 > Settings (Paramètres)> Basic (Basique)**, supprimez les champs Domain (Domaine), <Tooltip href="/docs/fr-ca/glossary?term=client-id" tip="ID client
Identifiant attribué par Auth0 à votre ressource enregistrée." cta="Voir le glossaire">Client ID</Tooltip> (ID Client), et <Tooltip href="/docs/fr-ca/glossary?term=client-secret" tip="Secret client
Secret utilisé par un client (application) pour s’authentifier auprès du serveur d’autorisation; il ne doit être connu que du client et du serveur d’autorisation et doit être suffisamment aléatoire pour ne pas être deviné." cta="Voir le glossaire">Client Secret</Tooltip> (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é](https://community.auth0.com/tags/wordpress) avec les messages d’erreur que vous voyez dans le journal d’erreurs, et nous serons heureux de vous aider!

### Option 2 : Configuration de la migration des utilisateurs

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

### Option 3 : Configuration manuelle

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.

### Option 4 : Importation de la configuration

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

## Configuration terminée

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

## Configuration manuelle

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](https://manage.auth0.com/#), 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](/docs/fr-ca/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é.

## En savoir plus

* [Intégration à WordPress](/docs/fr-ca/customize/integrations/cms/wordpress-plugin/integrate-with-wordpress)
* [Connexion par Auth0](/docs/fr-ca/customize/integrations/cms/wordpress-plugin/configure-login-by-auth0)
* [Dépannage du plugiciel WordPress Login by Auth0](/docs/fr-ca/customize/integrations/cms/wordpress-plugin/troubleshoot-login-by-auth0)
* [Plugiciel WordPress Extend Login by Auth0](/docs/fr-ca/customize/integrations/cms/wordpress-plugin/extend-login-by-auth0)