Configuration d'Auth0

Configurez un écran de connexion Auth0 pour les visiteurs de vos docs

Rendez-vous dans nos guides pour trouver un guide complet sur la configuration de l'accès authentifié et du contenu adaptatif avec Auth0.

Ce guide vous explique comment configurer un écran de connexion protégé pour votre documentation. Avant de suivre ce guide, assurez-vous d'avoir d'abord suivi Activation de l'accès authentifié.

Pour configurer votre site GitBook avec un accès authentifié en utilisant Auth0, le processus est le suivant :

1

Créer une nouvelle application dans Auth0

Créez une application Auth0 dans votre tableau de bord Auth0.

2

Installer et configurer l'intégration Auth0

Installez l'intégration Auth0 et ajoutez la configuration requise à votre site GitBook.

3

Configurer Auth0 pour le contenu adaptatif (optionnel)

Configurez Auth0 pour qu'il fonctionne avec le contenu adaptatif dans GitBook.

1. Créez 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 pour valider l'identité des utilisateurs avant de leur accorder l'accès à votre site.

1. Connectez-vous à votre Auth0 tableau de bord.

2. Accédez à Applications > Applications section depuis la barre latérale gauche.

3. Cliquez sur le + Créer une application bouton, et donnez un nom à votre application.

4. Sous l'onglet Choisissez un type d'application, sélectionnez Applications Web régulières.

5. Dans le Démarrage rapide écran de l'application nouvellement créée, sélectionnez Node.js (Express) puis Je veux intégrer mon application.

6. Vous devriez alors voir un écran de configuration comme ci-dessous. Cliquez sur Enregistrer les paramètres et continuer.

   
7. Cliquez sur le Paramètres .

8. Copiez et notez la Domaine, ID client et Secret client.

Veuillez vous assurer que vous avez au moins une connexion activée pour votre application Auth0 sous la Connexions .

2. Installer et configurer l'intégration Auth0

Une fois que vous avez créé l'application Auth0, l'étape suivante consiste à installer l'intégration Auth0 dans GitBook et à la lier à votre application Auth0 en utilisant les identifiants que vous avez générés précédemment :

1. Naviguez vers le site où vous avez activé l'accès authentifié et où vous souhaitez utiliser Auth0 comme fournisseur d'identité.

2. Cliquez sur le Intégrations bouton en haut à droite depuis les paramètres de votre site.

   
3. Cliquez sur Accès authentifié dans les catégories de la barre latérale.

4. Sélectionnez l' Auth0 intégration.

5. Cliquez sur Installer sur ce site.

   
6. Après avoir installé l'intégration sur votre site, vous devriez voir l'écran de configuration de l'intégration :

   
7. Saisissez le 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 (assurez-vous de le préfixer par https://).

8. (optionnel) Activez le Inclure les claims dans le jeton JWT option en bas de la boîte de dialogue si vous avez activé votre site pour contenu adaptatif.

9. Copiez et notez la Rappel URL affichée au bas de la boîte de dialogue.

10. Cliquez sur Enregistrer.

11. Retournez à l'application Auth0 que vous avez créée précédemment dans le tableau de bord Auth0.

12. Accédez à Applications > Applications dans la barre latérale et sélectionnez le Paramètres .

13. Faites défiler jusqu'à la URI de l'application section des paramètres

14. Collez le URL de rappel que vous avez copié précédemment depuis la boîte de dialogue d'intégration GitBook dans le URL de rappel autorisée champ de saisie.

15. Cliquez sur Enregistrer.

16. Retournez à Intégration Auth0 de l'intégration Azure dans GitBook.

17. Fermez les dialogues d'intégration et cliquez sur l'onglet Paramètres dans l'écran du site.

18. Accédez à Audience et sélectionnez Accès authentifié (si ce n'est pas déjà sélectionné).

19. Sélectionnez Auth0 depuis le menu déroulant dans la section Backend d'authentification .

20. Cliquez sur Mettre à jour l'audience.

21. Accédez à l'écran d'aperçu du site et cliquez sur Publier si le site n'est pas déjà publié.

Votre site est maintenant publié derrière un accès authentifié en utilisant votre Auth0 comme fournisseur d'identité.

Pour le tester, cliquez sur Visitez. On vous demandera 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 (optionnel)

Pour tirer parti de la fonctionnalité Contenu adaptatif sur votre site à accès authentifié, configurez l'application Auth0 pour inclure des informations utilisateur supplémentaires dans le jeton d'authentification en tant que claims.

Ces claims, représentés sous forme de paires clé-valeur, sont transmis à GitBook et peuvent être utilisés pour adapter le contenu dynamiquement pour les visiteurs de votre site.