Associe o Confluence Cloud

Esta página descreve como associar o Confluence Cloud ao Gemini Enterprise.

Depois de configurar a origem de dados e importar dados pela primeira vez, o armazenamento de dados sincroniza os dados dessa origem com uma frequência que seleciona durante a configuração.

Versões suportadas

O conetor do Confluence Cloud é compatível com as versões v1 e v2 da API REST do Confluence.

Antes de começar

Antes de configurar a ligação:

1. Valide que tem acesso de administrador à instância e ao projeto do Confluence.

2. (Opcional) Para aceder aos endereços de email dos utilizadores do Confluence Cloud, mesmo quando as definições restringem a visibilidade do email, instale a app User Identity Accessor for Confluence Cloud. Tem de ser um Confluence Site administrator para instalar e configurar esta app. Depois de instalar a app, configure-a para aceder de forma segura aos endereços de email dos utilizadores. Pode não precisar de instalar esta app se os endereços de email forem acessíveis publicamente.

3. Conceda a função de editor do motor de descoberta (roles/discoveryengine.editor). Esta função é necessária para o utilizador criar o arquivo de dados. Para conceder esta função, faça o seguinte:

   1. Na Google Cloud consola, aceda à página IAM.

      Aceder ao IAM

   2. Localize a conta de utilizador e clique no ícone Editar .

   3. Conceda a função de editor do motor de descoberta ao utilizador.

4. Para aplicar o controlo de acesso à origem de dados e proteger os dados no Gemini Enterprise, certifique-se de que configurou o seu fornecedor de identidade.

Configure a autenticação e as autorizações no Confluence

Pode autenticar-se no Confluence através de credenciais do cliente OAuth ou autenticação baseada em token de API. As secções seguintes fornecem informações sobre como criar credenciais do cliente OAuth e um token da API.

Crie credenciais do cliente OAuth

Use as seguintes instruções para criar um ID de cliente e um segredo do cliente, configurar os âmbitos do OAuth 2.0 necessários, configurar autorizações para os utilizadores, obter o URL e o ID da instância, configurar funções e autenticar para sincronizar dados entre o Confluence Cloud e o Gemini Enterprise. Para ativar o OAuth 2.0 e obter o ID de cliente e o segredo, consulte o artigo Apps OAuth 2.0 (3LO) na documentação do programador da Atlassian.

1. Crie uma integração do OAuth 2.0 na Atlassian Developer Console:

   1. Inicie sessão na Atlassian Developer Console.

   2. Clique no ícone do perfil e selecione Consola do programador.

      

      Selecione a Developer Console

   3. Clique em Criar e selecione Integração OAuth 2.0.

      

      Selecione Integração do OAuth 2.0

   4. Introduza um nome para a app e faça o seguinte:

      1. Selecione a caixa de verificação dos Termos de Utilização.

      2. Clique em Criar.

         

         Crie uma nova integração do OAuth 2.0

      3. Clique em Autorização.

      4. Na tabela Tipo de autorização, clique em Adicionar para OAuth 2.0 (3LO).

         

         Adicione o tipo de autorização

   5. No campo URL de retorno de chamada, introduza https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html

   6. Clique em Guardar alterações.

      

      Guardar alterações

Se vir o aviso: A sua app não tem APIs. Adicione APIs à sua app. Continue com o procedimento seguinte para configurar o OAuth 2.0. Caso contrário, avance para o passo 4 desse procedimento.

Nota: os âmbitos clássicos não estão disponíveis para os conetores do Confluence Cloud. Além disso, depois de adicionar a API Confluence, o botão Configurar pode demorar algum tempo a aparecer. Se não aparecer imediatamente, experimente atualizar a página ou aguardar alguns segundos.

Para configurar o OAuth 2.0 e obter as credenciais necessárias para a configuração do conetor do Confluence, faça o seguinte:

