Partilhar via

Confluence Cloud Microsoft Graph Connector

  • Artigo

O conector do Microsoft Graph da Confluence Cloud permite que a sua organização indexe conteúdos da Confluence. 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 da Confluence Cloud. 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.

Pré-requisitos

  1. Tem de ser o administrador do inquilino do Microsoft 365 da sua organização e o administrador do site confluence da sua organização.
  2. Autenticação: certifique-se de que tem credenciais de autenticação com acesso certo.

Limitações

  • Não indexa ficheiros de anexo nem comentários.

Importante

  • A Atlassian está a preterir um conjunto de APIs na cloud do Confluence (versão V1) e a lançar novas APIs (versão V2). Pode ler sobre os anúncios deles aqui ou aqui. Algumas destas APIs v1 preteridas são utilizadas apenas pelo conector para ligações OAuth . Por conseguinte, publique esta alteração, as suas ligações confluências existentes podem deixar de funcionar. Esta alteração está agendada para 24 de janeiro.
  • A alteração à migração para novas APIs v2 foi lançada para todos os clientes em dezembro de 2023. Após esta versão, as ligações existentes têm de ser reautenticadas. As novas APIs v2 também requerem mais alguns âmbitos (em comparação com as APIs v1 anteriores) que têm de ser fornecidos durante a nova autenticação. É necessário um novo conjunto de âmbitos (lista completa) – read:group:confluence, , read:user:confluence, Read:space:confluenceread:content-details:confluence, Read:permission:confluence, , read:audit-log:confluencee read:page:confluenceread:content.metadata:confluence .

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 da Cloud de Confluence

Para ligar ao seu site confluence, utilize o URL do site. Normalmente, um URL de site na cloud confluence é semelhante a https://< organization_name.atlassian.net/>.

3. Tipo de autenticação

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

Dica

Certifique-se de que a conta de serviço tem acesso de visualização ao conteúdo da Confluence que pretende indexar.

a. Autenticação básica
Introduza o nome de utilizador da sua conta (normalmente ID de e-mail) e o token de API para autenticar com autenticação básica. Para saber mais sobre como gerar um token de API, veja a documentação da Atlassian sobre como gerir tokens de API para a sua conta Atlassian.

b. OAuth 2.0 (recomendado)
Registe uma aplicação na Confluence Cloud para que a aplicação Microsoft Search e o Microsoft 365 Copilot possam aceder à instância. Para saber mais, veja a documentação do Suporte da Atlassian sobre como Ativar o OAuth 2.0.

Os passos seguintes fornecem orientações sobre como registar a aplicação:

  1. Inicie sessão na consola do Atlassian Developer com a sua conta de administrador do Atlassian Confluence.
  2. Clique em Criar e selecione OAuth 2.0 integration.
  3. Forneça um nome adequado para a aplicação e crie a nova aplicação.
  4. Navegue para Permissions a partir do painel de navegação à esquerda. Clique em Adicionar para Confluence API. Depois de adicionado, clique em Configurar e Editar âmbitos e selecione os seguintes âmbitos.
Nome do Escopo Código Descrição
Ver detalhes do conteúdo read:content-details:confluence Conteúdo de pesquisa que satisfaz critérios.
Ver grupos read:group:confluence Para aceder às permissões de conteúdo do grupo.
Ver detalhes do utilizador read:user:confluence Para aceder a detalhes de utilizadores individuais para suportar permissões.
  1. Clique em Salvar.
  2. Navegue para Authorization a partir do painel de navegação à esquerda. Adicione o URL de chamada de retorno, para Microsoft 365 Enterprise: https://gcs.office.com/v1.0/admin/oauth/callback, para Microsoft 365 Administração Pública: https://gcsgcc.office.com/v1.0/admin/oauth/callback e guarde as alterações.
  3. Navegue para Definições a partir do painel de navegação à esquerda. Obtém o ID de Cliente e o Segredo desta página.

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:

