Conector do Microsoft Graph local do Confluence (versão prévia)
O conector do Microsoft Graph Local do Confluence permite que sua organização indexe o conteúdo do servidor ou do data center do Confluence. Depois de configurar o conector e os dados de índice do site do Confluence, os usuários finais poderão pesquisar esses conteúdos no Pesquisa da Microsoft.
Observação
O Confluence On-Premises Connector está em versão prévia. Se você quiser obter acesso antecipado para experimentá-lo, inscreva-se usando este formulário .
Este artigo é para Microsoft 365 administradores ou qualquer pessoa que configure, execute e monitore um conector local do Confluence. Ele complementa as instruções gerais fornecidas na configuração de conectores Graph Microsoft no Centro de administração do Microsoft 365.
Cada etapa no processo de instalação é listada abaixo, juntamente com uma observação que indica que você deve seguir as instruções de configuração geral OU outras instruções que se aplicam apenas ao conector do confluence local Graph, incluindo informações sobre solução de problemas e limitações.
Antes de começar
Instalar o agente do conector Graph Microsoft
Para indexar o conteúdo do servidor ou do data center do Confluence, você deve instalar e registrar o agente do conector. Confira instalar o agente do conector do Microsoft Graph para obter detalhes.
Você deve ser o administrador do locatário de Microsoft 365 da sua organização e o administrador do site do Confluence da sua organização.
Etapa 1: Adicionar um conector no Centro de administração do Microsoft 365
Siga as instruções de configuração geral.
Etapa 2: Nomear a conexão
Siga as instruções de configuração geral.
Etapa 3: Definir as configurações de conexão
Etapa 3.1: Selecionar tipo de implantação
Selecione a opção Servidor ou Data center para indexar o conteúdo local do Confluence e selecione avançar.
Etapa 3.2: Inserir a URL da instância do Confluence
Para se conectar ao site do Confluence, use a URL do site.
Etapa 3.3: Selecionar o agente do conector Graph Microsoft
Selecione o agente do conector na lista suspensa. O agente enviará com segurança o conteúdo local do Confluence para o índice Graph Microsoft.
Etapa 3.4: Selecionar tipo de autenticação
Você pode escolher a Autenticação Básica ou o OAuth 1.0a (recomendado) para autenticar em seu site do Confluence.
Dica
Verifique se a conta de serviço tem acesso de exibição ao conteúdo do Confluence que você deseja indexar.
Autenticação básica
Insira o nome de usuário de uma conta de serviço (geralmente ID de email) e a senha para autenticar usando autenticação básica.
OAuth 1.0a (recomendado)
Gere um par de chaves pública/privada e crie um link de aplicativo no site local do Confluence para que o agente do conector possa acessar a instância. Para saber mais, confira a etapa 1 na documentação do desenvolvedor do Atlassian sobre como configurar o OAuth 1.0a.
Etapa 3.4.1 Gerar um par de chaves pública/privada RSA
Execute os comandos openssl a seguir no terminal do computador local.
| Etapa | Comando |
|---|---|
| Gerar uma chave privada de 1024 bits | openssl genrsa -out confluence_privatekey.pem 1024 |
| Criar um certificado X509 | openssl req -newkey rsa:1024 -x509 -key confluence_privatekey.pem -out confluence_publickey.cer -days 365 |
Extrair a chave privada (formato PKCS8) para o confluence_privatekey.pcks8 arquivo |
openssl pkcs8 -topk8 -nocrypt -in confluence_privatekey.pem -out confluence_privatekey.pcks8 |
Extrair a chave pública do certificado para o confluence_publickey.pem arquivo |
openssl x509 -pubkey -noout -in confluence_publickey.cer > confluence_publickey.pem |
Etapa 3.4.2 Criar um link de aplicativo
No Confluence, navegue até Administração (ícone de engrenagem) > Links gerais de configurationApplication > no painel lateral.
Na URL Inserir do aplicativo que você deseja vincular à caixa de texto, insira qualquer URL. Por exemplo, e
https://example.comselecione Criar novo link. Ignorar Nenhuma resposta foi recebida da URL que você inseriu no aviso e selecione Continuar.Na primeira tela da caixa de diálogo Vincular aplicativos , forneça um Nome de Aplicativo e selecione o tipo de Aplicativo Genérico. Marque a caixa de seleção Criar link de entrada. Todos os outros campos são opcionais. Selecione Continuar.
- Na segunda tela da caixa de diálogo Vincular aplicativos , insira os detalhes do consumidor para o cliente de exemplo:
| Campo | Valor recomendado |
|---|---|
| Chave do consumidor | OAuthkey |
| Nome do consumidor | Microsoft Graph Connector App |
| Chave pública | Copie a chave pública do confluence_publickey.pem arquivo gerado da Etapa 3.4.1 e cole-a nesse campo (por exemplo, iuasge87awegrq3...). |
- Selecione Continuar. Após a criação bem-sucedida, o link do aplicativo será exibido como na tela a seguir.
Etapa 3.4.3 Insira a chave do consumidor e a chave privada para entrar
No assistente de configuração de criação de conexão no Centro de administração do Microsoft 365, insira a chave consumidor criada durante a Etapa 3.4.2 confluence_privatekey.pcks8 e a chave privada do arquivo na Etapa 3.4.1. Habilite o pop-up no navegador para Centro de administração do Microsoft 365 e selecione Entrar.
Etapa 3.4.4 Insira o código de verificação para concluir a entrada
Na tela de entrada do Confluence, insira as credenciais da conta de serviço. Após a entrada bem-sucedida, você obterá um código de verificação como a tela a seguir.
Insira o Código de Verificação no assistente de configuração de criação de conexão e selecione Concluir Entrada. Depois de entrar com êxito, selecione Avançar.
Etapa 4: Selecionar propriedades
Nesta etapa, você pode adicionar ou remover as propriedades disponíveis da fonte de dados do Confluence. Microsoft 365 já selecionou algumas propriedades por padrão.
Com uma cadeia de caracteres CQL (Confluence Query Language), você pode especificar condições para sincronizar páginas. É como uma cláusula Where em uma instrução SQL Select. Por exemplo, você pode optar por indexar somente as páginas que foram modificadas nos últimos dois anos. Para saber mais sobre como criar sua própria cadeia de caracteres de consulta, consulte Pesquisa Avançada usando CQL. Por padrão, todas as páginas serão indexadas pelo conector.
Dica
Você pode usar o filtro CQL para indexar o conteúdo modificado após um determinado tempo usando , lastModified >= "2018/12/31"
Use o botão de resultados de visualização para verificar os valores de exemplo das propriedades selecionadas e da cadeia de caracteres CQL.
Etapa 5: Gerenciar permissões de pesquisa
O conector local do Confluence dá suporte a permissões de pesquisa visíveis para Todos ou Somente pessoas com acesso a essa fonte de dados. Se você escolher Todos, os dados indexados aparecerão nos resultados da pesquisa para todos os usuários. Se você escolher Somente pessoas com acesso a essa fonte de dados, os dados indexados aparecerão nos resultados da pesquisa para usuários que têm acesso a elas.
No Confluence Local, as permissões de segurança para usuários e grupos são definidas usando permissões de espaço e restrições de página. O conector local do Confluence aplica permissões efetivas fornecidas pela API de restrições de conteúdo.
Se você escolher Somente pessoas com acesso a essa fonte de dados, precisará escolher se o site do Confluence tem usuários provisionados Azure Active Directory (AAD) ou usuários não AAD.
Para identificar qual opção é adequada para sua organização:
- Escolha a opção do AAD se a ID de email dos usuários do Confluence for a mesma que o UPN (UserPrincipalName) de usuários no AAD.
- Escolha a opção não AAD se a ID de email dos usuários do Confluence for diferente do USERPrincipalName (UPN) de usuários no AAD.
Observação
- Se você escolher o AAD como o tipo de fonte de identidade, o conector mapeia as IDs de Email dos usuários obtidos do Confluence diretamente para a propriedade UPN do AAD.
- Se você escolheu "Não AAD" para o tipo de identidade, consulte Mapear suas identidades não Azure AD para obter instruções sobre como mapear as identidades. Você pode usar essa opção para fornecer a expressão regular de mapeamento da ID de Email para o UPN.
Etapa 6: Atribuir rótulos de propriedade
Siga as instruções de configuração geral.
Etapa 7: Gerenciar esquema
Siga as instruções de configuração geral.
Etapa 8: Escolher as configurações de atualização
Siga as instruções de configuração geral.
Observação
Para atualizações de permissão de acesso, somente o rastreamento completo agendado será aplicado.
Etapa 9: Examinar Conexão
Siga as instruções de configuração geral.
Depois de publicar a conexão, você precisa 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.
Solução de problemas
Os erros comuns que podem ser vistos durante a configuração do conector e seus possíveis motivos estão listados abaixo.
| Etapa de configuração | Mensagem de erro | Possíveis motivos |
|---|---|---|
| Configurações de conexão | A solicitação está incorreta ou foi mal formada. | URL incorreta do site do Confluence |
| Configurações de conexão | Não é possível acessar o serviço local do Confluence para seu site do Confluence. | URL incorreta do site do Confluence |
| Configurações de conexão | O cliente não tem permissão para executar a ação. | Senha inválida fornecida para autenticação básica |
| Selecionar propriedades | Sem resultados de visualização | Verifique se a consulta CQL é válida e corresponde ao conteúdo a ser rastreado |
Limitações
O conector local do Confluence tem as seguintes limitações conhecidas em sua versão mais recente:
- O conector local do Confluence não indexa blogs, arquivos de anexo e comentários.