1. Ative o OAuth 2.0:

   1. Clique em Autorizações.

      

      Selecionar autorizações

   2. Aceda à API Confluence.

   3. Clique em Adicionar.

   4. Clique em Configurar.

   5. Aceda ao separador Âmbitos detalhados e clique em Editar âmbitos.

      

      Editar âmbitos

   6. Selecione os seguintes âmbitos.

      • read:attachment:confluence
      • read:configuration:confluence
      • read:content.metadata:confluence
      • read:content-details:confluence
      • read:whiteboard:confluence
      • read:group:confluence
      • read:space:confluence
      • read:user:confluence

   7. Confirme que estão selecionados oito âmbitos e guarde as alterações.

2. Obtenha o ID de cliente e o segredo do cliente:

   1. Clique em Distribuição.

   2. Selecione Editar.

      

      Editar distribuição

   3. Selecione Partilha para ativar a edição de outros campos.

   4. Preencha os restantes campos. Certifique-se de que define o Nome do fornecedor como Google e a Política de Privacidade como https://policies.google.com.

   5. Na secção Declaração de dados pessoais, faça o seguinte:

      1. Na lista A sua app armazena dados pessoais?, selecione Sim.

      2. Para confirmar que implementou a API Personal Data Reporting, selecione a caixa de verificação Confirmo que implementei a API Personal Data Reporting.

      3. Clique em Guardar alterações.

   6. Selecione Definições e, de seguida, copie os valores dos campos ID do cliente e Segredo do cliente.

      

      Copie o ID de cliente e o segredo do cliente

3. Obtenha o URL da instância:

   1. Aceda a atlassian.net e inicie sessão com a sua conta de administrador.
   2. Selecione a app que quer sincronizar. Por exemplo, sincronize a primeira app.
   3. Encontre o URL da instância. Aparece como o subdomínio na barra de endereço.

4. Obtenha o ID da instância:

   1. Abra um novo separador, copie o URL da instância e anexe /_edge/tenant_info ao URL da instância. Por exemplo, https://<var>YOUR-INSTANCE</var>.atlassian.net/_edge/tenant_info.

   2. Navegue para o link para encontrar o valor cloudId. O cloudId é o ID da instância.

      

      Obtenha o ID da instância

Âmbitos do OAuth mínimos

A tabela seguinte lista os âmbitos do OAuth mínimos necessários para criar um conetor do Confluence Cloud:

Autorização	Motivo da utilização	Descrição
read:content-details:confluence	Carregamento de dados	Permite que o conector leia os detalhes do conteúdo no Confluence.
read:content.metadata:confluence	Carregamento de dados	Permite que o conector leia os metadados de conteúdo.
read:space:confluence	Carregamento de dados	Permite que o conetor leia espaços.
read:whiteboard:confluence	Carregamento de dados	Permite que o conetor leia quadros brancos.
read:attachment:confluence	Carregamento de dados	Permite que o conetor leia anexos.
read:configuration:confluence	Aplique LCAs (Listas de controlo de acesso)	Ativa a aplicação de ACLs para aceder ao site do Confluence.
read:group:confluence	Aplique LCAs (Listas de controlo de acesso)	Ativa a aplicação de ACLs para ler detalhes de utilizadores e grupos.
read:user:confluence	Aplique LCAs (Listas de controlo de acesso)	Ativa a aplicação de ACLs para ler detalhes do utilizador.

Nota: além das autorizações de administrador, também tem de ter acesso aos registos de entidades específicos, como blogues ou publicações.

Configure um token de API no Confluence

Se planeia usar um token de API para autenticação, tem de criar um token de API sem âmbitos. Este conetor não suporta o token da API com âmbitos.

1. Inicie sessão na Atlassian Console.
2. Clique em Criar token de API.
3. Introduza um nome para o token da API.
4. Selecione uma data de validade para o token da API. O período de validade do token varia entre 1 e 365 dias.
5. Clique em Criar.
6. Guarde o token para utilização posterior.

Obtenha o URL da instância

1. Aceda a atlassian.net e inicie sessão com a sua conta de administrador.
2. Selecione a app que quer sincronizar. Por exemplo, sincronize a primeira app.
3. Encontre o URL da instância. Aparece como o subdomínio na barra de endereço.

Faça a gestão da visibilidade dos utilizadores e atribua funções

