Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O conector confluence Cloud Microsoft 365 Copilot integra conteúdos da Confluence no Microsoft 365, permitindo que o Copilot, a Copilot Search e o Microsoft Search visualizem páginas wiki, blogues e anexos relevantes diretamente em aplicações como o Teams, o Outlook e o SharePoint.
Este artigo fornece informações sobre os passos de configuração que os administradores do Confluence precisam de concluir para configurar a Confluence Cloud para a sua organização, incluindo a configuração do ambiente e a configuração de pré-requisitos para o conector confluence Cloud.
Para obter informações sobre como implementar o conector, veja Deploy the Confluence Cloud connector (Implementar o conector confluence Cloud).
Lista de verificação de configuração
As seguintes listas de verificação listam o passo envolvido na configuração do ambiente e na configuração dos pré-requisitos do conector.
Configurar o ambiente
| Tarefa | Função |
|---|---|
| Identificar o URL da instância | Administrador de confluência |
| Rever a configuração de espaços e páginas | Administrador de confluência |
| Definir mapeamento de atributos | Administrador de confluência |
| Configurar permissões de acesso de utilizador | Administrador de confluência |
| Adicionar descrições a espaços e páginas | Administrador de confluência |
| Configurar a sincronização do Entra ID no Crowd | Administrador de confluência |
Configurar pré-requisitos
| Tarefa | Função |
|---|---|
| Criar conta de serviço | Administrador de confluência |
| Identificar a contagem de itens para ingestão | Administrador de confluência |
| Configurar o CQL para pesquisa avançada | Administrador de confluência |
| Aprovisionar um ponto final OAuth | Administrador de confluência |
| Adicionar endereço IP à lista de permissões | Administrador de confluência/Administrador de rede |
| Validar a indexação do Copilot | Administrador de confluência |
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 da Cloud confluence tem o seguinte formato:
https://<organization_name>.atlassian.net/wiki
Para identificar o URL da instância para a Cloud de Confluence:
- Inicie sessão na sua conta do Confluence .
- Selecione URLs do produto.
- Em URLs predefinidos, localize o nome e o produto do site.
Também pode ver o URL no browser quando estiver a utilizar a Confluence Cloud.
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.
Na Confluence Cloud, certifique-se de que os espaços seguem convenções de nomenclatura claras, utilizam etiquetas de forma consistente e aplicam permissões que correspondam à visibilidade pretendida para Copilot, Copilot Search e Microsoft Search. Organize páginas numa hierarquia lógica e utilize títulos e metadados significativos para melhorar a precisão da pesquisa.
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.
| Recurso | Grupos LDAP | Grupos nativos de Confluence |
|---|---|---|
| Origem | Gerido num diretório externo | Gerido dentro da Confluência |
| Sincronização | Sincronizado periodicamente através da configuração do diretório de utilizador | Criado e mantido manualmente pelos administradores da Confluence |
| Escalabilidade | Altamente dimensionável para utilização empresarial | Adequado para pequenas equipas ou configurações apenas de Confluence |
| Controle de acesso | Reflete automaticamente as alterações de diretório | Requer atualizações manuais |
| Auditoria e conformidade | Alinhado com políticas de TI e arquiteturas de conformidade | Controlo descentralizado |
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 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.
Configurar pré-requisitos do conector
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.
Observação
As alterações à conta de serviço podem afetar a sincronização de dados com o Microsoft 365. Se a conta for modificada, poderá ter de voltar a autenticar o conector no Microsoft 365.
Certifique-se de que a conta de serviço está configurada corretamente. Se não existirem restrições ao nível da página, o conector verifica as permissões ao nível do espaço e serve o conteúdo da seguinte forma:
- Se o acesso anónimo estiver ativado para um espaço, o respetivo conteúdo é visível para todos os utilizadores no seu inquilino.
- Se o acesso anónimo estiver desativado, são impostas permissões ao nível do espaço.
- Se não forem definidas permissões ao nível do espaço, o conteúdo não será visível para nenhum utilizador no seu inquilino.
Observação
As permissões são geridas apenas ao nível do espaço e da página. As permissões da página principal não são consideradas.
Falha de OAuth devido a credenciais inválidas
Se o administrador do Microsoft 365 não for também um administrador do Confluence Cloud, 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:
Abra uma janela de navegação InPrivate e inicie sessão no portal de administração com as suas credenciais.
No portal de administração, selecione a origem de dados Confluence e comece a criar a ligação.
Para Autenticação, selecione OAuth 2.0.
Introduza o ID de cliente e o segredo do cliente da aplicação criada pelo administrador do Confluence.
Selecione Autorizar. É aberta uma janela de pop-up.
Copie o URL do pop-up e partilhe-o com o administrador do Confluence.
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.
Depois de o administrador do Confluence confirmar a aprovação, regresse à janela de pop-up.
Clique com o botão direito do rato na janela de pop-up e selecione Inspecionar>Consola.
Na consola do , cole o seguinte comando:
window.opener.postMessage({type: 'oauthFinish', isSuccess: true}, '*')Observação
Se a colagem estiver desativada, escreva
allow pastingprimeiro na consola e, em seguida, cole novamente o comando.É apresentada uma mensagem de êxito no ecrã de criação da ligação e o botão Criar fica ativo.
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 Confluence Cloud:
- Saiba mais em
https://<Confluence instance name>.atlassian.net/wiki/admin/space-reports. - Em Relatório de espaço, selecione Criar relatório.
- Selecione Transferir para exportar o relatório.
- Abra o ficheiro .csv transferido.
- Na coluna Contagem de Conteúdos , reveja o número de páginas que serão sincronizadas em cada espaço.
Observação
Os conteúdos gerados por IA no relatório podem ser imprecisos. Reveja o conteúdo antes de continuar.
Configurar o CQL para pesquisa avançada
Para obter páginas de um espaço específico na Cloud de Confluence que têm determinadas etiquetas e foram modificadas pela última vez num período de tempo definido, utilize a Linguagem de Consulta Confluence (CQL).
Inclua os seguintes componentes na consulta:
- Tecla de espaço – identifica o espaço que pretende procurar.
- Tipo de página – filtra os resultados para incluir apenas páginas.
- Etiquetas – filtra páginas por uma ou mais etiquetas.
- Data da última modificação – limita os resultados a páginas modificadas dentro de um período de tempo específico.
O exemplo seguinte mostra uma consulta CQL.
CQLtype = page AND space = "SPACEKEY" AND label in ("label1", "label2") AND lastmodified >= "2025-01-01"
No exemplo anterior:
-
type= página: Devolve apenas páginas. -
space= "SPACEKEY": substitua "SPACEKEY" pela chave real do seu espaço. -
labelem ("label1", "label2"): devolve páginas com etiqueta1 ou etiqueta2. -
lastmodified>= "2025-01-01": Devolve páginas modificadas em ou depois de 1 de janeiro de 2025.
Pode ajustar o formato de data para yyyy-MM-dd ou yyyy-MM-dd HH:mm para incluir a hora.
Dica
- Para filtragem de etiquetas, utilize a etiqueta em (...) para corresponder a várias etiquetas.
- Para funções de data, o CQL suporta funções dinâmicas como
startOfYear()ouendOfMonth()para simplificar a filtragem de datas. Por exemplo,lastmodified >= startOfYear()devolve páginas modificadas desde o início do ano atual.
Para executar a consulta com a API REST da Cloud de Confluence, utilize o seguinte pedido POST.
curl -u yourUsername:yourPassword \
-X POST "https://your-confluence-url/rest/api/search" \
-H "Content-Type: application/json" \
-d '{
"cql": "type=page AND space=\"SPACEKEY\" AND label=\"your-label\" AND lastmodified >= \"2025-01-01\"",
"limit": 25,
"start": 0
}'
Substituir:
-
yourUsernameeyourPasswordcom as suas credenciais ou utilize a autenticação baseada em tokens. -
https://your-confluence-urlcom o URL base da Confluence. -
SPACEKEYcom a sua tecla de espaço. -
your-labelcom a etiqueta pretendida. - Ajuste a data e a paginação conforme necessário.
Aprovisionar um ponto final OAuth
Para permitir que o conector da Confluence Cloud aceda à instância do Confluence Cloud, um administrador da Confluence tem de aprovisionar um ponto final OAuth para ativar a aplicação Microsoft Search e Microsoft 365 Copilot para aceder à instância.
Para obter instruções detalhadas, veja Registar uma aplicação na Confluence Cloud.
Utilize a tabela seguinte para determinar quais os âmbitos a selecionar ao configurar o acesso através da API de Confluence.
| Nome do escopo | Código |
|---|---|
| Ver detalhes do conteúdo Ver detalhes sobre o conteúdo e as respetivas propriedades associadas. |
read:content-details:confluence |
| Ver registos de auditoria Ver e exportar registos de auditoria para eventos de Confluence. |
read:audit-log:confluence |
| Ver páginas Ver conteúdo da página. |
read:page:confluence |
| Ver grupos Ver detalhes sobre grupos, incluindo os respetivos membros. |
read:group:confluence |
| Ver detalhes do utilizador Ver detalhes do utilizador. |
read:user:confluence |
| Ver espaços Ver detalhes do espaço. |
read:space:confluence |
| Ver restrições de conteúdo e permissões de espaço Ver as restrições de conteúdo e os detalhes das permissões de espaço. |
read:permission:confluence |
| Ver resumos de conteúdo Ver informações sobre o conteúdo. Tenha em atenção que isto não fornece acesso ao conteúdo propriamente dito. |
read:content.metadata:confluence |
| Ver comentários Ver comentários em páginas ou mensagens de blogue. |
read:comment:confluence |
| Ver e transferir anexos de conteúdo Ver e transferir anexos de uma página ou mensagem de blogue à qual tenha acesso. |
read:attachment:confluence |
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 a Confluence Cloud, se a configuração da rede bloquear o acesso às APIs de Confluence, certifique-se de que os endereços IP listados nas seguintes páginas de documentação são permitidos:
- Regras da Firewall de IP
- Endereços IP e domínios para permitir a lista de permissões na firewall empresarial
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:
- Reveja se todos os itens necessários são sincronizados com a Microsoft, com base nos pré-requisitos.
- Aceda à página Detalhes do conector .
- Verifique se a contagem de índices corresponde à contagem de páginas no espaço de Confluence configurado.