FAQ et dépannage

Questions fréquentes et étapes de dépannage pour le contenu adaptatif

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 seul site — utilisez des cookies signés
• Personnalisation simple sans authentification — utilisez des paramètres d’URL
• Un site entièrement privé — utilisez une intégration d’accès authentifié
• Vous utilisez déjà des feature flags — utilisez un fournisseur de feature flags

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 une 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 pour transmettre les revendications du visiteur après qu’il s’est connecté à votre application principale.
4. Définissez des conditions sur les pages ou sections spécifiques qui doivent s’afficher uniquement 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 vérifiez 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 dans l’aperçu ?

• Confirmez que votre schéma de visiteur est correctement défini.
• Vérifiez que votre JSON de segment correspond à la structure du schéma.
• Assurez-vous que la condition s’applique à la section, à la page ou au 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 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 le contenu adaptatif n’est indexé et visible dans la recherche que pour les visiteurs qui remplissent les conditions pour le consulter.

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

Pas encore. Les schémas de revendications prennent actuellement en charge uniquement les énumérations pour les valeurs de chaîne, donc définissez 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 sont sensibles à la casse (role ≠ Role).
• Vérifiez les types de données — booléen vrai n’est pas la chaîne "true".
• Vérifiez le chemin de la propriété dans les conditions imbriquées.
• Inspectez les revendications attachées à un jeton sur jwt.io pour confirmer que les revendications attendues sont bien transmises.