Nota: para que as autorizações do utilizador se apliquem corretamente, cada utilizador do Confluence Cloud tem de tornar o respetivo email visível para todos os utilizadores. Para tal, altere as definições de visibilidade do email no Confluence Cloud e defina a visibilidade como Anyone.

Para definir a visibilidade do utilizador, faça o seguinte:

1. Inicie sessão na Atlassian Developer Console.

2. Clique no ícone do perfil de utilizador e aceda a Gerir conta.

   

   Faça a gestão da conta

3. Navegue para Perfil e visibilidade.

   

   Perfil e visibilidade

4. Aceda a Contacto e defina a opção Quem pode ver isto como Qualquer pessoa.

   

   Contactar

Conceda a um utilizador uma função de administrador

Opcionalmente, pode conceder a outro utilizador uma função de administrador no Atlassian.

1. Inicie sessão no Atlassian com uma conta de administrador.

2. Clique no ícone de menu e selecione a sua organização. Em alternativa, pode aceder a admin.atlassian.com.

3. Na página Apps, clique em (o ícone de reticências) junto a Confluence e selecione o botão Gerir utilizadores.

   

   Faça a gestão dos utilizadores

4. Clique em Grupos em Gestão de utilizadores.

5. Na página Grupos:

   1. Clique em Criar grupo.
   2. Introduza um nome para o grupo.

   

   Criar grupo

   Este grupo recebe as autorizações necessárias para o conector. Os utilizadores adicionados a este grupo herdam estas autorizações. O conetor usa este grupo para fazer a autenticação e obter documentos.

6. Na página do grupo, clique em Adicionar produto.

   1. Selecione Administrador de acesso de utilizadores como função do produto.

   2. Clique em Adicionar.

      

      Administrador de acesso de utilizadores do Confluence

7. Clique em Adicionar membros do grupo para adicionar a conta de utilizador ou os membros do grupo que o conector usa para autenticar.

   

   Adicione membros do grupo

Instale e configure o User Identity Accessor para o Confluence Cloud

Se os endereços de email dos utilizadores não forem acessíveis publicamente por predefinição devido às definições de privacidade no Confluence Cloud, tem de instalar a app User Identity Accessor for Confluence Cloud para obter os endereços de email dos utilizadores de forma segura. Se os endereços de email dos utilizadores já forem visíveis publicamente, pode não precisar de instalar a app. Para mais informações sobre a visibilidade restrita de emails, consulte o artigo Faça a gestão da visibilidade dos utilizadores e atribua funções.

Funções e permissões

Para instalar e configurar a app User Identity Accessor for Confluence Cloud, tem de ter a função administrativa adequada e conceder as autorizações necessárias ao nível da app.

• Função necessária: tem de ser Confluence Site administrator para instalar e configurar a app.
• Autorizações ao nível da app: tem de conceder as seguintes autorizações durante a instalação da app:
  • Read Email Address: permite à app obter de forma segura os endereços de email dos utilizadores, mesmo quando a visibilidade do perfil está restrita.
  • App Storage scope: permite que a app leia e escreva no respetivo dispositivo de armazenamento.

Instale o User Identity Accessor para o Confluence Cloud

Para instalar a app User Identity Accessor for Confluence Cloud no seu site do Confluence, siga estes passos:

1. Navegue para a Atlassian Developer Console.

2. Reveja as autorizações Ler endereço de email e Âmbito de armazenamento da app e clique em Obter app.

   

   Reveja as autorizações e transfira a app

3. Na lista Selecione um site no qual instalar esta app, selecione o site do Confluence no qual quer instalar a app. Esta lista apresenta apenas os sites para os quais tem acesso de administrador.

   Nota: tem de ser administrador de, pelo menos, um site do Confluence para instalar a app.

4. Clique em Instalar para concluir a instalação da app.

Configure o User Identity Accessor para o Confluence Cloud

Depois de instalar a app User Identity Accessor for Confluence Cloud, configure uma chave de API que o seu sistema externo (por exemplo, o Confluence Cloud Connector) usa para chamar com segurança o acionador Web da app para obter emails.

