Configurar o serviço no local do Confluence para ingestão de conectores

O conector Confluence No Local permite que o Microsoft 365 indexe e obtenha conteúdos de instâncias de Servidor ou Centro de Dados de Confluência autoalojados. Traz conteúdos wiki empresariais para o Microsoft Search e Copilot, melhorando a visibilidade e a usabilidade no ecossistema do Microsoft 365.

Este artigo fornece informações sobre os passos de configuração que os administradores do Confluence precisam de concluir para que a sua organização implemente o conector No Local do Confluence para a sua organização, incluindo a configuração do ambiente e a configuração de pré-requisitos para o conector No Local do Confluence.

Para obter informações sobre como implementar o conector, veja Deploy the Confluence On-premises connector (Implementar o conector No Local do Confluence).

Lista de verificação de configuração

As seguintes listas de verificação listam os passos envolvidos na configuração do ambiente e na configuração dos pré-requisitos do conector.

Configurar o ambiente

Configurar pré-requisitos

Configurar o ambiente de Confluence

As secções seguintes descrevem as tarefas de administrador para configurar o ambiente confluence para ativar e otimizar a ligação.

Identificar o URL da instância do Confluence

Geralmente, o URL da instância no local do Confluence tem o seguinte formato:

• https://<your-company-domain>/confluence

Para identificar o URL da instância da Confluence no local:

• Na consola de administração do Confluence, aceda aURL base do Servidor de configuração> geral.

Em alternativa, para obter o URL da instância:

• Abra o Confluence no browser.
• Copie o endereço da barra de endereço do browser.
  • Se estiver a ver a dashboard, o URL do site faz parte do endereço que vem antes /index-action de ou /# (por exemplo, /#popular, /#recently-worked).
  • Se estiver a ver uma página ou mensagem de blogue, o URL do site é a parte do endereço que vem antes /display de ou /pages.

Seguem-se exemplos de URLs do site no local do Confluence:

• https://www.myconfluence.com
• https://confluence.mycompany.com
• https://mycompany.com/confluence
• https://myjirasite.com/wiki
• https://confluence.mycompany:443

Reveja a configuração de espaços e páginas de Confluence

Para otimizar a indexação e os resultados da pesquisa, reveja a configuração de espaços e páginas na Cloud do Confluence e no Centro de Dados do Confluence. Isto ajuda a garantir que os resultados da pesquisa no Microsoft 365 estão completos, seguros e alinhados com as expectativas dos utilizadores.

No Centro de Dados do Confluence, verifique se o plug-in necessário está instalado e se o agente do conector do Microsoft Graph pode aceder aos espaços e páginas que pretende indexar. Confirme que as permissões, as status de páginas (publicadas ou rascunhos) e a utilização de etiquetas estão definidas para incluir apenas conteúdo relevante.

Definir mapeamento de atributos confluence

O método predefinido para mapear as identidades da origem de dados para Microsoft Entra ID é determinar se o endereço de e-mail de cada utilizador da Confluence corresponde ao nome principal de utilizador (UPN) ou ao endereço de e-mail no Microsoft Entra ID. Se este mapeamento predefinido não corresponder às necessidades da sua organização, pode definir uma fórmula de mapeamento personalizada.

Para obter mais informações sobre identidades de mapeamento que não estão no Microsoft Entra ID, consulte Mapear as suas identidades não Azure AD.

Configurar permissões de acesso de utilizador

Os administradores de confluência podem integrar diretórios LDAP , como Microsoft Entra ID, para gerir centralmente o acesso e as permissões dos utilizadores. Ao sincronizar grupos LDAP na Confluence, os administradores podem atribuir esses grupos a espaços e páginas para controlar o acesso de visualização e edição para se alinharem com a governação de identidades a nível empresarial.

Pode utilizar grupos aninhados sincronizados para gerir listas de controlo de acesso (ACLs), desde que os membros do grupo aninhado façam parte de um grupo de utilizadores do Confluence.

A tabela seguinte fornece uma comparação entre grupos LDAP e grupos nativos do Confluence para permissões de acesso de utilizadores do Confluence.

Adicionar descrições para espaços e páginas

O Copilot utiliza as descrições e descrições breves no Confluence para corresponder semântica espaços e páginas com pedidos de utilizador. Se as descrições estiverem em falta, a relevância das respostas do Copilot é reduzida. Certifique-se de que adiciona descrições e descrições breves para espaços e páginas na sua instância de Confluence.

Configurar servidores confluence para elevada disponibilidade

