Conector Atlassian Jira Cloud Microsoft Graph

  • Artigo

O conector Atlassian Jira Cloud microsoft Graph permite que a sua organização indexe problemas de Jira. Depois de configurar o conector e o conteúdo do índice a partir do site Jira, os utilizadores finais podem procurar esses itens no Microsoft Search.

Observação

Leia o artigo Configurar conectores do Microsoft Graph no centro de administração do Microsoft 365 para compreender as instruções gerais de configuração dos conectores.

Este artigo destina-se a qualquer pessoa que configure, execute e monitorize um conector atlassian Jira Cloud. Complementa o processo de configuração geral e mostra instruções que se aplicam apenas ao conector Atlassian Jira Cloud.

Importante

O conector Atlassian Jira Cloud suporta apenas instâncias alojadas na cloud Jira. As versões do Jira Server e do Jira Data Center não são suportadas por este conector.

Antes de começar

Tem de ser o administrador do inquilino do Microsoft 365 da sua organização e o administrador do site Jira da sua organização.

Precisará das seguintes permissões concedidas à conta de utilizador cujas credenciais são utilizadas durante a configuração do conector:

Nome da permissão Tipo de permissão Necessário para
Procurar projetos Permissão do projeto Problemas de pesquisa da Jira. Esta permissão é obrigatória para os projetos que precisam de ser indexados.
Permissões de segurança ao nível do problema Segurança ao nível do problema Pesquisar diferentes tipos de problemas. Esta permissão é opcional.
Procurar utilizadores e grupos Permissão global Limitação da ACL dos resultados da pesquisa. Esta permissão é opcional e é necessária para selecionar Only people with access to this data source a opção no passo 4 abaixo.
Administrar Jira Permissão global Limitação da ACL dos resultados da pesquisa. Esta permissão é opcional e é necessária para selecionar Only people with access to this data source a opção no passo 4 abaixo.

Passo 1: adicionar um conector no centro de administração do Microsoft 365

Adicionar conector Jira

Siga as instruções de configuração gerais.

Passo 2: atribuir um nome à ligação

Siga as instruções de configuração gerais.

Passo 3: Configurar as definições de ligação

Para ligar ao seu site Jira, utilize o URL do site Jira. Normalmente, um URL de site na nuvem de Jira é semelhante a https://< organization_name.atlassian.net/>. Pode escolher Autenticação Básica ou OAuth 2.0 (recomendado) para autenticar no seu site Jira.

Autenticação Básica

Introduza o nome de utilizador da sua conta (normalmente ID de e-mail) e o token de API para autenticar com autenticação básica. Para saber mais sobre como gerar um token de API, veja a documentação da Atlassian sobre como gerir tokens de API para a sua conta Atlassian.

OAuth 2.0

Registe uma aplicação no Atlassian Jira para que a aplicação Microsoft Search possa aceder à instância. Para saber mais, veja a documentação do Suporte da Atlassian sobre como Ativar o OAuth 2.0.

Os passos seguintes fornecem orientações sobre como registar a aplicação:

  1. Inicie sessão na consola do Atlassian Developer com a sua conta de administrador atlassian Jira.

  2. Selecione ativado Create e selecione OAuth 2.0 integration.

  3. Forneça um nome adequado para a aplicação e crie a nova aplicação.

  4. Navegue para Permissions a partir do painel de navegação à esquerda. No cabeçalho "Permissões Granulares", selecione Add para Jira API. Depois de adicionado, selecione ativado Configure e adicione os seguintes âmbitos listados abaixo.

    # Nome do Escopo Código
    1 Ver campos read:field:jira
    2 Ver avatares read:avatar:jira
    3 Ver categorias de projetos read:project-category:jira
    4 Ver projetos read:project:jira
    5 Ler configurações de campos read:field-configuration:jira
    6 Ver tipos de problemas read:issue-type:jira
    7 Ver propriedades do projeto read:project.property:jira
    8 Ver utilizadores read:user:jira
    9 Ver funções de aplicação read:application-role:jira
    10 Ver grupos read:group:jira
    11 Ler hierarquias de tipo de problema read:issue-type-hierarchy:jira
    12 Ver versões do projeto read:project-version:jira
    13 Ver componentes do projeto read:project.component:jira
    14 Ver detalhes do problema read:issue-details:jira
    15 Ver registos de auditoria read:audit-log:jira
    16 Ver meta do problema read:issue-meta:jira
    17 Ver funções de projeto read:project-role:jira
    18 Ver níveis de segurança do problema read:issue-security-level:jira
    19 Ver esquemas de segurança de problemas read:issue-security-scheme:jira
    20 Ver esquemas de permissões read:permission-scheme:jira
    21 Ver permissões read:permission:jira

  5. Navegue para Authorization a partir do painel de navegação à esquerda. Adicione o URL de chamada de retorno para M365 Enterprise: https://gcs.office.com/v1.0/admin/oauth/callback, para M365 Administração Pública: https://gcsgcc.office.com/v1.0/admin/oauth/callback e guarde as alterações.

  6. Navegue para Settings a partir do painel de navegação à esquerda. Irá obter o e Secret a Client ID partir desta página.