Aceda à página de configuração

Para aceder à página de configuração da app User Identity Accessor for Confluence Cloud no Confluence Cloud, siga estes passos:

1. Na sua instância do Confluence Cloud, clique no ícone Definições ⚙️ no menu de navegação.
2. Selecione Apps no menu.
3. Na página Administração de apps, localize a sua app, User Identity Accessor for Confluence Cloud, na lista Gerir apps.

4. Clique em Configurar ou no link associado à sua app. A página de configuração dedicada da app é aberta no Confluence.

   

   Configure o User Identity Accessor para a app Confluence Cloud

Configure a chave da API

Para configurar a chave da API na página de configuração, siga estes passos:

1. Na secção Configuração da chave da API, especifique a chave secreta para autenticar pedidos ao Webtrigger da app. Pode autenticar pedidos através de um dos seguintes métodos:

   • Introduza a sua própria chave: escreva ou cole a sua própria chave da API forte e única no campo Chave da API. Use uma chave de, pelo menos, 20 a 30 carateres com uma combinação de letras maiúsculas, letras minúsculas, números e símbolos.

     

     Introduza a sua própria chave

   • Gerar uma chave: clique no botão Gerar nova chave. O sistema gera e apresenta uma chave forte e aleatória no campo.

     

     Gere uma chave

     Importante: copie imediatamente a chave da API apresentada no campo. Por motivos de segurança, pode não conseguir ver novamente a chave completa depois de a guardar ou sair da página. Se o perder, tem de definir ou gerar um novo.

2. Clique em Guardar chave da API. É apresentada uma mensagem de êxito a confirmar que a chave foi guardada em segurança.

Nota: a chave da API gerada ou criada nesta secção serve como valor para o campo Confluence Identity Sync Forge Client Secret na secção Opções avançadas durante a configuração do conector.

Teste a configuração da app

Verifique se o User Identity Accessor para a app Confluence Cloud está configurado corretamente enviando um pedido do seu sistema externo e confirmando que os endereços de email dos utilizadores são devolvidos com êxito.

Obtenha o URL do acionador Web

1. Na página Administração de apps, localize a secção URL do Webtrigger, que apresenta o URL exclusivo específico do seu site do Confluence e desta instalação da app:
   • O seu sistema externo tem de chamar este URL para pedir os emails dos utilizadores.
   • Normalmente, o URL tem o seguinte aspeto: http://uuid/domain.net/x1/randomId. Por exemplo, https://YOUR_INSTANCE_ID.hello.atlassian-dev.net/x1/WEBTRIGGER_ID, em que YOUR_INSTANCE_ID é o identificador da instância do Confluence Cloud e WEBTRIGGER_ID é o identificador exclusivo do ponto final do Webtrigger gerado para a sua app.
2. Clique no botão Copiar URL ou copie o URL completo.

Configure o seu sistema externo

• Configure o seu sistema externo que precisa de obter emails de utilizadores do Confluence com a chave da API e o URL do acionador Web obtidos nos passos anteriores.

  • URL do ponto final: o URL do acionador Web que copiou.
  • Método de HTTP: POST

  • Cabeçalhos obrigatórios:

    • Content-Type: application/json

    • X-Api-Key: YOUR_API_KEY

      Substitua YOUR_API_KEY pela chave da API que definiu ou gerou na secção Configure a chave da API.

Comando curl de exemplo

Este exemplo demonstra a chamada do acionador Web User Identity Accessor for Confluence Cloud, que aceita uma matriz de IDs de contas e devolve os endereços de email.

curl --location --request POST 'https://YOUR_INSTANCE_ID.hello.atlassian-dev.net/x1/ENDPOINT_PATH' \
--header 'X-Api-Key: YOUR-API-KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
   "accountIds": [
       "ACCOUNT_ID_1",
       "ACCOUNT_ID_2"
   ]
}'

Substituição:

• YOUR_INSTANCE_ID com o ID da instância do Confluence Cloud
• ENDPOINT_PATH com o caminho do ponto final da API
• YOUR_API_KEY com a chave da API que definiu ou gerou na secção Configure a chave da API
• ACCOUNT_ID com os IDs das contas da Atlassian que quer segmentar

