> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/fr/publier/site-audience/authenticated-access/setting-up-okta.md).
# Configuration d’Okta
Configurez un écran de connexion Okta pour les visiteurs de votre documentation
{% hint style="warning" %}
Ce guide vous accompagne dans la mise en place d’un écran de connexion protégé pour votre documentation. Avant de suivre ce guide, assurez-vous d’avoir d’abord suivi le processus de [l’activation de l’accès authentifié](/docs/documentation/fr/publier/site-audience/authenticated-access/enabling-authenticated-access.md).
{% endhint %}
Pour configurer votre site GitBook avec un accès authentifié à l’aide d’Okta, le processus se présente comme suit :
{% stepper %}
{% step %}
**Créer une nouvelle application Okta**
Créez une application Okta depuis votre tableau de bord Okta.
{% endstep %}
{% step %}
**Installer et configurer l’intégration Okta**
Installez l’intégration Okta et ajoutez la configuration requise.
{% endstep %}
{% step %}
**Configurer Okta pour le contenu adaptatif (facultatif)**
Configurez Okta pour qu’il fonctionne avec le contenu adaptatif dans GitBook.
{% endstep %}
{% endstepper %}
### 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.
Nommez-la de manière appropriée et ne modifiez aucun autre paramètre sur cette page. Pour les affectations, cochez la case appropriée. Cliquez sur Enregistrer.
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 le menu déroulant 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 du site que vous souhaitez publier et repérez l’intégration Okta.
Installez l’intégration sur votre site.
Après l’installation sur le site, un écran s’affichera vous demandant de saisir le Client ID, le domaine Okta et le Client Secret.
Pour le Client ID, le domaine Okta (supprimez `https://`le préfixe, le cas échéant) et le Client Secret, collez la valeur que vous avez copiée depuis le tableau de bord Okta.
Cliquez sur Enregistrer.
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 Enregistrer.
Maintenant, dans GitBook, fermez la fenêtre modale des intégrations et cliquez sur le bouton Gérer le site. Accédez à **Audience**, sélectionnez **Accès authentifié**, et choisissez Okta comme backend. Ensuite, cliquez sur **Mettre à jour l’audience**. Rendez-vous sur l’écran du site et cliquez sur **Publier**.\
\
Le site est maintenant publié derrière un accès authentifié contrôlé par votre application Auth0. Pour l’essayer, cliquez sur Visiter. 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 dans 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 abonnement, de sa localisation ou de tout autre attribut d’identification.
Okta prend en charge plusieurs types de claims :
* **Claims standard**\
Il s’agit de claims courants (comme `email`, `name`, ou `groups`) qui peuvent être inclus par défaut, mais qui doivent souvent être ajoutés explicitement à la configuration de votre jeton pour garantir leur disponibilité.
* **Claims personnalisés**\
Vous pouvez définir des claims personnalisés dans Okta à l’aide de [attributs utilisateur personnalisés](https://help.okta.com/en-us/content/topics/users-groups-profiles/usgp-add-custom-user-attributes.htm) 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 interne.
* **Groupes comme claims**\
Vous pouvez également transmettre des groupes Okta en tant que claims, ce qui est particulièrement utile lors de la définition de segments d’audience comme « utilisateurs entreprise » ou « bêta-testeurs ». 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 à **Sécurité > API > Serveurs d’autorisation**.
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 de [Adapter votre contenu](/docs/documentation/fr/publier/adaptive-content/adapting-your-content.md) pour définir quel contenu doit être affiché à qui.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://gitbook.com/docs/documentation/fr/publier/site-audience/authenticated-access/setting-up-okta.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
