Acesso do leitor refere-se à configuração de visibilidade no seu projeto Document360 que determina quem pode visualizar o conteúdo do seu site de base de conhecimento.
Acessando a página de acesso do Leitor
Para gerenciar as configurações de acesso ao leitor:
Navegue até Configurações () > Usuários e permissões na barra de navegação da esquerda no portal da Base de Conhecimento.
No painel de navegação esquerdo, navegue até Acesso para leitores.
Visibilidade do site da base de conhecimento para o projeto
Existem três tipos de modos de acesso ao leitor no Document360:
Acesso público
Um site de base de conhecimento público é acessível a qualquer pessoa na internet. Os usuários de Rpodem acessar o conteúdo publicado por meio de links diretos ou mecanismos de busca; Não é necessário fazer login.
Alguns dos casos de uso comuns são
Suporte ao cliente Site da base de conhecimento
Centro de ajuda de produtos
Portal de autoatendimento
Documentação pública da API
Guias e manuais do usuário
Acesso privado
Uma base de Conhecimento Privada é restrita apenas a usuários autorizados. O conteúdo é acessível apenas para usuários ou usuários do R, e é necessário login.
Alguns dos casos de uso comuns são
Suporte interno de TI Base de conhecimento
Políticas e procedimentos de RH
Documentação em toda a empresa
Documentação interna da API
Manuais de software proprietário
Acesso misto
Uma base de conhecimento mista permite configurar uma combinação de conteúdo público e privado. Algumas seções permanecem públicas, enquanto outras são visíveis apenas para leitores logados.
Alguns dos casos de uso comuns são
Artigos de apoio público com documentação interna
Centro de atendimento voltado para clientes com base de conhecimento interna de RH
APIs públicas com notas internas de desenvolvedor
Recursos de conformidade com conteúdo de auditoria privada
Guias públicos para desenvolvedores com documentação técnica privada
Projeto, espaços de trabalho e linguagens
Nesta seção, você pode visualizar a estrutura do seu projeto, incluindo o número de espaços de trabalho e idiomas. Essas informações estão disponíveis apenas para projetos de acesso privado e misto.
Se seu projeto for público, toda a base de conhecimento está disponível para todos.
Para projetos mistos, você pode marcar espaços de trabalho ou linguagens específicas como Público ou Privado, permitindo controle granular sobre quem pode acessar quais partes da sua base de conhecimento.
.png)
Gerencie o acesso ao conteúdo
Esta seção só é visível se seu projeto estiver configurado como Acesso Privado ou Misto .
No topo, você encontrará duas abas:
Leitores: Lista todas as contas dos leitores.
Grupos de leitores: Lista todos os grupos de leitores.
Acesso herdado por blocos
A opção de acesso herdado por bloco está disponível apenas quando um workspace ou idioma específico é selecionado na visualização em árvore à esquerda.
Quando ativados, leitores herdados e futuros ou grupos de leitores não terão mais acesso ao workspace ou idioma selecionado. Leitores ou grupos de leitores adicionados diretamente nesse nível continuarão a manter o acesso.
Para mais informações, veja o artigo sobre herança de blocos.
Gerencie leitores individuais
Na aba Leitores, selecione um leitor, e você pode tanto Negar () quanto Remover () o acesso deles.
Negar (): Restringe o acesso do leitor a conteúdo específico. Se o acesso for negado para um leitor ou grupo de leitores em qualquer nível, eles não poderão acessar esse conteúdo, mesmo que herdem permissões de acesso de uma categoria principal.
Remover (): Remove o acesso explícito do leitor neste nível. O leitor ainda pode ter acesso por herança do nível dos pais. Para entender como isso funciona, consulte Compreender a precedência de permissão.
Leitores de filtro
Você pode filtrar os leitores com base no nível de acesso:
Projeto
Espaço de trabalho
Idioma
NOTA
Se o nível de acesso ao seu conteúdo estiver configurado além do nível do projeto (como workspace ou language), você pode negar o acesso a leitores específicos de acordo.
Sua base de conhecimento pode incluir tanto artigos privados quanto públicos , dependendo da configuração de acesso do leitor.
Atribuir acesso ao leitor
Você pode atribuir explicitamente acesso ao leitor em qualquer nível; Workspace, linguagem, categoria ou artigo, para controlar quem pode visualizar conteúdo específico.
NOTA
Isso é especialmente importante após o uso da herança de blocos, pois todo acesso anteriormente herdado é removido e os leitores devem ser adicionados explicitamente de volta nesse nível.
No nível do espaço de trabalho ou do idioma:
Vá para Configurações ()> Usuários e permissões > Acesso ao leitor.
Selecione o espaço de trabalho e a linguagem onde a herança foi bloqueada.
Clique em Atribuir acesso e selecione os leitores ou grupos de leitores que precisam de acesso.
Clique em Aplicar.
Apenas os leitores que você adicionar explicitamente no nível de workspace/idioma poderão ver esse conteúdo no site da base de conhecimento.
Em nível de categoria ou artigo:
Vá até Documentação () e passe o mouse sobre a categoria ou artigo.
Clique em Mais () > Segurança > Base de conhecimento Site controle de acesso.
No painel, clique em Atribuir acesso.
Selecione os leitores ou grupos de leitores e clique em Aplicar.
Apenas os leitores que você adicionar explicitamente em nível de categoria/artigo poderão ver esse conteúdo no site da base de conhecimento.
Restaurar o acesso ao leitor negado
Para restaurar o acesso aos leitores negados:
Navegue até Configurações () > Usuários e permissões na barra de navegação à esquerda do portal da Base de Conhecimento.
No painel de navegação esquerdo, navegue até Acesso para leitores.
Na página Acesso para leitores , clique em Atribuir acesso ao projeto.
A janela de diálogo Atribuir acesso ao projeto: Projeto completo aparece.Use a barra de busca para encontrar os leitores desejados.
Selecione os leitores ou grupos de leitores.
Clique em Aplicar.
Uma vez designados, esses r-eaders terão acesso a toda a base de conhecimento.
Compreendendo a precedência de permissão
No Document360, as permissões do leitor seguem uma hierarquia do nível mais alto ao nível mais específico. Isso ajuda a determinar como os leitores têm acesso ao conteúdo.
Hierarquia de permissões
As permissões fluem nesta ordem:
Project → Workspace → Language → Category → Article
Quando um leitor recebe acesso em um nível superior, esse acesso se aplica automaticamente a tudo abaixo dele. Isso é chamado de acesso herdado porque o leitor recebe acesso de um nível pai.
Se você der ao mesmo leitor acesso direto em um nível inferior, essa permissão direta tem prioridade sobre a permissão herdada. Isso é chamado de acesso explícito porque o leitor foi adicionado diretamente naquele nível específico.
Por exemplo, se o Leitor A tiver acesso no nível de língua inglesa, ele automaticamente terá acesso a todas as Categorias e Artigos em inglês. Isso é acesso herdado.
Se você posteriormente der ao Leitor A acesso direto a uma Categoria específica, essa permissão direta se torna a permissão ativa para essa Categoria e tudo que está nela, enquanto o restante do conteúdo em inglês continua usando o acesso herdado.
Atualizando as configurações de acesso ao leitor
Para atualizar o modo de acesso do leitor do seu projeto:
Navegue até Configurações () > Usuários e permissões na barra de navegação da esquerda do portal da Base de Conhecimento.
No painel de navegação esquerdo, navegue até Acesso para leitores.
Seu modo de acesso ao leitor atual será selecionado.
Escolha entre Público, Privado ou Misto.
Clique no modo desejado para atualizar a visibilidade do seu projeto.
No diálogo de confirmação de acesso ao leitor Atualizar , insira o subdomínio do seu projeto (por exemplo,
document360-demo).Clique em sim para confirmar.
NOTA
Ao mudar de Misto para Privado ou de Privado para Misto, talvez seja interessante reconsiderar as permissões de acesso previamente atribuídas.
Solução de problemas
Esta seção fornece soluções passo a passo para problemas comuns de login e ativação, como não receber e-mails de ativação, encontrar erros HTTP 500 durante o login SSO ou erros de acesso não autorizado com login JWT. Siga os passos indicados para identificar e resolver o problema de forma eficiente ou reúna os detalhes necessários para assistência adicional.
E-mail de ativação não recebido
Se você não recebeu o e-mail de ativação após ser adicionado a um projeto:
Verifique suas pastas de spam ou lixo na sua caixa de entrada de e-mail.
Certifique-se de que nenhum filtro ou regra de rede esteja impedindo e-mails de serem entregues na sua caixa de entrada.
Se o e-mail de ativação expirou, entre em contato com o dono do projeto e peça que ele envie novamente o e-mail de ativação.
Se o problema persistir após seguir essas etapas, entre em contato com a equipe de suporte do Document360 para obter mais assistência: Entre em contato com o suporte do Document360
Para mais informações sobre como adicionar leitores a um projeto e ativar e-mails para notificá-los, leia o artigo sobre Gerenciar leitores.
Problema de login SSO: erro HTTP 500
Erro: Esta página não está funcionando - identity.document360.io atualmente não consegue lidar com essa solicitação - HTTP 500 ERRO
Passos para resolver:
Verifique se o problema está afetando todos os usuários associados ao Provedor de Identidade SSO do projeto.
Se o problema for exclusivo de um usuário específico, pode estar relacionado às configurações do navegador ou da rede.
Tente fazer login usando um painel de navegação incógnito/privado.
Troque para outra conexão de internet e tente fazer login.
Use outro dispositivo para fazer login e veja se o problema persiste.
Se o problema persistir após seguir essas etapas, entre em contato com a equipe de suporte do Document360 para obter mais assistência: Entre em contato com o suporte do Document360
Forneça os seguintes detalhes:
Detalhes da configuração do SSO para o projeto e o Provedor de Identidade associado.
Um arquivo de log de produto gerado. Para instruções, leia o artigo sobre Geração de um Arquivo HAR.
Uma gravação de tela que demonstra o problema em detalhes.
Problema de login no JWT: Acesso não autorizado
Erro: Desculpe, você não está autorizado a acessar esta documentação. Código de autenticação inválido.
Você pode encontrar esse erro ao fazer login no Site da base de conhecimento usando o JWT configurado para contas de leitor no projeto devido a acesso não autorizado.
Passos para resolver:
Verifique se o problema é generalizado ou isolado: Determine se o problema afeta todos os leitores do projeto ou se é específico para leitores de uma região ou rede específica.
Para questões que afetam um usuário específico:
Peça ao usuário para fazer login usando um painel de navegação incógnito/privado.
Tente acessar o site usando uma conexão de internet diferente.
Tente fazer login de outro dispositivo para identificar se o problema é específico do dispositivo.
Se o problema persistir após seguir essas etapas, entre em contato com a equipe de suporte do Document360 para obter mais assistência: Entre em contato com o suporte do Document360
Forneça os seguintes detalhes:
Um arquivo de log de produto gerado. Para instruções, leia o artigo sobre Geração de um Arquivo HAR.
Uma gravação de tela que demonstra o problema em detalhes.
FAQ
Por que vejo uma mensagem de aviso, "O script do widget será alterado e pode afetar o script instalado existente", ao mudar meu site do modo privado para o público?
A mensagem de aviso aparece como um alerta geral, mas se você estiver mudando do modo Private para Mixed , ela não afetará sua configuração atual de widgets ou JWT.
No Document360, o suporte a JWT (JSON Web Token) está disponível apenas para sites Private e Mixed . Essa mensagem de aviso é principalmente relevante ao mudar para o modo público, onde o JWT não é suportado e será desativado automaticamente.
Por que vejo um erro de vencimento de sessão ao visualizar conteúdo em um site privado de Knowledge Base?
Se o site da sua base de conhecimento estiver configurado como Privado, sua sessão de login pode expirar após mais de 15 minutos de inatividade. Esta é uma medida padrão de segurança para evitar acesso não autorizado a conteúdo privado.
Uma solução simples é atualizar a página, o que restabelece sua sessão e restaura o acesso.
Por que vejo uma versão diferente da documentação quando abro o site?
Quando você abre o site, o sistema mostra automaticamente a primeira versão de documentação disponível publicamente que consegue encontrar.
Se a versão principal da documentação for pública, ela é mostrada.
Se a versão principal for privada, outra versão de documentação pública é exibida em seu lugar.
Se todas as versões padrão da documentação forem privadas, a documentação pública da API é exibida (se disponível).
Se não houver documentação pública disponível, você é redirecionado para a página de login.
Isso garante que você sempre veja conteúdo acessível ao abrir o site.
Como posso tornar apenas um espaço de trabalho privado enquanto mantenho o restante da base de conhecimento público?
Use o modo de acesso misto para seu projeto.
Depois de mudar para o misto:
Mantenha seu espaço de trabalho principal ou linguagem definido como Público
Crie um espaço de trabalho separado para o conteúdo restrito
Marque apenas aquele espaço de trabalho ou linguagem como Privado
Adicione os leitores ou grupos de leitores necessários que devem acessar esse espaço de trabalho
Essa configuração é útil para cenários como documentação de produtos legados, espaços de trabalho específicos para clientes ou conteúdo de conformidade restrito, mantendo o restante da sua base de conhecimento acessível publicamente.
Por que sou redirecionado para a página de documentação da API em vez da página inicial?
Isso acontece quando a documentação da API é pública, mas sua página inicial está desativada.
Nesse caso, o site redireciona automaticamente para a página de documentação da API (apidocs), para que você ainda possa acessar o conteúdo disponível da API.