Resposta esperada

[{"accountId":"ACCOUNT_ID_1","emailAddress":"EMAIL_ADDRESS_1"},
 {"accountId":"ACCOUNT_ID_2","emailAddress":"EMAIL_ADDRESS_2"}]

Substituição:

• ACCOUNT_ID_X com IDs de contas da Atlassian reais
• USER_EMAIL_X com os endereços de email dos utilizadores devolvidos pela chamada API

Implemente práticas recomendadas de segurança

Para confirmar a segurança da sua chave da API, siga estas recomendações:

• Armazene a chave de API em segurança na configuração do Confluence Cloud Connector.
• Certifique-se de que toda a comunicação com o URL do webhook ocorre através de HTTPS. Esta é a predefinição para os acionadores Web do User Identity Accessor for Confluence Cloud.

Apoio técnico do User Identity Accessor para o Confluence Cloud

As ofertas de apoio técnico estão disponíveis a partir de Google para a app User Identity Accessor for Confluence Cloud, que pode incluir manutenção e atualizações regulares para manter a app atualizada. Se tiver problemas ou perguntas específicas sobre a funcionalidade da app, contacte o Google Cloud apoio técnico.

Faça a gestão dos arquivos de dados do Confluence Cloud

Esta secção fornece instruções sobre como criar, atualizar e fazer a atualização de um repositório de dados do Confluence Cloud.

Crie um repositório de dados do Confluence Cloud

Consola

Para usar a Google Cloud consola para sincronizar dados do Confluence Cloud com o Gemini Enterprise, siga estes passos:

1. Na Google Cloud consola, aceda à página Gemini Enterprise.

   Gemini Enterprise

2. No menu de navegação, clique em Armazenamentos de dados.

3. Clique em Criar arquivo de dados.

4. Na página Selecionar uma origem de dados, desloque a página ou pesquise Confluence Cloud para associar a sua origem de terceiros.

5. Na página Especifique a origem do Confluence Cloud para o seu repositório de dados, faça o seguinte:

   1. Selecione o seu método de autenticação:

      

      Introduza os detalhes de autenticação

      • Para usar o OAuth para autenticação, selecione Credenciais do cliente OAuth 2.0 e, em seguida, especifique o URI da instância, o ID da instância, o ID do cliente e o segredo do cliente.

        • Clique em Iniciar sessão e escolha um site para a app.
        • Clique em Aceitar.

        O prazo de validade predefinido de um token de atualização é de 365 dias. Se o seu token de atualização expirar ou for revogado, pode fazer uma das seguintes ações:

        • Reinicie o fluxo OAuth. O utilizador que volta a autenticar tem de ter os privilégios de administrador.
        • Use o token de atualização para obter um novo par de token de acesso e token de atualização.

        Para mais informações, consulte o artigo O token de acesso expira ou é revogado.

        

        Escolha um site no qual usar a app

      • Para usar o token de API para autenticação, selecione Token de API e, em seguida, especifique o URI da instância, o nome de utilizador do Confluence e o token de API.

   2. Clique em Continuar.

6. (Opcional) Na secção Opções avançadas, faça o seguinte:

   1. Para permitir apenas um conjunto de endereços IP estáticos, selecione a caixa de verificação Ativar endereços IP estáticos.
   2. Para aplicar limites de taxa às consultas que os conetores enviam para a instância do Confluence, no campo CPS máx., especifique o número máximo de consultas por segundo. O valor predefinido é 20 QPS. Pode aumentar gradualmente o valor de QPS com base no desempenho do servidor do Confluence. Antes de aumentar o valor de QPS, considere o seguinte:
      • A carga existente no servidor Confluence.
      • O débito de outras aplicações de terceiros que estão a usar o servidor.
   3. No campo URL do Forge de sincronização de identidades do Confluence, introduza o URL gerado pelo User Identity Accessor para a app Confluence Cloud.
   4. No campo Confluence Identity Sync Forge Client Secret, introduza o segredo do cliente configurado no User Identity Accessor para o Confluence Cloud, que é a chave da API que gerou ou criou na secção Configure a chave da API.