Pode implementar o Centro de Dados do Confluence numa configuração de elevada disponibilidade através de um balanceador de carga de hardware. Certifique-se de que regista o URL da Web do Confluence e verifique se todos os clientes na rede interna podem aceder ao mesmo.

O Agente do Conector do Microsoft Graph tem de ser configurado para comunicar com o URL Web do Confluence com balanceamento de carga e não com nós individuais. Isto garante um acesso consistente e suporte de ativação pós-falha. Verifique se o URL com balanceamento de carga está acessível a partir da rede interna onde o Agente do Conector do Graph está alojado.

Para obter mais informações, veja Clustering with Confluence Data Center (Clustering com o Confluence Data Center).

Ativar o JavaScript no servidor Apache

Para garantir que o ecrã de consentimento da Confluence é apresentado corretamente, verifique a configuração do conector TCP para a interface Web da aplicação no <confluence-install-dir>/conf/server.xml ficheiro.

Abra o <confluence-install-dir>/conf/server.xml ficheiro e adicione o atributo em falta secure="true" ao conector associado ao URL base do Confluence, conforme mostrado no exemplo seguinte.

<Connector port="8090" connectionTimeout="20000" redirectPort="8443"
    maxThreads="48" minSpareThreads="10"
    enableLookups="false" acceptCount="10" debug="0" URIEncoding="UTF-8"
    protocol="org.apache.coyote.http11.Http11NioProtocol"
    scheme="https" secure="true" proxyName="<CONFLUENCE_PROXY_NAME_HERE>" proxyPort="443"
    compression="on" compressibleMimeType="text/html,text/xml,text/plain,text/css,applicat" />

Configurar a sincronização do Entra ID no Crowd

Pode configurar Microsoft Entra ID como um diretório no Crowd. Quando configura Microsoft Entra ID, todas as alterações aos seus utilizadores, grupos e associações são sincronizadas entre Microsoft Entra ID e Crowd periodicamente ou sempre que o pedir. Pode ver informações sobre os seus utilizadores diretamente no Crowd através do browser Utilizador e do browser Grupo.

Para obter mais informações, veja Configurar Microsoft Entra ID.

Verificar as configurações de limitação da API para gerir recursos de computação

Os conectores copilot limitam os pedidos a uma taxa de 25 pedidos por segundo. Se tiver configurado a limitação da API para limitar o volume de pedidos, esta definição pode afetar a duração de uma pesquisa completa.

Para reduzir o número de pedidos enviados pelo conector, pode submeter um pedido de suporte. Certifique-se de que inclui os seguintes detalhes de configuração do servidor do Centro de Dados do Confluence:

• Pedidos permitidos por nó
• Máximo de pedidos

Configurar pré-requisitos

As secções seguintes descrevem os passos de pré-requisitos a concluir antes de implementar o conector Confluence.

Criar conta de serviço

Para permitir que o conector confluence atualize itens regularmente, configure uma conta de serviço com acesso de leitura a tabelas de conhecimento específicas do Confluence.

Certifique-se de que a conta de serviço tem permissões de leitura para as seguintes tabelas necessárias:

• Espaços

Conceda permissões de leitura em todas as tabelas aplicáveis. Para obter mais informações, veja Conceder permissões de administrador aos utilizadores.

Falha de OAuth devido a credenciais inválidas

Se o administrador do Microsoft 365 não for também um Administrador no local do Confluence, a autorização de ligação falhará com o erro "Credenciais de ligação inválidas". Para resolve este erro, o administrador do Microsoft 365 pode seguir estes passos:

1. Abra uma janela de navegação InPrivate e inicie sessão no portal de administração com as suas credenciais.
2. No portal de administração, selecione a origem de dados Confluence e comece a criar a ligação.
3. Para Autenticação, selecione OAuth 2.0.
4. Introduza o ID de cliente e o segredo do cliente da aplicação criada pelo administrador do Confluence.
5. Selecione Autorizar. É aberta uma janela de pop-up.
6. Copie o URL do pop-up e partilhe-o com o administrador do Confluence.
7. Peça ao administrador do Confluence para iniciar sessão na conta confluence e aprovar o pedido. Após a aprovação, é apresentado um ecrã em branco, o que confirma o êxito.
8. Depois de o administrador do Confluence confirmar a aprovação, regresse à janela de pop-up.
9. Clique com o botão direito do rato na janela de pop-up e selecione Inspecionar>Consola.
10. Na consola do , cole o seguinte comando: window.opener.postMessage({type: 'oauthFinish', isSuccess: true}, '*')

    Observação

    Se a colagem estiver desativada, escreva allow pasting primeiro na consola e, em seguida, cole novamente o comando.

