Confluence Conector do Microsoft Graph no local

O conector do Microsoft Graph no local do Confluence permite que a sua organização indexe conteúdo do servidor confluence ou do datacenter. Depois de configurar os dados do conector e do índice a partir do site Confluence, os utilizadores finais podem procurar esses conteúdos no Microsoft Search e Microsoft 365 Copilot.

Este artigo destina-se a administradores do Microsoft 365 e responsáveis pela configuração, execução e monitorização do conector do Microsoft Graph no local. Complementa as instruções gerais fornecidas na configuração dos conectores do Microsoft Graph no Centro de administração do Microsoft 365.

Benefícios

• Capacidades de Pesquisa Avançadas: os utilizadores podem fazer perguntas de linguagem natural sobre conteúdos wiki no Copilot, tais como:
  • Resumir o documento de arquitetura
    
  • Como obter acesso a um portal
    
• Suporte de Pesquisa Semântica: os utilizadores podem executar consultas de linguagem natural para obter respostas precisas.
  
• Compatibilidade: suporta versões de Confluence acima da versão 8.0.

Pré-requisitos

1. Instale o GCA [agente do conector do Graph]: certifique-se de que o GCA está instalado num computador Windows na mesma rede que a origem de dados, acessível através do URL de Confluência. Pode encontrar mais informações sobre o agente do conector do Microsoft Graph
2. Instalar o plug-in: transfira e instale o plug-in no local da confluência a partir do Marketplace Atlassian na configuração da confluência. Obter o plug-in a partir do Plug-in No Local do Microsoft Graph Connectors | Atlassian Marketplace
3. Autenticação: certifique-se de que tem credenciais de autenticação com acesso certo.

Introdução

1. Nome a apresentar

Um Nome a apresentar é utilizado para identificar cada referência em Copilot, ajudando os utilizadores a reconhecer facilmente o ficheiro ou item associado. O nome a apresentar também significa conteúdo fidedigno. O nome a apresentar também é utilizado como um filtro de origem de conteúdo. Está presente um valor predefinido para este campo, mas pode personalizá-lo para um nome que os utilizadores na sua organização reconhecem.

2. URL do Confluence no local

Para ligar aos seus dados do Confluence No local, precisa do URL da instância de Confluence da sua organização. Normalmente, o URL da instância de Confluence da sua organização é semelhante a "https://contoso.atlassian.net".

3. Graph connector agent (GCA)

Para indexar o servidor confluence ou o conteúdo do datacenter, tem de instalar e registar o agente do conector. Consulte Instalar o agente do conector do Microsoft Graph para obter detalhes. Tem de ser o administrador do inquilino do Microsoft 365 da sua organização e o administrador do site confluence da sua organização.

4. Instalar o plug-in do Confluence no local

Verifique se o Plug-in do Microsoft Graph Connectors On-prem está instalado. Não precisa de instalar o plug-in para cada conector de confluência; Se já estiver instalado na sua instância do Confluence, pode ignorar este passo para as ligações subsequentes do Confluence no local.

• Transferir a aplicação a partir do Plug-in No Local do Microsoft Graph Connectors | Atlassian Marketplace.
• Iniciar sessão no seu sistema de confluência
• Clique no ícone de definições -> Clique em gerir aplicações Captura de ecrã
• Clique em carregar aplicação
• Escolha o ficheiro transferido e continue o

5. Tipo de autenticação

Para autenticar e sincronizar conteúdos do Confluence No local, escolha um dos três métodos suportados:

a. Autenticação básica
Para se autenticar na sua instância, introduza o nome de utilizador e a palavra-passe da conta do Confluence.

b. OAuth1.0a
Gere um par de chaves públicas/privadas e crie uma ligação de aplicação no site No Local do Confluence para que o agente do conector possa aceder à instância. Para saber mais, veja o passo 1 na documentação do programador atlassiano sobre como configurar o OAuth 1.0a.

c. OAuth 2.0 (recomendado)
Os passos seguintes fornecem orientações sobre como registar a aplicação Configurar uma ligação de entrada.

1. Aceda a Administração Configuração >> geral Ligações da aplicação.
2. Selecione Criar ligação
3. Selecione Aplicação externa e, em seguida, selecione Recebido como a direção.
4. Preencha o

• URL de redirecionamento: https://gcs.office.com/v1.0/admin/oauth/callback
• Âmbito: Administração ou Leitura

5. Conclua o passo de definições de ligação com o ID de cliente e o segredo.

6. Implementação para audiência limitada

Implemente esta ligação numa base de utilizadores limitada se pretender validá-la no Copilot e noutras superfícies de Pesquisa antes de expandir a implementação para uma audiência mais ampla. Para saber mais sobre a implementação limitada, clique aqui.

Neste momento, está pronto para criar a ligação para o ServiceNow Knowledge. Pode clicar no botão "Criar" e o conector do Microsoft Graph começa a indexar a partir da sua conta confluence.

