Configuration d’Azure AD

Aperçu

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

1. Créer un enregistrement d'application dans Azure AD

Commencez par créer un enregistrement d'application dans votre tableau de bord Microsoft Entra ID. Cet enregistrement d'application permettra à l'intégration GitBook Azure AD de demander des jetons pour valider l'identité de l'utilisateur avant de lui accorder l'accès à votre site.

1. Connectez-vous à votre administration Microsoft Entra ID tableau de bord.

2. Allez dans Identité > Applications > Enregistrements d'applications dans la barre latérale gauche.

3. Cliquez sur + Nouvelle inscription, et donnez un nom à votre inscription.

4. Sous Types de comptes pris en charge, sélectionnez «Comptes dans ce répertoire organisationnel uniquement (Répertoire par défaut uniquement - Locataire unique) ».

5. Laissez le champ URI de redirection vide pour l'instant — vous devrez le remplir plus tard.

6. Cliquez sur Inscrire pour terminer l'enregistrement de l'application.

   
7. Vous devriez alors voir votre nouvel enregistrement d'application Aperçu écran. Copiez et notez le ID d'application (client) et ID de répertoire (locataire).

   
8. Cliquez sur Ajouter un certificat ou un secret. Vous devriez voir l'écran suivant Certificats et secrets écran :

   
9. Cliquez sur + Nouveau secret client.

10. Entrez une description appropriée pour le secret et cliquez sur Ajouter.

11. Copiez et notez le Valeur champ (pas l'ID du secret) du secret que vous venez de créer.

2. Installer et configurer l'intégration Azure AD

Une fois que vous avez créé l'enregistrement d'application Azure AD, l'étape suivante consiste à installer l'intégration Azure AD dans GitBook et à la lier à votre application Azure à 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 Azure AD comme fournisseur d'identité.

2. Cliquez sur le 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' Azure 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 l' ID client, ID locataire, et Secret client valeurs que vous avez copiées après avoir créé l'enregistrement d'application Azure AD précédemment, puis cliquez sur « Enregistrer ».

8. Copiez l' URL affichée en bas de la boîte de dialogue.

9. Retournez à l'enregistrement d'application Azure AD que vous avez créé précédemment dans le tableau de bord Microsoft Entra ID.

10. Accédez à Gérer > Authentification dans la barre latérale.

11. Cliquez sur + Ajouter une plateforme et sélectionnez Web carte dans le panneau qui s'ouvre.

    
12. Collez l'intégration GitBook URL que vous avez copiée précédemment dans le champ URI de redirection , puis cliquez sur « Configurer »

    
13. Retournez à intégration Azure écran d'installation dans GitBook.

14. Fermez les boîtes de dialogue d'intégration et cliquez sur l'onglet Paramètres dans l'écran du site.

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

16. Sélectionnez Azure dans le menu déroulant du backend d'authentification section.

17. Cliquez sur Mettre à jour l'audience.

    
18. Allez sur 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 Azure AD comme fournisseur d'identité.

Pour le tester, cliquez sur Visiter. Il vous sera demandé de vous connecter avec Azure, ce qui confirme que votre site est publié derrière un accès authentifié utilisant Azure.

3. Configurer Azure AD pour le contenu adaptatif (optionnel)

Pour exploiter la fonctionnalité de contenu adaptatif sur votre site à accès authentifié, configurez l'enregistrement d'application Azure AD 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.

Azure AD prend en charge différents types et niveaux de revendications, chacun avec sa propre méthode de configuration :

• Revendications standard : Revendications courantes qui peuvent être incluses dans les jetons mais ne sont pas toujours présentes par défaut.

• Revendications optionnelles : Revendications prédéfinies supplémentaires qui peuvent être activées pour une application.

• Revendications personnalisées : Revendications provenant d'attributs utilisateur personnalisés dans Azure AD ou de systèmes externes via un fournisseur de revendications personnalisé.

Pour plus de détails sur la façon d'inclure ces différents types de revendications dans les jetons générés par votre application Azure AD, consultez les guides de documentation Microsoft Entra suivants :

• Attributs utilisateur

• Revendications optionnelles

• Revendications personnalisées

Après avoir configuré les bonnes revendications à envoyer à GitBook, rendez-vous sur «Adapter votre contenu» pour continuer la configuration de votre site.