Conclua o passo de definições de ligação com o ID de Cliente e o Segredo.

Observação

Passo 3a: Configurar dados: selecionar projetos

Pode escolher a ligação para indexar apenas todo o site Jira ou projetos específicos.

  • Se optar por indexar todo o site Jira, os problemas de Jira em todos os projetos no site serão indexados. Os novos projetos e problemas serão indexados durante a próxima pesquisa depois de serem criados.
  • Se escolher projetos individuais, apenas os problemas de Jira nesses projetos serão indexados.

Observação

Quando concede a permissão Procurar projetos a projetos Jira, este será listado e poderá ser pesquisado. Se um projeto estiver em falta, verifique as permissões da sua conta.

Também pode optar por filtrar os problemas de Jira que serão indexados de duas formas.

  • Especifique o período de tempo de modificação do problema. Isto só indexará os problemas de Jira que são criados ou modificados no período de tempo selecionado sem interrupção com base na pesquisa atual.
  • Especifique o JQL. Isto só indexará os problemas de Jira que são devolvidos após a filtragem com base na Linguagem de Consulta Jira (JQL) fornecida. Para saber mais sobre como utilizar o JQL, veja a documentação do Suporte atlassiano sobre como utilizar a pesquisa avançada com a Linguagem de Consulta Jira

Dica

Pode utilizar o filtro JQL para indexar apenas tipos de problemas específicos da Jira com "issueType in (Bug,Improvement)"

Passo 3b: Configurar dados: Selecionar propriedades

Selecione os campos que pretende que a ligação indexe e pré-visualize os dados nestes campos antes de continuar. Alguns campos já estão selecionados por predefinição e não podem ser removidos.

O conector Atlassian Jira pode indexar campos de problema predefinidos e campos de problema criados personalizados.

A lista de propriedades que selecionar aqui pode afetar a forma como pode filtrar, procurar e ver os seus resultados no Copilot para Microsoft 365.

Propriedade Source Label Descrição
Autores authors Nome das pessoas que participaram/colaboraram no item na origem de dados.
Criado createdDateTime Data e hora em que o item foi criado na origem de dados.
IssueIconUrl iconUrl O URL do ícone associado com prioridade de problema específica.
IssueLink url A URL de destino do item na fonte de dados.
ReporterEmailId createdBy Nome da pessoa que editou o item mais recentemente na fonte de dados.
Título title O título do item que você deseja mostrar na pesquisa e em outras experiências.
Atualizado lastModifiedDateTime Data e hora em que o item foi modificado pela última vez na origem de dados.

Observação

Se um campo de criação personalizada selecionado não estiver presente em alguns tipos de problema Jira, o campo será ingerido como NULO (em branco).

Passo 4: Gerir permissões de pesquisa

O conector Atlassian Jira suporta permissões de pesquisa visíveis para Todos ou Apenas pessoas com acesso a esta origem de dados. Se escolher Todos, os dados indexados serão apresentados nos resultados da pesquisa para todos os utilizadores. Se escolher Apenas as pessoas com acesso a esta origem de dados, os dados indexados serão apresentados nos resultados da pesquisa para os utilizadores que têm acesso aos mesmos. No Atlassian Jira, as permissões de segurança são definidas através de esquemas de permissão de projetos que contêm grupos ao nível do site e funções de projeto. A segurança ao nível do problema também pode ser definida através de esquemas de permissões ao nível do problema.