Para outras definições, como Permissões de Acesso, Regras de inclusão de dados, Esquema, Frequência de pesquisa, etc., definimos as predefinições com base no que funciona melhor com os dados do Confluence. Os valores predefinidos são os seguintes:

Se quiser editar qualquer um destes valores, tem de escolher a opção Custom Setup .

Configuração Personalizada

A configuração personalizada destina-se aos administradores que pretendem editar os valores predefinidos das definições listadas na tabela predefinida. Depois de clicar na opção Custom Setup , verá mais três separadores : Utilizadores, Conteúdo e Sincronização.

Usuários

Permissões de Acesso

O conector Do Microsoft Graph no local do Confluence suporta permissões de pesquisa visíveis para Todos ou Apenas pessoas com acesso a esta origem de dados. Se escolher Todos, os dados indexados são apresentados nos resultados da pesquisa para todos os utilizadores. Se escolher Apenas as pessoas com acesso a esta origem de dados, os dados indexados são apresentados nos resultados da pesquisa para os utilizadores que têm acesso aos mesmos. No Confluence No local, as permissões de segurança para utilizadores e grupos são definidas através de permissões de espaço e restrições de página. O conector do Microsoft Graph no local do Confluence aplica permissões efetivas fornecidas pela API de Restrições de conteúdo

Se escolher Apenas as pessoas com acesso a esta origem de dados, terá de escolher se o seu site confluence tem Microsoft Entra ID utilizadores aprovisionados ou utilizadores não AAD.

Para identificar que opção é adequada para a sua organização:

1. Escolha a opção Microsoft Entra ID se o ID de e-mail dos utilizadores do Confluence for igual ao UserPrincipalName (UPN) dos utilizadores no Microsoft Entra ID.
2. Escolha a opção não AAD se o ID de e-mail dos utilizadores do Confluence for diferente do UserPrincipalName (UPN) dos utilizadores no Microsoft Entra ID.

Conteúdo

Incluir ou excluir dados que pretende indexar

Neste passo, pode adicionar ou remover propriedades disponíveis da sua origem de dados Confluence. O Microsoft 365 seleciona algumas propriedades. Por predefinição, o conector indexará todos os espaços. No entanto, pode optar por incluir ou excluir espaços específicos com a opção de filtro de espaço.

Introduza a lista de chaves de espaço que pretende incluir ou excluir e verá uma pré-visualização dos resultados. Introduza a Tecla de Espaço: cada espaço de Confluência tem uma tecla de espaço, que é um identificador exclusivo curto que faz parte do URL desse espaço. Para obter a chave de espaço, contacte o administrador de confluência. Para obter mais informações, visite: Teclas de Espaço

Filtro de página

Neste passo, pode especificar o intervalo de datas para indexar os seus documentos. Os parâmetros são os seguintes:

• Data da Última Criação: a data em que um documento foi criado. Apenas os documentos modificados após esta data são indexados.
• Data da Última Modificação: a data em que um documento foi modificado. Apenas os documentos modificados após esta data são indexados.

Gerir Propriedades

Aqui, pode adicionar ou remover propriedades disponíveis da sua origem de dados No Local do Confluence. Atribua um esquema à propriedade (defina se uma propriedade é pesquisável, consultada, recuperável ou refinável). Além disso, pode alterar a etiqueta semântica e adicionar um alias à propriedade . As propriedades predefinidas são as seguintes:

Pré-visualizar Dados

Utilize o botão de pré-visualização de resultados para verificar as propriedades e filtros selecionados.

Sincronização

O intervalo de atualização determina a frequência com que os dados são sincronizados entre a origem de dados e o índice do conector do Graph. Existem dois tipos de intervalos de atualização: pesquisa completa e pesquisa incremental. Para obter mais detalhes, clique aqui. Se quiser, pode alterar os valores predefinidos do intervalo de atualização a partir daqui.

Rever e Testar a ligação

• Para fins de teste, pode escolher publicar numa audiência limitada.
• Pesquise e valide o conteúdo indexado e as permissões através do browser Índice.
• Encontre respostas a perguntas comuns na nossa secção FAQ.

Para a Pesquisa MS, se precisar de personalizar a página de resultados da pesquisa. Para saber mais sobre como personalizar os resultados da pesquisa, consulte Personalizar a página de resultados da pesquisa.

Limitações

• Não indexa blogues, ficheiros de anexo ou comentários.
• Indexa apenas as páginas atuais; as páginas arquivadas são excluídas.
• O CQL[Confluence Query Language] não é suportado para a Confluence no local. No entanto, suportamos um filtro ao nível do espaço e da página

Solução de problemas

Depois de publicar a ligação, pode rever a status no separador Origens de dados no centro de administração. Para saber como fazer atualizações e eliminações, consulte Gerir o conector. Pode encontrar passos de resolução de problemas frequentemente vistos aqui.

Se tiver problemas ou quiser fornecer comentários, contacte o Microsoft Graph | Suporte.