Conector do Microsoft Graph na Cloud de Confluence
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:confluence
eread:content.metadata:confluence
read: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.
OAuth 2.0 (recomendado)
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:
- Inicie sessão na consola do Atlassian Developer com a sua conta de administrador do Atlassian Confluence.
- Clique em Criar e selecione
OAuth 2.0 integration
. - Forneça um nome adequado para a aplicação e crie a nova aplicação.
- Navegue para
Permissions
a partir do painel de navegação à esquerda. Clique em Adicionar paraConfluence 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 |
- Clique em Salvar.
- 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. - Navegue para
Settings
a partir do painel de navegação à esquerda. Irá obter o eSecret
aClient 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:
- 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.
- 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.