Conector do Microsoft Graph na Cloud de Confluence

  • Artigo

O conector Confluence Cloud do Microsoft Graph 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.

Este artigo destina-se a administradores do Microsoft 365 ou a qualquer pessoa que configure, execute e monitorize um conector da Confluence Cloud. Complementa as instruções gerais fornecidas no artigo Configurar conectores do Microsoft Graph no centro de administração do Microsoft 365 . Se ainda não o fez, leia todo o artigo para compreender o processo de configuração geral.

Cada passo no processo de configuração está listado abaixo, juntamente com uma nota que indica que deve seguir as instruções de configuração geral OU outras instruções que se aplicam apenas ao conector da Confluence Cloud, incluindo informações sobre Resolução de Problemas e Limitações.

Antes de começar

Tem de ser o administrador do inquilino do Microsoft 365 da sua organização e o administrador do site confluence da sua organização.

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 para migrar para novas APIs v2 será lançada para todos os clientes em dezembro de 2023. Após esta versão, as ligações existentes terão de ser reautenticadas. As novas APIs v2 também requerem mais alguns âmbitos (em comparação com as APIs v1 anteriores) que terão de ser fornecidos durante a nova autenticação. Novo conjunto de âmbitos necessário (lista completa) – read:group:confluence, , read:user:confluence, read:content-details:confluence, Read:space:confluence, Read:permission:confluence, read:audit-log:confluencee read:content.metadata:confluenceread:page:confluence.

Passo 1: adicionar um conector no centro de administração do Microsoft 365

Adicionar conector da cloud confluence

Siga as instruções de configuração gerais.

Passo 2: atribuir um nome à ligação

Siga as instruções de configuração gerais.

Passo 3: Configurar as definições de ligação

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/>. Pode escolher Autenticação Básica ou OAuth 2.0 (recomendado) para autenticar no seu site de Confluence.

Dica

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

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.

Registe uma aplicação na Confluence Cloud para que a aplicação Microsoft Search possa 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, Editar Âmbitos e selecione os seguintes âmbitos.
Nome do Âmbito Código Descrição
Ver detalhes do conteúdo read:content-details:confluence Critérios de satisfação do conteúdo de pesquisa
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 M365 Enterprise: https://gcs.office.com/v1.0/admin/oauth/callback, para M365 Administração Pública: https://gcsgcc.office.com/v1.0/admin/oauth/callback e guarde as alterações.
  3. Navegue para Settings a partir do painel de navegação à esquerda. Irá obter o e Secret a Client ID partir desta página.

Conclua o passo de definições de ligação com o ID de Cliente e o Segredo.

Passo 4: selecionar propriedades e filtrar dados

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 seus resultados no Copilot para Microsoft 365.

Propriedade Source Label 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 você deseja mostrar na pesquisa e em outras 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.

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

Passo 5: Gerir permissões de pesquisa

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 serã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 serã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, terão precedência sobre as permissões de espaço.

Se não existirem restrições de página, o conector verificará 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 será 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 serão respeitadas.
  • Caso as permissões ao nível do espaço não estejam definidas, o conteúdo não será 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 serã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 utilizadores aprovisionados do Microsoft Entra ID ou utilizadores não AAD.

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

  1. Escolha a opção ID do Microsoft Entra 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 o ID do Microsoft Entra como o tipo de origem de identidade, o conector mapeia os IDs de E-mail dos utilizadores obtidos da Confluence diretamente para a propriedade UPN do Microsoft Entra ID.
  • Se escolheu "Non-AAD" para o tipo de identidade, veja Mapear as identidades que não são do 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.
  • As atualizações para utilizadores ou grupos que regem as permissões de acesso são sincronizadas apenas em pesquisas completas. Atualmente, as pesquisas incrementais não suportam o processamento de atualizações para permissões.

Passo 6: Atribuir etiquetas de propriedade

Siga as instruções de configuração gerais.

Passo 7: Gerir o esquema

Siga as instruções de configuração gerais.

Passo 8: escolher as definições de atualização

Siga as instruções de configuração gerais.

Observação

Para atualizações de permissões de acesso, só será aplicada a pesquisa completa agendada.

Passo 9: Rever a Ligação

Siga as instruções de configuração gerais.

Depois de publicar a ligação, tem 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.

Passo 10: Configurar a página de resultados da pesquisa

Depois de publicar a ligação, tem de personalizar a página de resultados da pesquisa com verticais e tipos de resultados. Para saber mais sobre como personalizar os resultados da pesquisa, reveja como gerir verticais e tipos de resultados. Também pode utilizar o esquema de resultados de exemplo para o conector de cloud confluence. Copie e cole o JSON do esquema de resultados para começar.

Limitações

O conector confluence Cloud tem as seguintes limitações conhecidas na sua versão mais recente:

  • O conector da Cloud confluence não indexa ficheiros e comentários de anexos.
  • As implementações do Servidor de Indexação e do Data Center serão lançadas como um conector separado.

Solução de problemas

Depois de publicar a ligação, pode rever o estado 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 outros problemas ou quiser fornecer feedback, escreva-nos aka.ms/TalkToGraphConnectors.