O acesso ao conteúdo controla quais espaços de trabalho, linguagens e categorias aparecem dentro do widget da Base de Conhecimento. Você pode configurar isso mesmo quando o JWT está ativado, dando flexibilidade para restringir o que os usuários finais veem sem exigir alterações de acesso em nível individual. Quando um leitor faz login, o sistema valida as permissões do grupo de leitores contra os filtros de acesso ao conteúdo em nível de widget, sendo mostrada apenas a interseção de ambos. Você também pode controlar como os links dos artigos abrem a partir do widget, dentro do widget ou em uma nova aba.
Os controles de acesso ao conteúdo se aplicam apenas ao nível do projeto, espaço de trabalho, linguagem ou categoria. Eles não fornecem restrições no nível de um leitor individual. Se você precisar mostrar conteúdo diferente para diferentes leitores individuais, é necessária autenticação JWT com grupos de leitores. Veja Configurar JWT para o widget da base de conhecimento e grupos de leitores JWT.
Quando configurar o acesso ao conteúdo
- Você quer que o widget mostre apenas conteúdo de um espaço de trabalho específico ou área de produto.
- Sua base de conhecimento tem múltiplos espaços de trabalho e o widget deve aparecer apenas um.
- Você quer restringir a visibilidade a categorias específicas para um widget específico.
- Você está usando JWT com grupos de leitores e quer que o escopo do widget esteja alinhado com as permissões do grupo.
- Você quer que alguns links nos seus artigos abram em uma nova aba em vez de dentro do widget.
Configurar acesso ao conteúdo
- Navegue até Conexões () > widget da base de conhecimento na barra de navegação à esquerda.
- Passe o mouse sobre o widget desejado e clique no ícone Editar ().
- Na aba Instalação e Configuração , expanda a seção de acesso ao conteúdo .
- Selecione o nível desejado do filtro:
- Projeto — Todos os espaços de trabalho e linguagens
- Espaço de trabalho — Um ou mais espaços de trabalho e linguagens específicos
- Categoria — Uma ou mais categorias específicas
- Escolha os espaços de trabalho, idiomas e categorias desejados para exibir no widget.
- Clique em Concluído, depois clique em Salvar para aplicar as alterações.
Configurar comportamento de link
Por padrão, os links para os artigos da sua base de conhecimento são abertos dentro do widget, para que os leitores permaneçam no seu site. Use as configurações de comportamento dos links para abrir alguns desses links em uma nova aba.
- Navegue até Conexões () > widget da base de conhecimento na barra de navegação à esquerda.
- Passe o mouse sobre o widget desejado e clique no ícone Editar ().
- Na aba Instalação e Configuração , expanda a seção de acesso ao conteúdo .
- Em comportamento de link, ative as alternâncias desejadas:
- Abrir links externos em uma nova aba: Links adicionados como links externos no artigo abram em uma nova aba.
- Honrar links abertos em uma nova aba: Links configurados para abrir em uma nova aba no editor também abrem em uma nova aba a partir do widget.
- Clique em Salvar.
A tabela a seguir mostra como os links se abrem no widget:
| Link no artigo | Alternar | Desligado (padrão) | Em |
|---|---|---|---|
| Link configurado para abrir em uma nova aba | Honrar links abertos em uma nova aba | Abre dentro do widget | Abre em uma nova aba |
| Link externo para um dos seus artigos de base de conhecimento | Abrir links externos em uma nova aba | Abre dentro do widget | Abre em uma nova aba |
| Link para outro site | — | Sempre abre em uma aba nova | Sempre abre em uma aba nova |
- As configurações de comportamento do link se aplicam apenas ao widget selecionado. Se você usar mais de um widget, configure cada um separadamente.
- As alterações se aplicam a widgets já instalados no seu site. Você não precisa reinstalar o script do widget. As alterações podem levar até 15 minutos para aparecer.
- Filtros de acesso ao conteúdo e permissões de grupos de leitores ainda se aplicam. Se um leitor não tiver acesso ao artigo vinculado, o widget mostra um estado de acesso restrito.
Validando permissões de conteúdo de grupos de leitores
Quando um leitor faz login, o sistema valida se as permissões do grupo de leitores correspondem aos filtros de acesso ao conteúdo do widget. Apenas as permissões de interseção entre as configurações em nível de widget e as configurações do grupo de leitores são consideradas para validação. Isso garante que os usuários vejam apenas os artigos para os quais estão autorizados.
A mesma validação é aplicada quando os leitores clicam em links internos dentro do widget. O widget verifica os filtros de acesso ao conteúdo configurados, o escopo do espaço de trabalho e as permissões do grupo de leitores antes de carregar o conteúdo de destino. Se o conteúdo vinculado estiver fora do escopo permitido, o widget exibe um estado de acesso restrito em vez de renderizar o artigo.
Alterações feitas no acesso ao conteúdo impactarão diretamente o mapeamento de URLs. Se você modificar as configurações de filtro do widget, o mapeamento de URL existente pode ser removido, levando a links quebrados.
Você só pode configurar mapeamentos de URL usando artigos incluídos no conteúdo atual do widget de Filtro.
Exemplo 1: Você definiu o conteúdo do widget de filtro no nível do Projeto e configurou um mapeamento de URL que inclui uma lista de artigos da Categoria A no Workspace V1. Se você atualizar as configurações do filtro para mostrar apenas as Categorias B e C no mesmo espaço de trabalho, o mapeamento de URL anterior se torna inválido — porque os artigos originalmente mapeados da Categoria A não estão mais disponíveis no widget.
Exemplo 2: Se o widget for filtrado para exibir conteúdo apenas do Workspace V1, você não pode criar um mapeamento de URL para um artigo localizado no Workspace V2.
Sempre revise e atualize os mapeamentos de URL após alterar as configurações de acesso ao conteúdo.
Melhores práticas
- Use acesso em nível de categoria apenas quando precisar de conteúdo de widgets com escopo restrito. A desvantagem é que você deve manter manualmente a lista de categorias conforme novas categorias são adicionadas.
- Após alterar o acesso ao conteúdo, teste o widget navegando até cada URL mapeada para confirmar que os artigos esperados ainda aparecem.
- Ao linkar para seus próprios artigos, use a opção de link do editor em vez de colar a URL do artigo. Os links de artigos abrem dentro do widget e permanecem válidos se a URL do artigo mudar.
FAQ
Por que algumas categorias estão ausentes no widget da base de conhecimento?
Isso pode ocorrer se o acesso em nível de categoria não tiver sido configurado corretamente para o widget. Para garantir que suas categorias sejam visíveis:
Verifique se o leitor tem permissão para visualizar as categorias específicas no widget da base de conhecimento.
Verifique se o acesso em nível de categoria está configurado. Se estiver, adicione manualmente a categoria desejada na seção de acesso ao conteúdo.
Para adicionar a categoria faltante ao widget:
Navegue até Conexões () > widget de Base de Conhecimento.
Passe o mouse sobre o widget desejado e clique no ícone Editar ().
Na aba Instalação e Configuração , expanda o acordeão de acesso ao Conteúdo .
Selecione Categoria e escolha a categoria desejada para aparecer no widget.
Clique em Salvar para aplicar as alterações.
Por que um link de artigo abre dentro do widget em vez de uma nova aba?
Por padrão, o widget abre links para os artigos da sua base de conhecimento dentro do widget, mesmo que o link esteja configurado para abrir em uma nova aba no editor. Para alterar isso, ative Honrar links abertos em uma nova aba ou Abrir links externos em uma nova aba em Acesso ao Conteúdo > Comportamento de Links. Para mais informações, veja Configurar comportamento dos links.
Os links da documentação da API sempre abrem em uma nova aba do navegador.
Links para outros sites sempre abrem em uma nova aba do navegador.
Se o conteúdo de destino for restrito, o widget exibe um estado de acesso restrito.
Se o destino não puder ser resolvido, o widget exibe um estado de reserva.
Por que um link interno de artigo mostra acesso restrito dentro do widget?
Isso acontece quando o artigo vinculado está fora do escopo de acesso ao conteúdo configurado do widget ou quando o leitor não tem permissão através do grupo de leitores designado.
Verifique que:
O espaço de trabalho de destino está incluído na configuração do widget.
A categoria vinculada está dentro do escopo do filtro permitido.
O leitor tem acesso através do grupo de leitores designado.
Se o conteúdo de destino estiver fora do escopo permitido, o widget exibe intencionalmente um estado de acesso restrito.
É possível restringir o conteúdo de widgets para leitores individuais sem usar o JWT?
Não. Filtros de acesso ao conteúdo (Projeto, Espaço de Trabalho ou Categoria) restringem o que o widget exibe no geral, e grupos de leitores restringem o que um leitor logado pode ver, mas nenhum deles oferece restrição no nível de um único leitor específico. A restrição de conteúdo em nível de leitor no widget requer autenticação JWT com grupos de leitores JWT. Sem JWT, o nível mais restrito de controle disponível é a categoria.
Também note que, para referência: a autenticação JWT para o Site da Base de Conhecimento e a autenticação JWT para o Widget da Base de Conhecimento são configuradas de forma independente. Ativar ou desativar o JWT para um não afeta automaticamente o outro.