> 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/adaptive-content/faq-and-troubleshooting.md).

# FAQ et dépannage

### Quelle méthode d'authentification dois-je utiliser pour le contenu adaptatif ?

Cela dépend de la manière dont vous souhaitez contrôler l'accès :

* Contenu public et privé sur un même site — utilisez [des cookies signés](/docs/documentation/fr/publier/adaptive-content/enabling-adaptive-content/cookies.md)
* Personnalisation simple sans authentification — utilisez [des paramètres d'URL](/docs/documentation/fr/publier/adaptive-content/enabling-adaptive-content/url.md)
* Un site entièrement privé — utilisez une [intégration d'accès authentifié](/docs/documentation/fr/publier/adaptive-content/enabling-adaptive-content/authenticated-access.md)
* Vous utilisez déjà des feature flags — utilisez un [fournisseur de feature flags](/docs/documentation/fr/publier/adaptive-content/enabling-adaptive-content/feature-flags.md)

### Puis-je publier un site partiellement public avec du contenu authentifié ?

Oui. Vous pouvez conserver un site public avec certaines sections authentifiées, sans exiger de connexion pour l'ensemble du site :

1. Définissez l'audience de votre site sur Public, Non répertorié ou Lien de partage.
2. Activez le contenu adaptatif dans les paramètres de votre site.
3. Utilisez [des cookies signés](/docs/documentation/fr/publier/adaptive-content/enabling-adaptive-content/cookies.md#signed-cookie) pour transmettre les revendications des visiteurs après leur connexion à votre application principale.
4. Définissez des conditions sur les pages ou sections spécifiques qui ne doivent s'afficher que pour les visiteurs authentifiés.

### Comment configurer le contenu adaptatif avec un fournisseur OIDC personnalisé ?

Le contenu adaptatif fonctionne avec n'importe quel fournisseur d'identité :

1. Configurez l'intégration OIDC générique dans GitBook.
2. Configurez votre fournisseur OIDC pour inclure des revendications personnalisées dans les jetons.
3. Mappez ces revendications dans votre schéma de visiteur GitBook.

Problèmes courants : assurez-vous que votre fournisseur inclut les revendications personnalisées dans le jeton (et pas seulement les revendications OIDC standard), vérifiez si les revendications sont imbriquées sous des propriétés spécifiques au fournisseur, et contrôlez le format du jeton. Les différents fournisseurs structurent les revendications personnalisées différemment — consultez la documentation de votre fournisseur.

### Pourquoi mes segments ne fonctionnent-ils pas ou ne s'affichent-ils pas en aperçu ?

* Vérifiez que votre schéma de visiteur est correctement défini.
* Vérifiez que le JSON de votre segment correspond à la structure du schéma.
* Assurez-vous que la condition s'applique à la section, la page ou le bloc que vous testez.
* Utilisez la fonctionnalité d'aperçu depuis la bonne page et actualisez l'aperçu après les modifications du schéma.

Voir [Tester avec des segments](/docs/documentation/fr/publier/adaptive-content/testing-with-segments.md) pour le flux de test complet.

### Le contenu restreint apparaît-il dans les résultats de recherche ?

Non. Les résultats de recherche ne reflètent que le contenu auquel un visiteur a accès. Toute section, page ou bloc derrière un contenu adaptatif n'est indexé et visible dans la recherche que pour les visiteurs qui remplissent les conditions pour le voir.

### Les schémas de revendications JWT prennent-ils en charge les chaînes libres ?

Pas encore. Les schémas de revendications ne prennent actuellement en charge que les énumérations pour les valeurs de chaîne ; définissez donc toutes les valeurs de chaîne requises dans une énumération.

### Le contenu adaptatif peut-il fonctionner avec des tableaux dans les revendications JWT ?

Non. Une revendication fournit une seule valeur — une chaîne (énumération) ou un booléen. Si vous avez besoin de plusieurs valeurs, transformez-les du côté du fournisseur de revendications (par exemple, dans Azure ou Okta).

### Comment déboguer les conditions du contenu adaptatif ?

* Les noms de propriétés respectent la casse (`rôle` ≠ `Rôle`).
* Vérifiez les types de données — booléen `vrai` n'est pas la chaîne `"true"`.
* Vérifiez le chemin de propriété dans les conditions imbriquées.
* Inspectez les revendications associées à un jeton sur [jwt.io](https://www.jwt.io/) pour confirmer que les revendications attendues sont bien transmises.


---

# 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/adaptive-content/faq-and-troubleshooting.md?ask=<question>&goal=<endgoal>
```

`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.