Configuration d’Auth0

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

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 Auth0 de GitBook de demander des jetons pour valider l'identité de l'utilisateur avant de lui accorder l'accès à votre site.

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

2. Allez dans Applications > Applications section dans la barre latérale gauche.

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

4. Sous la rubrique Choisissez un type d'application, sélectionnez Applications Web classiques.

5. Dans l'écran Démarrage rapide de la nouvelle application 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 bouton Onglet Paramètres.

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

2. Installez et configurez l'intégration Auth0

Une fois l'application Auth0 créée, l'étape suivante consiste à installer l'intégration Auth0 dans GitBook et à la lier à votre application Auth0 à l'aide des identifiants générés précédemment :

1. Accédez au site où vous avez activé l'accès authentifié et souhaitez utiliser Auth0 comme fournisseur d'identité.

2. Cliquez sur le bouton Intégrations bouton en haut à droite dans 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'intégration Auth0 .

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 les Domaine, ID client et le 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 l'option Inclure les revendications dans le jeton JWT en bas de la boîte de dialogue si vous avez activé votre site pour le contenu adaptatif.

9. Copiez et notez le URL de rappel affichée en 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. Allez dans Applications > Applications dans la barre latérale et sélectionnez le Onglet Paramètres.

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

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

15. Cliquez sur Enregistrez.

16. Retournez à l'écran d' installation de l'intégration Auth0 dans GitBook ..

17. Fermez les boîtes de dialogue d'intégration et cliquez sur l'onglet Onglet dans l'écran du site.

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

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

20. Cliquez sur Mettre à jour l'audience.

21. Allez dans 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é utilisant votre Auth0 comme fournisseur d'identité.

Pour tester, cliquez sur Visiter. 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. Configurez Auth0 pour le contenu adaptatif (optionnel)

Pour exploiter la capacité 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.