L’accès du lecteur fait référence au paramètre de visibilité dans votre projet Document360 qui détermine qui peut consulter le contenu de votre site de base de connaissances.
Accès à la page d’accès du lecteur
Pour gérer vos paramètres d’accès aux lecteurs :
Naviguez dans () > Users & permissions dans la barre de navigation de gauche du portail de la base de connaissances.
Dans le panneau de navigation de gauche, naviguez jusqu’à Reader access.
Visibilité du site de la base de connaissances pour le projet
Il existe trois types de modes d’accès au lecteur dans Document360 :
Accès public
Un site de base de connaissances publiques est accessible à toute personne sur Internet. Les utilisateurs de Rpeuvent accéder au contenu publié via des liens directs ou des moteurs de recherche ; Aucune connexion n’est requise.
Voici quelques-uns des cas d’usage courants
Support client Site de la base de connaissances
Centre d’aide aux produits
Portail libre-service
Documentation publique de l’API
Guides d’utilisation et manuels
Accès privé
Une base de connaissances privées est réservée aux utilisateurs autorisés uniquement. Le contenu n’est accessible qu’aux utilisateurs ou aux utilisateurs de R, et une connexion est requise.
Voici quelques-uns des cas d’usage courants
Base de connaissances du support informatique interne
Politiques et procédures RH
Documentation à l’échelle de l’entreprise
Documentation interne de l’API
Manuels de logiciels propriétaires
Accès mixte
Une base de connaissances mixte vous permet de configurer une combinaison de contenu public et privé. Certaines sections restent publiques, tandis que d’autres ne sont visibles que par les lecteurs connectés.
Voici quelques-uns des cas d’usage courants
Articles de soutien public avec documentation interne
Centre d’aide orienté client avec une base de connaissances RH interne
API publiques avec notes internes pour les développeurs
Ressources de conformité avec contenu d’audit privé
Guides publics pour développeurs avec documentation technique privée
Projets, espaces de travail et langages
Dans cette section, vous pouvez consulter la structure de votre projet, y compris le nombre d’espaces de travail et de langues. Ces informations sont disponibles uniquement pour les projets privés et mixtes.
Si votre projet est public, toute la base de connaissances est accessible à tous.
Pour les projets mixtes, vous pouvez marquer certains espaces de travail ou langages comme publics ou privés, permettant un contrôle granulaire sur qui peut accéder à quelles parties de votre base de connaissances.
.png)
Gérer l’accès au contenu
Cette section n’est visible que si votre projet est réglé en accès privé ou mixte .
En haut, vous trouverez deux onglets :
Lecteurs : Liste tous les comptes des lecteurs.
Groupes de lecteurs : Liste tous les groupes de lecteurs.
Accès hérité par blocage
Le bouton d’accès hérité par bloc n’est disponible que lorsqu’un espace de travail ou une langue spécifique est sélectionné dans la vue arborescente à gauche.
Une fois activés, les lecteurs hérités et futurs ou les groupes de lecteurs n’auront plus accès à l’espace de travail ou à la langue sélectionnée. Les lecteurs ou groupes de lecteurs ajoutés directement à ce niveau continueront d’y avoir accès.
Pour plus d’informations, consultez l’article sur l’héritage de blocs.
Gérer les lecteurs individuels
Dans l’onglet Lecteurs , sélectionnez un lecteur, et vous pouvez soit refuser () soit retirer () leur accès.
Refuser () : Restreint l’accès du lecteur à un contenu spécifique. Si l’accès est refusé à un lecteur ou à un groupe de lecteurs à quelque niveau que ce soit, ils ne pourront pas accéder à ce contenu, même s’ils héritent des autorisations d’accès d’une catégorie parente.
Supprimer () : Supprime l’accès explicite du lecteur à ce niveau. Le lecteur peut toujours y avoir accès par héritage au niveau parental. Pour comprendre comment cela fonctionne, consultez la section Compréhension de la préséance de permission.
Lecteurs de filtres
Vous pouvez filtrer les lecteurs selon leur niveau d’accès :
Projet
Espace de travail
Langue
NOTE
Si votre niveau d’accès au contenu est configuré au-delà du niveau du projet (comme l’espace de travail ou le langage), vous pouvez refuser l’accès à certains lecteurs en conséquence.
Votre base de connaissances peut inclure à la fois des articles privés et publics , selon la configuration d’accès du lecteur.
Attribution d’un accès au lecteur
Vous pouvez explicitement attribuer un accès au lecteur à n’importe quel niveau ; espace de travail, langue, catégorie ou article, pour contrôler qui peut consulter un contenu spécifique.
NOTE
Cela est particulièrement important après l’utilisation de l’héritage de blocs, car tout accès précédemment hérité est supprimé et les lecteurs doivent être réintégrés explicitement à ce niveau.
Au niveau de l’espace de travail ou de la langue :
Va dans Paramètres ()> Utilisateurs et permissions > Accès du lecteur.
Sélectionnez l’espace de travail et le langage où l’héritage a été bloqué.
Cliquez sur Attribuer l’accès et sélectionnez les lecteurs ou groupes de lecteurs qui ont besoin d’accès.
Cliquez sur Postuler.
Seuls les lecteurs que vous ajoutez explicitement au niveau de l’espace de travail ou de la langue pourront voir ce contenu sur le site de la base de connaissances.
Au niveau des catégories ou des articles :
Allez dans Documentation () et surveillez la catégorie ou l’article.
Cliquez sur plus () > Sécurité > Contrôle d’accès au site de la base de connaissances.
Dans le panneau, cliquez sur Attribuer accès.
Sélectionnez les lecteurs ou les groupes de lecteurs et cliquez sur Appliquer.
Seuls les lecteurs que vous ajoutez explicitement au niveau de la catégorie ou de l’article pourront voir ce contenu sur le site de la base de connaissances.
Rétablir l’accès au lecteur refusé
Pour rétablir l’accès aux lecteurs privés :
Naviguez dans () > Users & permissions dans la barre de navigation de gauche du portail de la base de connaissances.
Dans le panneau de navigation de gauche, naviguez jusqu’à Reader access.
Dans la page Reader access , cliquez sur Attribuer l’accès au projet.
La boîte de dialogue Assigner l’accès au projet : Projet complet apparaît.Utilisez la barre de recherche pour trouver les lecteurs désirés.
Sélectionnez les lecteurs ou les groupes de lecteurs.
Cliquez sur Postuler.
Une fois assignés, ces readers auront accès à l’ensemble de la base de connaissances.
Comprendre la préséance d’autorisation
Dans Document360, les permissions de lecteur suivent une hiérarchie du niveau le plus élevé au niveau le plus spécifique. Cela aide à déterminer comment les lecteurs acquièrent au contenu.
Hiérarchie des permissions
Les permissions s’écoulent dans cet ordre :
Project → Workspace → Language → Category → Article
Lorsqu’un lecteur reçoit un accès à un niveau supérieur, cet accès s’applique automatiquement à tout ce qui est en dessous. On parle d’accès hérité car le lecteur reçoit un accès depuis un niveau parent.
Si vous donnez ensuite au même lecteur un accès direct à un niveau inférieur, cette autorisation directe passe avant celle héritée. On appelle cela l’accès explicite car le lecteur a été ajouté directement à ce niveau spécifique.
Par exemple, si le lecteur A a accès au niveau anglophone, il obtient automatiquement l’accès à toutes les catégories et articles sous la catégorie anglaise. C’est un accès hérité.
Si vous donnez ensuite au lecteur un accès direct à une catégorie spécifique, cette autorisation directe devient l’autorisation active pour cette catégorie et tout ce qui s’y trouve, tandis que le reste du contenu en anglais continue d’utiliser l’accès hérité.
Mise à jour des paramètres d’accès au lecteur
Pour mettre à jour le mode d’accès au lecteur de votre projet :
Naviguez dans () > Users & permissions dans la barre de navigation de gauche du portail de la base de connaissances.
Dans le panneau de navigation de gauche, naviguez jusqu’à Reader access.
Votre mode d’accès lecteur actuel sera sélectionné.
Choisissez entre public, privé ou mixte.
Cliquez sur le mode souhaité pour mettre à jour la visibilité de votre projet.
Dans la boîte de dialogue de confirmation d’accès du lecteur de mise à jour , saisissez le sous-domaine de votre projet (par exemple,
document360-demo).Cliquez sur Oui pour confirmer.
NOTE
En passant de Mixte à Privé ou de Privé à Mixte, vous pourriez envisager de reconsidérer les autorisations d’accès précédemment attribuées.
Dépannage
Cette section propose des solutions étape par étape pour les problèmes courants de connexion et d’activation, tels que l’absence d’e-mails d’activation, la rencontre d’erreurs HTTP 500 lors de la connexion SSO, ou des erreurs d’accès non autorisées avec la connexion JWT. Suivez les étapes décrites pour identifier et résoudre efficacement le problème ou recueillez les informations nécessaires pour une assistance supplémentaire.
Email d’activation non reçu
Si vous n’avez pas reçu l’email d’activation après avoir été ajouté à un projet :
Vérifiez vos dossiers de spam ou de spam dans votre boîte mail.
Assurez-vous qu’aucun filtre réseau ou règle n’empêche la livraison des emails dans votre boîte mail.
Si l’email d’activation a expiré, contactez le propriétaire du projet et demandez-lui de renvoyer l’email d’activation.
Si le problème persiste après avoir suivi ces étapes, veuillez contacter l’équipe d’assistance Document360 pour obtenir de l’aide supplémentaire : Contacter l’assistance Document360
Pour plus d’informations sur l’ajout de lecteurs à un projet et l’activation des emails pour les notifier, lisez l’article sur la gestion des lecteurs.
Problème de connexion SSO : erreur HTTP 500
Erreur : Cette page ne fonctionne pas - identity.document360.io ne peut actuellement pas gérer cette requête - ERREUR HTTP 500
Étapes à résoudre :
Vérifiez si le problème affecte tous les utilisateurs associés au fournisseur d’identité SSO du projet.
Si le problème est limité à un utilisateur spécifique, il peut être lié aux paramètres du navigateur ou du réseau.
Essayez de vous connecter via un panneau de navigation privée ou incognito.
Changez de connexion internet et essayez de vous connecter.
Utilisez un autre appareil pour vous connecter et voyez si le problème persiste.
Si le problème persiste après avoir suivi ces étapes, veuillez contacter l’équipe d’assistance Document360 pour obtenir de l’aide supplémentaire : Contacter l’assistance Document360
Fournissez les détails suivants :
Détails de configuration SSO pour le projet et le fournisseur d’identité associé.
Un fichier journal produit généré. Pour les instructions, lisez l’article sur la génération d’un fichier HAR.
Un enregistrement d’écran qui démontre le problème en détail.
Problème de connexion JWT : Accès non autorisé
Erreur : Désolé, vous n’êtes pas autorisé à accéder à cette documentation. Code d’authentification invalide.
Vous pourriez rencontrer cette erreur en vous connectant au Knowledge base site en utilisant le JWT configuré pour les comptes de lecteurs dans le projet, en raison d’un accès non autorisé.
Étapes à résoudre :
Vérifiez si le problème est répandu ou isolé : déterminez si le problème touche tous les lecteurs du projet ou s’il est spécifique aux lecteurs d’une région ou d’un réseau particulier.
Pour les problèmes affectant un utilisateur spécifique :
Demandez à l’utilisateur de se connecter en utilisant un panneau de navigation incognito/privé.
Essayez d’accéder au site avec une autre connexion internet.
Essayez de vous connecter depuis un autre appareil pour identifier si le problème est spécifique à chaque appareil.
Si le problème persiste après avoir suivi ces étapes, veuillez contacter l’équipe d’assistance Document360 pour obtenir de l’aide supplémentaire : Contacter l’assistance Document360
Fournissez les détails suivants :
Un fichier journal produit généré. Pour les instructions, lisez l’article sur la génération d’un fichier HAR.
Un enregistrement d’écran qui démontre le problème en détail.
FAQ
Pourquoi est-ce que je voie un message d’avertissement, « Le script widget sera modifié et il pourrait affecter le script installé existant », lorsque je passe mon site du mode privé au mode public ?
Le message d’avertissement apparaît comme une alerte générale, mais si vous passez du Private au Mixed , cela n’impactera pas votre configuration actuelle de widget ou JWT.
Dans Document360, le support JWT (JSON Web Token) n’est disponible que pour les sites Private et Mixed . Ce message d’avertissement est principalement pertinent lors du passage en mode public, où JWT n’est pas pris en charge et sera automatiquement désactivé.
Pourquoi est-ce que je verrai une erreur de session expirée lorsque je consulte du contenu sur un site privé de base de connaissances ?
Si votre site de base de connaissances est réglé sur Privé, votre session de connexion peut expirer après plus de 15 minutes d’inactivité. Il s’agit d’une mesure de sécurité standard pour empêcher l’accès non autorisé à des contenus privés.
Une solution simple consiste à rafraîchir la page, ce qui rétablit votre session et restaure l’accès.
Pourquoi est-ce que je vois une version différente de la documentation lorsque j’ouvre le site ?
Lorsque vous ouvrez le site, le système affiche automatiquement la première version de documentation accessible publiquement qu’il peut trouver.
Si la version principale de la documentation est publique, elle est affichée.
Si la version principale est privée, une autre version de documentation publique est affichée à la place.
Si toutes les versions de la documentation standard sont privées, la documentation publique de l’API est affichée (si disponible).
Si aucune documentation publique n’est disponible, vous êtes redirigé vers la page de connexion.
Cela garantit que vous voyez toujours du contenu accessible lors de l’ouverture du site.
Comment puis-je rendre un seul espace de travail privé tout en gardant le reste de la base de connaissances public ?
Utilisez le mode Accès Mixte pour votre projet.
Après être passé au mixte :
Gardez votre espace de travail principal ou langage en mode public
Créez un espace de travail séparé pour le contenu restreint
Marquez uniquement cet espace de travail ou cette langue comme Privé
Ajoutez les lecteurs ou groupes de lecteurs requis qui devraient accéder à cet espace de travail
Cette configuration est utile pour des scénarios tels que la documentation de produits hérités, les espaces de travail spécifiques aux clients ou le contenu de conformité restreint, tout en maintenant le reste de votre base de connaissances accessible au public.
Pourquoi suis-je redirigé vers la page de documentation de l’API au lieu de la page d’accueil ?
Cela se produit lorsque la documentation de l’API est publique, mais que sa page d’accueil est désactivée.
Dans ce cas, le site vous redirige automatiquement vers la page de documentation de l’API (apidocs) afin que vous puissiez toujours accéder au contenu disponible de l’API.