7. Na secção Entidades a sincronizar, faça o seguinte:

   1. Selecione as entidades que quer sincronizar:

      • Página

      • Quadro branco

      • Blogue

      • Anexo

      • Comentar

      Os dados são carregados com base nas autorizações de administrador que tem quando cria o repositório de dados. Além das autorizações de administrador, também tem de ter acesso aos registos de entidades específicos, como blogsues ou publicações.

      Nota: quando sincroniza a entidade Página, o conteúdo do documento dinâmico também é sincronizado.

      

      Selecione as entidades a sincronizar

   2. Opcionalmente, para sincronizar a partir de espaços específicos, faça o seguinte:

      1. Clique em Filtrar.
      2. Para filtrar entidades do índice, selecione Excluir do índice ou, para garantir que são incluídas no índice, selecione Incluir no índice.
      3. Introduza as teclas de espaço. Prima Enter depois de cada tecla de espaço.
      4. Clique em Guardar.

   

   Especifique filtros para incluir ou excluir entidades.

8. Clique em Continuar.

9. Selecione a Frequência de sincronização para a Sincronização completa e a Frequência de sincronização incremental para a Sincronização de dados incremental. Para mais informações, consulte o artigo Sincronize programações.

   Se quiser agendar sincronizações completas separadas de dados de entidades e identidades, expanda o menu em Sincronização completa e, de seguida, selecione Opções personalizadas.

   

   Definir agendas separadas para a sincronização completa de entidades e a sincronização completa de identidades.

10. Selecione uma região para o conetor de dados.

11. Introduza um nome para o conetor de dados.

12. Clique em Criar. O Gemini Enterprise cria o seu repositório de dados e apresenta os seus repositórios de dados na página Repositórios de dados.

13. Para verificar o estado do carregamento, aceda à página Armazenamentos de dados e clique no nome do armazenamento de dados para ver os respetivos detalhes na página Dados. O estado do conector muda de A criar para Em execução quando começa a sincronizar dados. Quando o carregamento estiver concluído, o estado muda para Ativo para indicar que a ligação à sua origem de dados está configurada e a aguardar a próxima sincronização agendada.

    Consoante o tamanho dos seus dados, a carregamento pode demorar minutos ou horas.

Atualize o arquivo de dados

Pode atualizar os seguintes parâmetros da loja de dados:

• Nome do armazenamento de dados
• Credenciais de autenticação, como o ID de cliente, o segredo do cliente, a conta de utilizador e o token da API.
• CPS máx. e parâmetros da app de forja, como o URL de forja de sincronização de identidade do Confluence e o segredo do cliente.
• Frequência de sincronização completa, frequência de sincronização incremental e sincronização em tempo real.
• Condição de filtro para carregar dados de entidades.

Para atualizar o arquivo de dados, siga estes passos:

1. Na Google Cloud consola, aceda à página Gemini Enterprise.

   Gemini Enterprise

2. No menu de navegação, clique em Armazenamentos de dados.

3. Clique no nome do arquivo de dados que quer atualizar.

4. Atualize os seguintes valores:

   • Para atualizar o nome do repositório de dados, a frequência de sincronização completa ou a frequência de sincronização incremental, clique no ícone Editar .
   • Para atualizar a frequência da sincronização em tempo real, clique em Ver/editar junto a Sincronização em tempo real.
   • Para atualizar as credenciais de autenticação, clique em Voltar a autenticar e, de seguida, especifique os valores.
   • Para atualizar os parâmetros Max QPS ou da app Forge, clique em Ver/editar parâmetros e, de seguida, especifique os valores.
   • Para atualizar a condição do filtro para as entidades, na secção Entidades, clique em Editar parâmetros e, de seguida, clique em Filtros.

Atualize para um novo arquivo de dados

Se tiver problemas com a precisão dos resultados da pesquisa de entidades de páginas, faça o seguinte para atualizar para a versão mais recente do repositório de dados:

