Partilhar via


Implementar o conector de Microsoft 365 Copilot do Atlassian Jira Data Center

O conector de Microsoft 365 Copilot do Centro de Dados Jira permite à sua organização indexar problemas do Centro de Dados Jira e dados de projeto relacionados para que se tornem detetáveis e acionáveis nas experiências do Microsoft 365 e do Microsoft Search. Este artigo descreve os passos para implementar e personalizar o conector do Centro de Dados Jira.

Pré-requisitos

Antes de implementar o conector, certifique-se de que cumpre os seguintes pré-requisitos:

  • Tem de ser um administrador do Microsoft 365.

  • Instale o agente do conector do Microsoft Graph num computador Windows na mesma rede que a sua instância do Centro de Dados Jira. Se o agente já estiver instalado, verifique se está a executar a versão 3.1.15.0 ou posterior.

  • Instale o plug-in do Jira Data Center a partir da listagem do conector Microsoft 365 Copilot no Atlassian Marketplace.

    Observação

    O plug-in suporta as versões 8.10.0 – 10.5.1 do Centro de Dados da Jira.

  • Configure uma conta de serviço com as permissões listadas na tabela seguinte.

    Nome da permissão Tipo de permissão Necessário para
    Procurar projetos Permissão do projeto Problemas de pesquisa de Jira (obrigatório).
    Segurança ao nível do problema Segurança ao nível do problema Tipos de problemas de pesquisa com níveis de segurança (opcional).
    Procurar utilizadores e grupos Permissão global Limitação de segurança quando apenas as pessoas com acesso a esta origem de dados estão selecionadas (opcional).
    Administrar Jira Permissão global Necessário ao impor um mapeamento rigoroso do controlo de acesso (opcional).
  • Permitir pedidos ilimitados para impedir a limitação. EmIsenções>de Limitação da> Taxa de Sistema>Adicionar isenções, adicione a conta de serviço à lista de isenções.

    Captura de ecrã que mostra a permissão de pedidos ilimitados para a Conta de Serviço

Implementar o conector

Para adicionar o conector do Centro de Dados Jira à sua organização:

  1. Na Centro de administração do Microsoft 365, no painel esquerdo, selecioneConectoresCopilot>.
  2. Aceda ao separador Conectores e, no painel esquerdo, selecione Galeria.
  3. Na lista de conectores disponíveis, selecione Centro de Dados Jira.

Definir nome a apresentar

O nome a apresentar identifica a origem de conteúdo nas respostas copilot. Pode aceitar o nome predefinido do Centro de Dados Jira ou personalizá-lo para ajudar os utilizadores a reconhecer a origem de dados.

Definir URL da instância

Introduza o URL da sua instância do Centro de Dados Jira. O formato típico é: https://jira.<your-domain>.com.

Escolher tipo de autenticação

Configure a autenticação OAuth 2.0 com as Ligações da Aplicação Jira.

Para configurar o OAuth em Jira:

  1. Inicie sessão no DataCenter de Jira.

  2. Aceda a Definições Ligações>> daAplicação.

    Captura de ecrã a mostrar Clique em Aplicação no menu Definições.

    Captura de ecrã da página Ligações da aplicação.

  3. Selecione Criar ligação.

    Captura de ecrã a mostrar a ligação Selecionar Criar.

  4. Selecione Aplicação externa e, em seguida, selecione Recebido como a direção.

    Captura de ecrã a mostrar a opção Selecionar aplicação externa e Direção de entrada.

  5. Preencha o formulário Configurar uma ligação de entrada :

    • URL de redirecionamento:
      • Empresa: https://gcs.office.com/v1.0/admin/oauth/callback
      • Cloud da Comunidade Governamental Elevada (GCC High): https://gcsgcc.office.com/v1.0/admin/oauth/callback
    • Âmbito: Administração

    Captura de ecrã a mostrar o formulário Configurar uma ligação de entrada.

  6. Copie o ID de Cliente e o Segredo e cole-os na página de configuração da ligação Centro de administração do Microsoft 365.

    Captura de ecrã a mostrar o ID de Cliente e o Segredo.