Usuários  
Permissões de acesso Apenas pessoas com acesso a conteúdos na Origem de dados.
Mapear Identidades Identidades de origem de dados mapeadas com Microsoft Entra IDs.
Conteúdo  
Incluir/Excluir espaço Tudo
Gerir Propriedades Para marcar propriedades predefinidas e o respetivo esquema, clique aqui
Sincronizar  
Pesquisa Incremental Frequência: a cada 15 minutos
Pesquisa Completa Frequência: Todos os Dias

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 confluence Cloud do Microsoft Graph 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. Na Confluence Cloud, 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. As restrições ao nível da página, se estiverem presentes, têm precedência sobre as permissões de espaço.

Se não existirem restrições de página, o conector verifica se existem permissões ao nível do espaço -

  • Caso o espaço tenha o acesso de "utilizadores anónimos" ativado, o conteúdo é visível para todos os utilizadores no seu inquilino.
  • Caso o "acesso anónimo" não esteja ativado, as permissões ao nível do espaço não são respeitadas.
  • Caso as permissões ao nível do espaço não estejam definidas, o conteúdo não é visível para nenhum utilizador no seu inquilino.

Importante

As permissões são geridas apenas ao nível do espaço e da página e as permissões da página principal não são tidas em consideração.

Se escolher Apenas 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.

Observação

  • Se escolher Microsoft Entra ID como o tipo de origem de identidade, o conector mapeia os IDs de e-mail dos utilizadores obtidos a partir da Confluence diretamente para a propriedade UPN de Microsoft Entra ID.
  • Se escolheu "Non-AAD" para o tipo de identidade, consulte Mapear as suas Identidades não Azure AD para obter instruções sobre o mapeamento das identidades. Pode utilizar esta opção para fornecer a expressão regular de mapeamento do ID de e-mail para o UPN.
  • Atualizações a utilizadores ou grupos que regem as permissões de acesso são sincronizados apenas em pesquisas completas. Atualmente, as pesquisas incrementais não suportam o processamento de atualizações para permissões.

Conteúdo

Incluir ou excluir dados que pretende indexar

Com uma cadeia CQL (Confluence Query Language), pode especificar condições para sincronizar páginas. É como uma cláusula Where numa instrução SQL Select . Por exemplo, pode optar por indexar apenas as páginas que foram modificadas nos últimos dois anos. Para saber mais sobre como criar a sua própria cadeia de consulta, veja Pesquisa Avançada com CQL. Por predefinição, todos os blogues e páginas são indexados pelo conector.

Dica

Pode utilizar o filtro CQL para indexar conteúdo modificado após um determinado período de tempo com lastModified >= "12/2018/31"

Utilize o botão de resultados de pré-visualização para verificar os valores de exemplo das propriedades selecionadas e da cadeia CQL.

Gerir Propriedades

Neste passo, pode adicionar ou remover propriedades disponíveis da sua origem de dados Confluence. O Microsoft 365 selecionou algumas propriedades por predefinição. A lista de propriedades que selecionar aqui pode afetar a forma como pode filtrar, procurar e ver os resultados em Microsoft 365 Copilot.

Propriedade Source Rótulo Descrição
Autores authors Nome das pessoas que participaram/colaboraram no item na origem de dados.
CreatedByName createdBy Nome da pessoa que editou o item mais recentemente na fonte de dados.
CriadoOn createdDateTime Data e hora em que o item foi criado na origem de dados.
IconUrl iconUrl O URL do ícone associado do item.
Título title O título do item que pretende que seja apresentado na pesquisa e noutras experiências.
UpdatedByName lastModifiedBy Nome da pessoa que editou o item mais recentemente na fonte de dados.
UpdatedOn lastModifiedDateTime Data e hora em que o item foi modificado pela última vez na origem de dados.
Url url A URL de destino do item na fonte de dados.

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 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.

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