1. Identifique se usa a versão mais recente do arquivo de dados:
   1. No menu de navegação, clique em Armazenamentos de dados.
   2. Clique no nome do arquivo de dados.
   3. Na página de detalhes do arquivo de dados apresentada, no separador Entidades, clique na entidade Página.
   4. Na página Dados, verifique o valor do campo Tipo. Se o valor for Unstructured data, está a usar a versão mais recente do armazenamento de dados e não é necessária nenhuma ação. Se o valor for Structured data, avance com os seguintes passos para criar e migrar para o novo arquivo de dados.
2. Crie um novo arquivo de dados.
3. Certifique-se de que é concluída uma sincronização completa para o novo arquivo de dados com os dados necessários.
4. Adicione o novo arquivo de dados à app.
5. Pause as sincronizações no arquivo de dados anterior.
6. Depois de verificar se o novo repositório de dados está a funcionar como previsto para a pesquisa de entidades de páginas, elimine o repositório de dados anterior da app.

Ative a sincronização em tempo real

Pré-visualização: tem de estar na lista de autorizações para usar esta funcionalidade.

A sincronização em tempo real só sincroniza entidades de documentos e não sincroniza dados relacionados com entidades de identidade. A tabela seguinte mostra os eventos de documentos que são suportados com a sincronização em tempo real.

Entidades do Confluence	Criar	Atualizar	Eliminar	Alterações de permissões
Espaços
Páginas
Blogues
Anexos
Comentários
Quadros brancos

Ative a sincronização em tempo real 20 minutos após a criação do arquivo de dados do Confluence Cloud. Para ativar a sincronização em tempo real para uma origem de dados do Confluence, siga estes passos:

Gere um URL do webhook

1. Navegue para a página do Gemini Enterprise e, no menu de navegação, clique em Armazenamentos de dados.
2. Selecione um arquivo de dados do Confluence.

3. Clique em Ver/editar na linha Sincronização em tempo real.

   

   Sincronização em tempo real : estado desativado

4. Na caixa de diálogo Ver e editar parâmetros de sincronização em tempo real, faça o seguinte:

   1. Para ativar a sincronização em tempo real, clique no interruptor Ativar sincronização em tempo real.
   2. No campo Segredo do cliente, introduza um valor de marcador de posição, como clientsecret.
   3. Clique em Guardar.

      

      Ative a sincronização em tempo real

5. Depois de o estado da Sincronização em tempo real mudar para Running, clique em Ver/Editar.

   

   Sincronização em tempo real : estado de execução

6. Na caixa de diálogo Ver e editar parâmetros de sincronização em tempo real, faça o seguinte:

   1. Copie o URL do webhook.
   2. Clique em Fechar.

      

      Copiar URL do webhook

Subscreva eventos através da API

Para receber atualizações em tempo real do Confluence, tem de subscrever eventos específicos através de um pedido POST. Para fazer chamadas à API, use a mesma conta de administrador usada para configurar a autenticação e as autorizações no Confluence para criar o arquivo de dados.

      curl -X POST \
        INSTANCE_URL/wiki/rest/webhooks/1.0/webhook \
        -H "Content-Type: application/json" \
        -u "USERNAME:API_TOKEN" \
        -d '{
          "name": "SUBSCRIPTION_NAME",
          "url": "LISTENER_URL",
          "events": [
            "EVENT_TYPE_1",
            "EVENT_TYPE_2"
          ],
          "active": true
        }'

• INSTANCE_URL: o endereço Web base do seu site do Atlassian Cloud.

• USERNAME: O nome de utilizador do Atlassian Cloud.

• API_TOKEN: a chave da API gerada a partir da sua conta da Atlassian. Para mais informações, consulte o artigo Configure um token de API no Confluence

• SUBSCRIPTION_NAME: um nome exclusivo para a sua subscrição de eventos.

• LISTENER_URL: O URL do webhook copiado da Google Cloud consola assim que a sincronização em tempo real (RTS) estiver ativada no seu repositório de dados.

