Configuration d’Auth0
Configurez un écran de connexion Auth0 pour les visiteurs de votre documentation
Ce guide vous accompagne dans la configuration d’un écran de connexion protégé pour votre documentation. Avant de suivre ce guide, assurez-vous d’avoir d’abord parcouru Activation de l’accès authentifié.
Pour configurer votre site GitBook avec un accès authentifié à l’aide d’Auth0, le processus est le suivant :
Créez une application Auth0 dans votre tableau de bord Auth0.
Installez l’intégration Auth0 et ajoutez la configuration requise à votre site GitBook.
Configurez Auth0 pour fonctionner avec le contenu adaptatif dans GitBook.
1. Créer une nouvelle application dans Auth0
Commencez par créer une nouvelle application dans le tableau de bord de votre plateforme Auth0. Cette application permettra à l’intégration GitBook Auth0 de demander des jetons afin de valider l’identité de l’utilisateur avant de lui accorder l’accès à votre site.
Connectez-vous à Auth0 tableau de bord.
Accédez à Applications > Applications section dans la barre latérale gauche.
Cliquez sur le + Créer une application bouton, puis donnez un nom à votre application.
Sous l’onglet Choisissez un type d’application, sélectionnez Applications Web classiques.
Dans le Démarrage rapide sur l’écran de la nouvelle application, sélectionnez Node.js (Express) puis Je veux intégrer mon application.
Vous devriez alors voir un écran de configuration comme ci-dessous. Cliquez sur Enregistrer les paramètres et continuer.
Cliquez sur le Paramètres onglet.
Copiez et notez le Domaine, ID client et Secret client.
Veuillez vous assurer que vous avez au moins une connexion activée pour votre application Auth0 dans la Connexions onglet.
2. Installer et configurer l’intégration Auth0
Une fois l’application Auth0 créée, l’étape suivante consiste à installer l’intégration Auth0 dans GitBook et à la relier à votre application Auth0 à l’aide des identifiants générés précédemment :
Accédez au site sur lequel vous avez activé l’accès authentifié et où vous souhaitez utiliser Auth0 comme fournisseur d’identité.
Cliquez sur le Intégrations bouton en haut à droite dans les paramètres de votre site.
Cliquez sur Accès authentifié dans les catégories de la barre latérale.
Sélectionnez la Auth0 intégration.
Cliquez sur Installer sur ce site.
Après avoir installé l’intégration sur votre site, vous devriez voir l’écran de configuration de l’intégration :
Saisissez les valeurs Domaine, ID client et Secret client valeurs que vous avez copiées après avoir créé l’application Auth0 précédemment. Pour le domaine Auth0, saisissez le domaine copié depuis Auth0 (veillez à le préfixer avec
https://).(facultatif) Activez l’ Inclure les revendications dans le jeton JWT option en bas de la boîte de dialogue si vous avez activé votre site pour contenu adaptatif.
Copiez et notez le Callback URL affichée au bas de la boîte de dialogue.
Cliquez sur Enregistrer.
Retournez à l’application Auth0 que vous avez créée précédemment dans le tableau de bord Auth0.
Accédez à Applications > Applications dans la barre latérale, puis sélectionnez le Paramètres onglet.
Faites défiler jusqu’à la URI de l’application section des paramètres
Collez le URL de callback que vous avez copiée précédemment depuis la boîte de dialogue d’intégration GitBook dans le URL de callback autorisée champ de saisie.
Cliquez sur Enregistrez.
Retournez à Intégration Auth0 écran d’installation dans GitBook.
Fermez les boîtes de dialogue de l’intégration et cliquez sur le Paramètres onglet dans l’écran du site.
Accédez à Audience et sélectionnez Accès authentifié (si ce n’est pas déjà sélectionné).
Sélectionnez Auth0 dans le menu déroulant du backend d’authentification section.
Cliquez sur Mettre à jour l’audience.
Rendez-vous sur l’écran d’aperçu du site et cliquez sur Publier si le site n’est pas déjà publié.
Votre site est désormais publié derrière un accès authentifié en utilisant Auth0 comme fournisseur d’identité.
Pour le tester, cliquez sur Visitez. Il vous sera demandé de vous connecter avec Auth0, ce qui confirme que votre site est publié derrière un accès authentifié utilisant Auth0.
3. Configurer Auth0 pour le contenu adaptatif (facultatif)
Pour tirer parti de la fonctionnalité de contenu adaptatif sur votre site à accès authentifié, configurez l’application Auth0 pour inclure des informations utilisateur supplémentaires dans le jeton d’authentification sous forme de revendications.
Ces revendications, représentées sous forme de paires clé-valeur, sont transmises à GitBook et peuvent être utilisées pour adapter le contenu dynamiquement pour les visiteurs de votre site.
Mis à jour
Ce contenu vous a-t-il été utile ?