Implementar

Para validar a ligação antes de uma implementação completa, selecione Implementação para audiência limitada e especifique os utilizadores ou grupos para a implementação faseada. Para obter mais informações, veja Implementação faseada para conectores Copilot.

Selecione Criar para implementar o conector. O conector do Centro de Dados Jira começa imediatamente a indexar conteúdo.

A tabela seguinte lista os valores predefinidos que o conector aplica.

Categoria Valor padrão
Usuários Permissões de acesso: apenas pessoas com acesso a esta origem de dados; identidades mapeadas com Microsoft Entra ID.
Conteúdo Todos os projetos indexados por predefinição; esquema de propriedade predefinido aplicado.
Sincronizar Pesquisa incremental a cada 15 minutos; pesquisa completa diariamente.

Para personalizar estes valores, selecione Configuração personalizada. Para obter mais informações, veja Personalizar definições.

Depois de criar a ligação, pode rever a status na secção Conectores do Centro de administração do Microsoft 365.

Personalizar definições (opcional)

Pode personalizar as definições do conector do Centro de Dados Jira.

Personalizar as definições do utilizador

Permissões de acesso

O conector suporta duas opções de acesso:

  • Todos
  • Apenas pessoas com acesso a esta origem de dados (recomendado)

Quando seleciona Apenas pessoas com acesso a esta origem de dados, o conector impõe o modelo de permissão Jira, incluindo as permissões de projeto e segurança ao nível do problema. O mapeamento de identidade é necessário se os IDs de e-mail de Jira forem diferentes dos valores Microsoft Entra ID nome principal de utilizador (UPN).

O conector utiliza a seguinte hierarquia:

  1. Nível de segurança do problema (Prioridade mais alta): Se estiver definido, o acesso será restringido aos utilizadores nesse nível.
  2. Contingência para permissões ao nível do projeto: Se não estiver definido nenhum nível de segurança, o acesso é determinado pela permissão Procurar Projetos .

Identidades do mapa

Se utilizar permissões restritivas, mapeie identidades Jira para identidades do Microsoft 365 de uma das seguintes formas:

  • Microsoft Entra ID: selecione esta opção se o ID de e-mail dos utilizadores de Jira for o mesmo que o UPN no Microsoft Entra ID.
  • ID Não Entra: Escolha esta opção se os IDs forem diferentes (requer uma regra Regex).

Personalizar definições de conteúdo

Filtrar dados

Pode filtrar problemas através da criação ou atualização do carimbo de data/hora ou através do JQL. Por exemplo: project = "PROJ" AND updated >= -30d.

Gerir propriedades

Selecione os campos Jira (propriedades do esquema) que pretende indexar. Pode incluir campos Jira incorporados ou adicionar campos personalizados. Para obter mais informações, veja Gerir o esquema de pesquisa. As seguintes propriedades estão indexadas por predefinição.

Propriedade Source Etiqueta Semântica Esquema
AssigneeEmailId Consultar, Obter, Procurar
AssigneeName Consultar, Obter, Procurar
Autores Autores Consultar, Obter
Criado Data e hora de criação Obter
Data de Conclusão Obter
IssueDescription Pesquisar
IssueIconUrl IconUrl Obter
IssueId Obter
IssueKey Consultar, Obter, Procurar
IssueLink Url Consultar, Obter, Procurar
IssuePriority Consultar, Obter, Procurar
IssueStatus Consultar, Obter
IssueSummary Pesquisar
IssueType Consultar, Obter
Rótulos Consultar, Obter
ProjectName Consultar, Obter
ReporterEmailId Criado por Consultar, Obter, Procurar
ReporterName Consultar, Obter, Procurar
Título Título Consultar, Obter, Procurar
Atualizado Hora da última modificação Consultar, Obter

Personalizar intervalos de sincronização

Pode ajustar a frequência de pesquisa de acordo com as suas necessidades de atualização de dados. Seguem-se os valores predefinidos:

  • Pesquisa completa: Todos os dias
  • Pesquisa incremental: A cada 15 minutos

Para obter mais informações, veja Diretrizes para definições de sincronização.