11. É apresentada uma mensagem de êxito no ecrã de criação da ligação e o botão Criar fica ativo.
12. Agora pode fechar a janela de pop-up.

Identificar a contagem de itens para ingestão

Para verificar a contagem de itens esperada para ingestão em todos os conectores aplicáveis na instância do Confluence No local:

1. Aceda a Administração Administração>da Administração.
2. Selecione Configuração Geral.
3. Selecione Informações do Sistema.
4. Procure Utilização da Confluência. Esta secção fornece métricas detalhadas sobre a sua instância de Confluence.

Também pode aceder diretamente às informações do sistema em: https://<yoursitename>/confluence/admin/systeminfo.action.

Aprovisionar um ponto final OAuth

Para autenticar e sincronizar conteúdos da Confluence no local, pode escolher entre três métodos suportados:

• OAuth 2.0 (recomendado) – registe uma aplicação e configure uma ligação de entrada.
• Autenticação básica – utilize o seu nome de utilizador e palavra-passe do Confluence.
• OAuth 1.0a - Gere um par de chaves públicas/privadas e configure uma ligação de aplicação no Confluence.

Para configurar o OAuth 2.0 (recomendado):

1. Aceda a Administração Configuração>>geralLigações da aplicação.
2. Selecione Criar ligação.
3. Selecione Aplicação externa e, em seguida, selecione Recebido como a direção.
4. Defina o âmbito como Administração.
5. Introduza o URL de redirecionamento: https://gcs.office.com/v1.0/admin/oauth/callback.

Adicionar endereço IP à lista de permissões

Para garantir que o conector pode aceder às APIs de Confluence, adicione os endereços IP do Microsoft 365 necessários à lista de permissões na firewall, no proxy ou noutras configurações de rede.

Para o Confluence no local, certifique-se de que o servidor que aloja a instância do Confluence no local consegue aceder a todos os URLs e endereços IP do Microsoft 365 necessários. Para obter mais informações, veja Regras da Firewall de IP.

Configurar um computador para o agente do conector

Para ligar ao Confluence No local, implemente uma máquina virtual ou física para o Agente do Conector do Microsoft Graph. Certifique-se de que o computador consegue ligar ao balanceador de carga do Confluence e cumpre os seguintes requisitos de hardware e software.

Sistemas operacionais com suporte

• Windows 10
• Windows Server 2016 R2 e posterior

Softwares necessários

• .NET Framework 4.7.2
• .NET Core Desktop Runtime 8.0 (x64)

Requisitos de hardware

• 8 núcleos a 3 GHz
• 16 GB de RAM
• Espaço em disco de 40 GB para até 5 milhões de itens
• 7 GB adicionais por milhão de itens para além dos 5 milhões iniciais

Requisitos de rede

• Acesso de rede à origem de dados Confluence
• Acesso à Internet através da porta 443

Instalar o plug-in do conector do Confluence

Para ligar o Confluence Data Center ao conector Confluence, tem de instalar o plug-in do Conector do Confluence Graph. Uma vez que o Confluence Data Center está alojado no local e não suporta APIs na cloud nativas, o plug-in é necessário para ativar a indexação externa segura. O plug-in funciona como uma ponte entre o Agente do Conector do Microsoft Graph e a instância do Confluence. Permite que o agente autentique, aceda e extraia conteúdo estruturado , incluindo espaços, páginas, títulos, metadados e etiquetas, respeitando o modelo de permissão da Confluence.

Sem o plug-in, o conector não consegue consultar o conteúdo do Centro de Dados do Confluence de uma forma estruturada ou com deteção de permissão. O plug-in garante que o Copilot, o Copilot Search e o Microsoft Search proporcionam experiências de pesquisa seguras, relevantes e personalizadas no Microsoft 365.

Para instalar o plug-in:

1. Transferir a aplicação a partir dos Conectores do Microsoft Graph para Confluence No Local | Atlassian Marketplace.
2. Inicie sessão no seu sistema confluence.
3. Aceda a Definições>Gerir aplicações.
4. Selecione Carregar aplicação.
5. Selecione o ficheiro transferido e continue.

Validar a indexação do Copilot para a Confluence

Para confirmar que Microsoft 365 Copilot pode aceder ao conteúdo necessário a partir da Confluence, siga estes passos de validação:

1. Reveja se todos os itens necessários são sincronizados com a Microsoft, com base nos pré-requisitos.
2. Aceda à página Detalhes do conector .
3. Verifique se a contagem de índices corresponde à contagem de páginas no espaço de Confluence configurado.

Próxima etapa