Contrôle d’accès

Le contrôle d’accès détermine qui peut consulter votre centre d’aide, ainsi que chacune de ses sections, collections et articles. Le centre d’aide lui-même est Public ou Privé, et chaque niveau inférieur peut uniquement restreindre les personnes autorisées, jamais élargir cet accès.

Centres d’aide publics et privés

Le paramètre du centre d’aide propose les options Public et Privé sous l’intitulé Qui peut consulter votre centre d’aide. Public signifie que n’importe qui peut le parcourir. Privé signifie que les visiteurs doivent d’abord se connecter.

Au moins une méthode de connexion des visiteurs doit être activée avant de pouvoir enregistrer un centre d’aide en mode privé. Pour connaître la procédure, consultez Rendre votre centre d’aide privé.

Méthodes de connexion des visiteurs

Les méthodes de connexion fonctionnent sur les centres d’aide privés et sur les centres d’aide publics qui restreignent l’accès à certaines sections ou collections. Vous pouvez activer plusieurs méthodes à la fois, et les lecteurs voient toutes les options activées sur la page de connexion :

• Liens magiques : les lecteurs saisissent leur adresse e-mail et reçoivent un lien de connexion à usage unique. Consultez Se connecter avec les liens magiques.

• Authentification unique (OIDC) : les lecteurs se connectent via votre fournisseur d’identité. Consultez Se connecter avec l’authentification unique OIDC.

• Mot de passe partagé : un seul mot de passe pour tous les lecteurs. Les lecteurs utilisant un mot de passe partagé n’ont pas d’identité individuelle ; les restrictions par groupe d’utilisateurs ne s’appliquent donc pas à ces personnes. Consultez Mot de passe partagé.

• Se connecter avec votre produit : les lecteurs utilisent le compte qu’ils possèdent déjà dans votre application. Consultez Se connecter avec votre produit.

La hiérarchie des accès

L’accès se restreint à chaque niveau, et aucun niveau ne peut lever une restriction définie à un niveau supérieur :

• Centre d’aide : le statut Public ou Privé définit la règle de base pour tous les niveaux inférieurs.

• Section : l’éditeur de section comporte un onglet Accès avec trois choix : Hériter, Lecteurs connectés ou Groupes spécifiques. La section d’accueil suit le paramètre du centre d’aide et ne dispose d’aucun accès indépendant.

• Collection : les mêmes trois choix que pour une section.

• Article : Hériter de la collection, Toute personne connectée ou Groupes d’utilisateurs spécifiques. Un article peut uniquement restreindre l’audience de sa collection, jamais l’élargir.

Pour savoir comment définir l’accès à chaque niveau, consultez Accès aux sections et aux collections. Pour limiter l’accès des lecteurs à certains groupes, créez d’abord ces groupes : consultez Groupes d’utilisateurs.

Verrouillé ou masqué : ce que voient les lecteurs qui n’y ont pas accès

Pour chaque section ou collection dont vous restreignez l’accès, vous choisissez ce que voient les lecteurs qui n’y ont pas accès : Hériter (l’option par défaut, qui correspond à masqué), Afficher avec un cadenas ou Masquer.

Affiché avec un cadenas

Une section ou une collection verrouillée conserve son titre visible. Le titre accompagné d’une icône de cadenas apparaît dans les onglets de section, la barre latérale et les listes de collections. Lorsqu’un lecteur l’ouvre, une carte d’accès refusé s’affiche avec votre description (ou le texte par défaut, tel que « Vous n’avez pas accès à cette section. »), un bouton Se connecter pour les lecteurs déconnectés, un bouton facultatif que vous configurez et l’option Utiliser un autre compte pour les lecteurs connectés.

La recherche du centre d’aide ne trouve que le titre verrouillé. Le contenu n’est jamais affiché.

Masqué

Une section ou une collection masquée n’est répertoriée nulle part. Un lien direct renvoie une erreur 401 pour les lecteurs déconnectés ou 403 pour les lecteurs connectés qui n’y ont pas accès, et affiche la même carte d’accès refusé sans jamais révéler le titre. Les URL inconnues renvoient toujours une erreur 404 ; le contenu masqué et le contenu inexistant ne diffèrent donc que par le code d’état.

Comment les restrictions se combinent entre les niveaux

Un lecteur qui ne peut pas ouvrir un élément peut également ne pas satisfaire aux exigences des niveaux supérieurs. Commencez par le premier niveau auquel le lecteur échoue, puis suivez la chaîne jusqu’à l’élément :

• Si un niveau de cette chaîne est défini sur Masquer, l’élément est masqué.

• Si tous les niveaux de la chaîne sont définis sur Afficher avec un cadenas, l’élément s’affiche avec un cadenas. Le message du cadenas provient du niveau le plus proche de l’élément.

Deux cas particuliers :

• Une exigence définie sur l’article lui-même est toujours masquée. Elle n’affiche jamais de cadenas, même lorsque les niveaux supérieurs en affichent un.

• Dans un centre d’aide Privé, les visiteurs déconnectés ne voient absolument rien.

Où apparaissent les contenus verrouillés et masqués

Les éléments verrouillés apparaissent uniquement sur les pages du centre d’aide. Ils sont exclus du widget, de MCP, de llms.txt, du sitemap et des flux RSS.

L’assistant IA peut mentionner un article verrouillé et créer un lien vers celui-ci à partir de son titre, sans exposer son contenu. Les contenus masqués ne sont jamais mentionnés, et les lecteurs anonymes ne voient pas les noms des groupes.

Identification silencieuse avec JWT

L’identification JWT silencieuse est disponible avec tous les forfaits et dans les deux modes d’accès. Votre backend signe un JWT afin d’identifier les lecteurs sans connexion distincte au centre d’aide. Pour la configuration, consultez Authentification JWT.