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
- Resumir o documento de arquitetura
-
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
- 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
- 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
- Autenticação: certifique-se de que tem credenciais de autenticação com acesso certo.
Importante
Recomendado: o Administrador Global de Confluence deve criar a ligação
Quem é o administrador global da confluência?
Um Administrador de Confluência é um utilizador a quem foram concedidas permissões administrativas completas.
- Para marcar isto: Aceda aPermissões Globais deConfiguração Geralda Administração>>
- Procure o grupo Confluence-administrators, que tem todas as permissões ativadas, incluindo - Pode Utilizar, Espaço Pessoal, Criar Espaço(s), Administrador de Confluências e Administrador de Sistema.
- Qualquer utilizador que crie um token tem de ser membro deste grupo
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.
Observação
O GCA pode ser instalado num computador Windows diferente e não tem de estar no mesmo computador do servidor no local. O computador pode ajudar a gerar o ID da Aplicação e o segredo que podem ser utilizados para a configuração. Tem de se certificar de que a máquina GCA está ativada durante a pesquisa. Poderá encontrar respostas a perguntas comuns sobre o GCA realted na secção FAQ .
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
Observação
O plug-in é suportado para a versão de confluência acima da versão 8.0.
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.
- Aceda a Administração Configuração >> geral Ligações da aplicação.
- Selecione Criar ligação
- Selecione Aplicação externa e, em seguida, selecione Recebido como a direção.
- Preencha o
- URL de redirecionamento:
https://gcs.office.com/v1.0/admin/oauth/callback - Âmbito:
a) Se for um Administrador Global da Confluência, é suportado um dos seguintes âmbitos: Administração ou Leitura.
b) Se for outro tipo de Administrador de Confluência, forneça o âmbito de Administração
- 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 |
| Sincronização | |
|---|---|
| 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 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:
- 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.
- 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.
Importante
- 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 "não 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
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.
Importante
- Certifique-se de que as datas estão por ordem cronológica. A "Data da Última Criação" não deve ser posterior à "Data da Última Modificação".
- Se não forem especificadas datas, todos os documentos serão considerados para indexação.
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:
| Propriedade Source | Rótulo | Esquema |
|---|---|---|
| Autor | autores | Consultar, Obter |
| Conteúdo | Pesquisar | |
| CreatedByName | Criado por | Procurar, Consultar, Obter |
| CriadoOn | Data e hora de criação | Consultar, Obter |
| Id | Consultar, Obter | |
| Árvore de Páginas | Obter | |
| SpaceName | Procurar, Consultar, Obter | |
| Título | title | Procurar, Obter |
| UpdatedByName | lastModifiedBy | Obter |
| UpdatedOn | lastModifiedDateTime | Consultar, Obter, Refinar |
| URL | url | Obter |
Pré-visualizar Dados
Utilize o botão de pré-visualização de resultados para verificar as propriedades e filtros selecionados.
Observação
Tenha em atenção que a pré-visualização apenas respeita a filtragem ao nível do espaço.
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.