Configuration d’Okta

Configurez un écran de connexion Okta pour les visiteurs de votre documentation

Ce guide vous accompagne dans la configuration d’un écran de connexion protégé pour vos docs. Avant de suivre ce guide, assurez-vous d’abord d’avoir parcouru le processus de l’activation de l’accès authentifié.

Pour configurer votre site GitBook avec un accès authentifié à l’aide d’Okta, le processus est le suivant :

1

Créer une nouvelle application Okta

Créez une application Okta depuis votre tableau de bord Okta.

2

Installer et configurer l’intégration Okta

Installez l’intégration Okta et ajoutez la configuration requise.

3

Configurer Okta pour le contenu adaptatif (facultatif)

Configurez Okta pour fonctionner avec le contenu adaptatif dans GitBook.

Créer une nouvelle application Okta

Tout d’abord, connectez-vous à la plateforme Okta (la version administrateur) et créez une nouvelle intégration d’application (ou utilisez-en une existante) en cliquant sur le bouton Applications dans la barre latérale gauche.

Cliquez sur Create App Integration et sélectionnez OIDC - OpenID Connect comme méthode de connexion. Sélectionnez ensuite Web Application comme type d’application.

Donnez-lui un nom approprié et ne modifiez aucun autre paramètre sur cette page. Pour les attributions, cochez la case appropriée. Cliquez sur Save.

Sur l’écran suivant, copiez le Client ID et le Client Secret. Copiez le domaine Okta juste sous votre adresse e-mail en cliquant sur la liste déroulante en haut à droite.

Nous aurons besoin de ces valeurs pour configurer l’intégration Okta.

Installer et configurer l’intégration Okta

Accédez à l’onglet Integrations sur le site que vous souhaitez publier et localisez l’intégration Okta.

Installez l’intégration sur votre site.

Lors de l’installation sur le site, un écran vous demandera de saisir le Client ID, le domaine Okta et le Client Secret.

Pour le Client ID, le domaine Okta (supprimez https://le préfixe, s’il y en a un) et le Client Secret, collez la valeur que vous avez copiée depuis le tableau de bord Okta.

Cliquez sur Save.

Copiez l’URL affichée dans la fenêtre modale et saisissez-la comme URI de redirection de connexion dans Okta (comme indiqué dans la capture d’écran ci-dessous). Cliquez sur Save.

Maintenant, dans GitBook, fermez la fenêtre modale des intégrations et cliquez sur le bouton Manage site. Accédez à Public, sélectionnez Accès authentifié, et choisissez Okta comme backend. Ensuite, cliquez sur Mettre à jour l’audience. Allez à l’écran du site et cliquez sur PublierLe site est désormais publié derrière un accès authentifié contrôlé par votre application Auth0. Pour l’essayer, cliquez sur Visit. Il vous sera demandé de vous connecter avec Okta, ce qui confirme que votre site est publié derrière un accès authentifié à l’aide d’Auth0.

Configurer Okta pour le contenu adaptatif (facultatif)

Pour activer le contenu adaptatif sur votre site GitBook avec un accès authentifié, vous devrez configurer votre application Okta afin d’inclure les données utilisateur pertinentes sous forme de claims dans le jeton d’authentification.

Les claims sont des paires clé-valeur intégrées dans le jeton envoyé à GitBook. Ces claims peuvent être utilisés pour adapter dynamiquement la documentation en fonction du rôle de l’utilisateur, de son plan, de sa localisation ou de tout autre attribut d’identification.

Okta prend en charge plusieurs types de claims :

• Revendi­cations standard Ce sont des claims courants (comme e-mail, name, ou groupes) qui peuvent être inclus par défaut, mais doivent souvent être ajoutés explicitement à la configuration de votre jeton pour être disponibles de manière cohérente.

• Revendications personnalisées Vous pouvez définir des claims personnalisés dans Okta à l’aide de attributs utilisateur personnalisés ou d’une logique basée sur des expressions. Cela vous permet de transmettre des valeurs très spécifiques, comme le niveau d’abonnement, l’ID du compte ou des indicateurs d’équipe internes.

• Groupes comme claims Vous pouvez également transmettre des groupes Okta sous forme de claims, ce qui est particulièrement utile pour définir des segments d’audience comme « utilisateurs entreprise » ou « testeurs bêta ». Ceux-ci peuvent être filtrés et mappés dans la configuration des claims de votre serveur d’autorisation.

Pour ajouter ou personnaliser des claims dans Okta :

1. Ouvrez votre console d’administration Okta.

2. Accédez à Security > API > Authorization Servers.

3. Modifiez le serveur d’autorisation utilisé pour votre site GitBook.

4. Sous l’onglet Claims , ajoutez des règles pour inclure les claims souhaités dans le jeton.

5. Assurez-vous que votre site GitBook lit et mappe correctement ces claims.

Une fois que les claims sont transmis à GitBook, suivez les étapes dans Adapter votre contenu pour définir quel contenu doit être affiché à qui.