• EVENT_TYPE: os tipos de eventos aos quais quer subscrever. Pode subscrever a criação, a atualização e a eliminação de eventos para anexos, publicações no blogue, páginas, espaços e comentários.

  O utilizador pode subscrever os seguintes eventos:

  • space_created
  • space_updated
  • page_created
  • page_updated
  • attachment_created
  • attachment_updated
  • comment_created
  • comment_updated
  • blog_created
  • blog_updated
  Nota: os eventos Whiteboard e trashed não são suportados. Crie subscrições apenas para entidades já adicionadas ao seu repositório de dados para evitar a ingestão de dados indesejados.

  Exemplo de comando e resultado

  curl -X POST \
      https://cymbalgroup.atlassian.net/wiki/rest/webhooks/1.0/webhook \
      -H "Content-Type: application/json" \
      -u "admin1:######" \
      -d '{
        "name": "Cymbal_DCT",
        "events": [
          "attachment_created",
          "attachment_updated"
        ],
        "url": "https://rt-server-a-jx3m2-uw.a.run.app/webhook",
        "active": true
      }'
  
  {
  "name": "Cymbal_DCT",
  "url": "https://cymbalgroup.atlassian.net/wiki/rest/webhooks/1.0/webhook",
  "description": " Webhook for Cymbal DCT group to fetch attachments.",
  "excludeBody": false,
  "filters": {},
  "events": [
      "attachment_created",
      "attachment_updated",
  ],
  "enabled": true,
  "self": https://rt-server-a-jx3m2-uw.a.run.app/webhook,
  "lastUpdatedUser": "Cymb_389",
  "lastUpdatedDisplayName": "Ariel",
  "lastUpdated": 1752095647212
  }
  

Códigos de erro da API

Esta tabela apresenta códigos de erro comuns da API que os utilizadores encontram quando criam webhooks.

Classe de erro	Código de erro	Mensagem de erro	Resolução de problemas
403	FORBIDDEN	O utilizador atual não tem autorização para usar o Confluence.	Certifique-se de que tem um token válido de uma conta de administrador e um ponto final da API correto.

Mensagens de erro

A tabela seguinte descreve as mensagens de erro comuns, as respetivas descrições e as possíveis soluções quando associa o Confluence Cloud ao Gemini Enterprise.

Código de erro	Mensagem de erro	Descrição	Resolução de problemas
CONFLUENCE_INVALID_AUTHENTICATION_1	Erro de autenticação. Mais informações:	O conetor não consegue autenticar com o Confluence Cloud.	Volte a autenticar o arquivo de dados com as credenciais de administrador.
CONFLUENCE_INVALID_AUTHORIZATION_1	Erro de autorização. Mais informações:	Uma conta de utilizador sem privilégios de administrador tentou aceder ao Confluence Cloud.	Volte a autenticar o arquivo de dados com as credenciais de administrador.
CONFLUENCE_TOO_MANY_REQUEST	Demasiados pedidos HTTP 429 para o Confluence Cloud.	O número de pedidos que o conector enviou excede o valor de QPS predefinido.	Se este problema persistir, reduza o valor de QPS do arquivo de dados através do campo QPS máximo.

Limitações conhecidas

• O modelo de gestão de utilizadores antigo não é suportado para integração com o Confluence Cloud. Apenas é suportado o modelo de gestão de utilizadores centralizado. Para mais informações, consulte o guia de consolidação da organização da Atlassian
• O aspeto das macros que adicionou às páginas do Confluence pode diferir de utilizador para utilizador com base nas respetivas autorizações de acesso.
• Este conetor não suporta a sincronização incremental para a entidade de espaços.
• Não pode usar uma Google Cloud conta de serviço para fazer a autenticação no Confluence Cloud.

Passos seguintes

• Para anexar o seu arquivo de dados a uma app, crie uma app e selecione o seu arquivo de dados seguindo os passos em Criar uma app.

• Para pré-visualizar a apresentação dos resultados da pesquisa após a configuração da app e do arquivo de dados, consulte o artigo Pré-visualizar resultados da pesquisa.

• Para ativar alertas para o arquivo de dados, consulte o artigo Configure alertas para arquivos de dados de terceiros.