Importante

O conector do Jira Cloud Graph tem de conseguir ler o ID de e-mail de um utilizador em Jira para atribuir adequadamente permissões de segurança no Microsoft Search. Isto requer que garanta um dos seguintes procedimentos:

  • Todos os utilizadores devem ter selecionado a opção "Qualquer pessoa" para as definições de visibilidade do perfil. Para saber mais sobre as definições de visibilidade do perfil, veja a documentação da Atlassian.
  • Para organizações que utilizam "Contas geridas" (todas as contas Atlassian com endereços de e-mail do seu domínio verificado tornam-se contas geridas. Veja esta documentação para obter mais informações) -
  • Todos os utilizadores, que fazem parte de contas geridas, têm de ter a definição de conta gerida selecionada nas definições de visibilidade do perfil.
  • Os utilizadores que não fazem parte da conta gerida (igual à conta de pesquisa), precisam de ter "Qualquer pessoa" selecionada nas definições de visibilidade do perfil.
  • A conta de pesquisa utilizada durante a configuração da ligação tem de ter o domínio da conta gerida.

Se escolher Apenas pessoas com acesso a esta origem de dados, terá de escolher se o seu site Jira tem utilizadores aprovisionados do Microsoft Entra ID ou utilizadores que não sejam do Azure AD.

Para identificar que opção é adequada para a sua organização:

  1. Selecione a opção ID do Microsoft Entra se o ID de E-mail dos utilizadores da Jira for o mesmo que o UserPrincipalName (UPN) dos utilizadores no Microsoft Entra ID.
  2. Escolha a opção Não Azure AD se o ID de e-mail dos utilizadores de Jira for diferente do UserPrincipalName (UPN) dos utilizadores no ID do Microsoft Entra.

Observação

  • Se escolher o Microsoft Entra ID como o tipo de origem de identidade, o conector mapeia os IDs de E-mail dos utilizadores obtidos diretamente da Jira para a propriedade UPN do Microsoft Entra ID.
  • Se escolheu "Não Azure AD" para o tipo de identidade, consulte [Mapear as identidades que não são do Azure AD](map-non-Azure AD.md) para obter instruções sobre o mapeamento das identidades. Pode utilizar esta opção para fornecer a expressão regular de mapeamento do ID de E-mail para o UPN.
  • As atualizações para utilizadores ou grupos que regem as permissões de acesso são sincronizadas apenas em pesquisas completas. Atualmente, as pesquisas incrementais não suportam o processamento de atualizações para permissões.

Passo 5: Atribuir etiquetas de propriedade

Siga as instruções de configuração gerais.

Passo 6: Gerir o esquema

Siga as instruções de configuração gerais.

Passo 7: escolher as definições de atualização

O conector Atlassian Jira suporta agendas de atualização para pesquisas completas e incrementais. A agenda recomendada é de uma hora para uma pesquisa incremental e um dia para uma pesquisa completa.

Passo 8: rever a ligação

Siga as instruções de configuração gerais.

Depois de publicar a ligação, tem de 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.

Passo 9: Configurar a página de resultados da pesquisa

Depois de publicar a ligação, tem de personalizar a página de resultados da pesquisa com verticais e tipos de resultados. Para saber mais sobre como personalizar os resultados da pesquisa, reveja como gerir verticais e tipos de resultados. Também pode utilizar o esquema de resultados de exemplo para o conector Jira. Basta copiar e colar o JSON do esquema de resultados para começar.

Limitações

Seguem-se limitações conhecidas do conector Atlassian Jira:

  • O conector não suporta a função de aplicação "Qualquer utilizador com sessão iniciada" para conceder acesso a problemas.
  • O Servidor Jira e as versões do Data Center não são suportadas.

Solução de problemas

Depois de publicar a ligação, pode rever o estado no separador Origens de Dados no centro de administração. Para saber como fazer atualizações e eliminações, consulte Gerir o conector. Pode encontrar passos de resolução de problemas frequentemente vistos aqui.

Se tiver outros problemas ou quiser fornecer feedback, escreva-nos aka.ms/TalkToGraphConnectors.