L’accès au contenu contrôle les espaces de travail, langues et catégories qui apparaissent dans le widget de la base de connaissances. Vous pouvez configurer cela même lorsque JWT est activé, ce qui vous donne la flexibilité de restreindre ce que voient les utilisateurs finaux sans nécessiter de modifications d’accès individuelles. Lorsqu’un lecteur se connecte, le système valide les permissions de son groupe de lecteurs contre les filtres d’accès au contenu au niveau des widgets — seule l’intersection des deux est indiquée.
Quand configurer l’accès au contenu
- Vous voulez que le widget affiche uniquement du contenu provenant d’un espace de travail ou d’une zone produit spécifique.
- Votre base de connaissances comporte plusieurs espaces de travail et le widget ne devrait en afficher qu’un seul.
- Vous voulez restreindre la visibilité à des catégories spécifiques pour un widget particulier.
- Vous utilisez JWT avec des groupes de lecteurs et souhaitez que la portée des widgets corresponde aux permissions des groupes.
Comment configurer l’accès au contenu
- Naviguez vers Connexions () > widget de la base de connaissances dans la barre de navigation de gauche.
- Surcassez le widget souhaité et cliquez sur l’icône Modifier ().
- Dans l’onglet Configurer & connecter , développez la section Accès au contenu .
- Sélectionnez le niveau de filtre souhaité :
- Projet — Tous les espaces de travail et langages
- Espace de travail — Un ou plusieurs espaces de travail et langages spécifiques
- Catégorie — Une ou plusieurs catégories spécifiques
- Choisissez les espaces de travail, les langues et les catégories souhaités à afficher dans le widget.
- Cliquez sur Terminé, puis cliquez sur Enregistrer pour appliquer les modifications.
Validation des autorisations de contenu des groupes de lecteurs
Lorsqu’un lecteur se connecte, le système valide si les permissions de son groupe de lecteurs correspondent aux filtres d’accès au contenu du widget. Seules les permissions intersectantes entre les paramètres au niveau du widget et celles du groupe de lecteurs sont prises en compte pour la validation. Cela garantit que les utilisateurs ne voient que les articles pour lesquels ils sont autorisés.
La même validation s’applique lorsque les lecteurs cliquent sur des liens internes à l’intérieur du widget. Le widget vérifie les filtres d’accès au contenu configurés, la portée de l’espace de travail et les permissions des groupes de lecteurs avant de charger le contenu de destination. Si le contenu lié sort de la portée autorisée, le widget affiche un état d’accès restreint au lieu de rendre l’article.
Les modifications apportées à l’accès au contenu auront un impact direct sur votre mappage d’URL. Si vous modifiez les paramètres de filtre du widget, la correspondance d’URL existante peut être supprimée, ce qui entraîne des liens cassés.
Vous ne pouvez configurer les correspondances d’URL qu’à partir des articles inclus dans le contenu actuel du widget Filtre.
Exemple 1 : Vous avez défini le contenu du widget de filtre au niveau du projet et configuré une correspondance d’URL incluant une liste d’articles de la Catégorie A dans Workspace V1. Si vous mettez à jour les paramètres du filtre pour n’afficher que les catégories B et C dans le même espace de travail, le mappage d’URL précédent devient invalide — car les articles initialement mappés de la catégorie A ne sont plus disponibles dans le widget.
Exemple 2 : Si le widget est filtré pour afficher uniquement le contenu de Workspace V1, vous ne pouvez pas créer de correspondance d’URL pour un article situé dans Workspace V2.
Consultez toujours et mettez à jour les correspondances d’URL après avoir modifié les paramètres d’accès au contenu.
Meilleures pratiques
- Utilisez l’accès au niveau des catégories uniquement lorsque vous avez besoin d’un contenu widget très strict. Le compromis est que vous devez maintenir manuellement la liste des catégories au fur et à mesure que de nouvelles catégories sont ajoutées.
- Après avoir modifié l’accès au contenu, testez le widget en naviguant vers chaque URL mappée pour confirmer que les articles attendus apparaissent toujours.
FAQ
Pourquoi certaines catégories manquent-elles dans le widget de la base de connaissances ?
Cela peut se produire si l’accès au niveau de la catégorie n’a pas été correctement configuré pour le widget. Pour garantir que vos catégories soient visibles :
Vérifiez que le lecteur a la permission de consulter les catégories spécifiques dans le widget de la base de connaissances.
Vérifiez si l’accès au niveau de la catégorie est configuré. Si c’est le cas, ajoutez manuellement la catégorie souhaitée dans la section accès au contenu.
Pour ajouter la catégorie manquante au widget :
Naviguer vers Connexions () > widget de la base de connaissances.
Surcassez le widget souhaité et cliquez sur l’icône Modifier ().
Dans l’onglet Configurer & connecter , développez l’accordéon d’accès au contenu .
Sélectionnez Catégorie et choisissez la catégorie souhaitée qui apparaîtra dans le widget.
Cliquez sur Enregistrer pour appliquer les modifications.
Pourquoi un lien d’article s’ouvre-t-il à l’intérieur du widget au lieu d’un nouvel onglet ?
Le widget de la base de connaissances détermine le comportement des liens en fonction du type d’espace de travail de destination et de l’éligibilité à l’accès.
Le paramètre Ouvrir dans un nouvel onglet configuré dans l’éditeur n’est pas pris en charge dans le widget. Les liens internes dans un même domaine s’ouvrent toujours à l’intérieur du widget, quel que soit le paramètre sélectionné.
Les articles dans les espaces de travail standards s’ouvrent à l’intérieur du widget.
Les articles dans d’autres espaces de travail standards s’ouvrent également à l’intérieur du widget lorsqu’ils sont inclus dans la configuration d’accès au contenu du widget.
Les liens de documentation API s’ouvrent toujours dans un nouvel onglet du navigateur.
Les liens de domaine externes s’ouvrent toujours dans un nouvel onglet du navigateur.
Si le contenu de destination est restreint, le widget affiche un état d’accès restreint.
Si la destination ne peut pas être résolue, le widget affiche un état de secours.
Pourquoi un lien d’article interne indique-t-il un accès restreint à l’intérieur du widget ?
Cela se produit lorsque l’article lié est en dehors du champ d’accès au contenu configuré par le widget ou que le lecteur n’a pas la permission de son groupe de lecteurs assigné.
Vérifiez que :
L’espace de travail de destination est inclus dans la configuration du widget.
La catégorie liée se trouve dans le champ de filtres autorisé.
Le lecteur a accès via le groupe de lecteurs assigné.
Si le contenu de destination est en dehors de la portée autorisée, le widget affiche intentionnellement un état d’accès restreint.