Integração com Jira Software Cloud

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 9 min. de leitura

    • Integrar sua aplicação Gestão de ativos de software ao Atlassian Jira Software Cloud permite que você rastreie suas assinaturas de software e recupere licenças não utilizadas.

    Nota:
    Atualmente, esta integração oferece suporte a apenas uma integração de site por perfil.
    Importante:
    Minimize os riscos de segurança e proteja as informações concedendo acesso somente ao usuário ou às permissões de API necessárias.
    Tabela 1. Permissões mínimas do usuário
    Processo Função de usuário necessária na aplicação Jira Software Cloud Escopos de autenticação
    Download de assinaturas Permissão para acessar Jira
    • leitura: função-de-aplicação: jira
    • leitura:grupo:jira
    • leitura:usuário:jira
    • ler:avatar:jira
    Extrair atividade do usuário
    • Administrar Jira permissão global
    • Pesquise a permissão de projetos para o projeto que contém o problema.

      Se a segurança em nível de problema estiver configurada, a permissão de segurança em nível de problema para exibir o problema.
    • leitura:usuário:jira
    • leitura: detalhes do problema: jira
    • leitura: auditoria-log: jira
    • ler:avatar:jira
    • leitura:configuração-de-campo:jira
    • leitura:problema-meta:jira
    Recuperar assinatura Administração do site, ou seja, membro do grupo de administradores de site
    • leitura:grupo:jira
    • write:group:jira

    Como usar a autenticação básica

    Integre a aplicação Gestão de ativos de software e Jira usando uma chave de API para autenticar ServiceNow solicitações.

    Você pode integrar uma instância ServiceNow com várias instâncias Jira. Para esta integração, crie um registro de alias de conexão e credencial e um registro de conexão para cada instância Jira.

    Criar um Jira token de API de conta

    Crie um token de API em Jira para autenticar solicitações.

    Antes de Iniciar

    Jira Função necessária: consulte a tabela Permissões mínimas do usuário.

    Procedimento

    1. Navegue até Atlassian API Tokens.
    2. Selecione Criar token de API.
    3. Insira um nome para o token de API e selecione Criar.
    4. Copie o token de API e salve-o.
      Você usará o token mais tarde.

    Configurar o registro de conexão e credencial

    Configure a conexão padrão e o registro de alias de credencial para autenticar as solicitações de ServiceNow.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Tudo > Conexões e Credenciais > Aliases de conexão e credenciais.
    2. Abra o registro de alias para Jira que é enviado com o spoke.
    3. Selecione o link relacionado Criar nova conexão e credencial.
    4. No formulário, preencha os campos.
      Tabela 2. Criar Conexão e Credencial
      Campo Descrição
      URL de conexão URL da sua instância Jira em https:// <provider-domain-name> Formato .atlassian.net .
      Nome de usuário Insira o endereço de e-mail do usuário.
      Chave de API Insira o token de API que você gerou para Jira.
    5. Selecione Criar.

    Como usar a autenticação OAuth

    Integre a aplicação Gestão de ativos de software à sua conta Jira usando o OAuth para autenticar ServiceNow solicitações.

    Criar uma integração OAuth 2.0 na conta Jira

    Crie uma integração OAuth 2.0 no console do desenvolvedor Atlassian para autenticar as solicitações.

    Antes de Iniciar

    Jira Função necessária: consulte a tabela Permissões mínimas do usuário.

    Procedimento

    1. Faça login no Atlassian Developer console.
    2. Em Meus apps, selecione Criar e Integração OAuth 2.0.
    3. No formulário, forneça um nome para a integração e selecione Criar.

      A integração é criada e o valor do ID da aplicação é exibido.

    4. Selecione Autorização.
      1. Selecione Adicionar em Ação.
      2. Em URL de retorno de chamada, forneça o URL da sua instância ServiceNow neste formato: https://<ServiceNow-Instance-Name> .service-now.com/oauth_redirect.do .
        Por exemplo, https://example.service-now.com/oauth_redirect.do.
      3. Selecione Salvar mudanças.
    5. Selecione Configurações.
    6. Em Detalhes da autenticação, copie os valores de ID do cliente e Segredo do cliente.
    7. Selecionar Permissões > API do Jira > Configurar.
    8. Selecione a guia Escopos granulares.
    9. Selecione Editar escopos para adicionar os seguintes escopos:
      • leitura: função-de-aplicação: jira
      • leitura:grupo:jira
      • leitura:usuário:jira
      • ler:avatar:jira
      • leitura: auditoria-log: jira
      • leitura: detalhes do problema: jira
      • leitura:configuração-de-campo:jira
      • leitura:problema-meta:jira
      • write:group:jira
      Você pode configurar outros escopos de acordo com seus requisitos.

    Obter o valor de ID de nuvem da instância Jira

    Obtenha o valor do ID de nuvem da instância de nuvem Jira. Este valor é necessário durante a configuração do registro de conexão em sua instância ServiceNow.

    Antes de Iniciar

    Jira Função necessária: administrador

    Procedimento

    1. Faça login no Atlassian Administração.
    2. Selecione o botão Selecionar na organização necessária.
    3. Selecione a guia Produtos.
    4. Na página Produtos, selecione Gerenciar produto na linha de produto Jira.

      O URL está no seguinte formato em uma nova janela: https://admin.atlassian.com/o/<orgID> /produtos/jira-software/<Cloud-Id> .

    5. Copie o valor do ID da nuvem para uso posterior.

    Criar um Jira perfil de integração de Software Cloud

    Crie um perfil de integração para rastrear assinaturas de software e otimizar o licenciamento para Atlassian Jira Software Cloud.

    Antes de Iniciar

    Para criar um perfil de integração Jira, solicite o plug-in Gestão de ativos de software - Gestão de licenças de SaaS (sn_sam_saas_int) na ServiceNow Store.

    Para habilitar o perfil de integração para recuperar e atualizar a atividade do usuário por meio do subfluxo Jira Atualizar atividade do usuário, defina o com.glide.transform.json.max-partial-lengthValor da propriedade do sistema como 32768.

    Atlassian Função necessária: administrador do site

    ServiceNow Função necessária: administrador ou sam_integrator

    Importante:
    Você deve marcar a caixa de seleção Jira Spoke para esta integração ao instalar recursos opcionais na página Application Manager. Para obter mais informações sobre como escolher as aplicações SaaS necessárias, consulte Solicitação Gestão de licenças de SaaS.

    Por Que e Quando Desempenhar Esta Tarefa

    Se você estiver usando Espaço para ativos de software, a opção para criar o perfil de integração Jira em IU principal estará inativa.

    Procedimento

    1. Navegue até o perfil de integração.
      InterfaceAção
      IU principal
      1. Navegar até Tudo > Ativo de Software > Licença de SaaS > Perfis de Integração Direta.
      2. Selecione Novo.
      3. Selecione Perfil de integração do Jira.
      Espaço de ativo do software
      1. Navegar até Operações de licença > Assinaturas de Usuário > Perfis de integração diretos.
      2. Selecione Novo.
      3. Selecione JIRA na lista suspensa.
      4. Selecione Continuar.
    2. No formulário, preencha os campos.
      Tabela 3. Formulário Perfil de integração
      Campo Valor
      Nome de exibição Nome de sua escolha. Por exemplo, integração Jira.
      Status Status do perfil de integração.
      • Se você não publicou o perfil de integração, este campo será definido automaticamente como Rascunho.
      • Se você já publicou o perfil de integração, este campo será definido automaticamente como Publicado.
      Tipo de perfil Jira Assinatura. Este campo é preenchido automaticamente.
    3. Revise as funções de usuário necessárias ou as permissões de API especificadas no campo Configuração do fornecedor para cada processo para minimizar os riscos de segurança e otimizar SaaS licenças.
      Nota:
      Para obter mais informações, consulte Tabela de permissões mínimas do usuário.
      1. Na seção Subfluxo de assinatura de download, verifique se o campo Subfluxo está definido como Assinaturas de download do Jira.
        Nota:
        A caixa de seleção Baixar assinaturas está marcada por padrão e você não pode desmarcá-la.
      2. Na seção Calcular subfluxo de atividade, verifique se o campo Subfluxo está definido como Atividade do usuário de atualização do JIRA.
        Nota:
        A caixa de seleção Baixar atividade está marcada por padrão. Se você desmarcar, o trabalho agendado de atividade SAM - Refresh <displayname> Activity não será criado.
        No campo Analisar atividade do usuário, você também pode selecionar a data e a hora a partir de quando deseja analisar a atividade do usuário. Por padrão, você pode analisar a atividade do usuário até 60 dias antes da data atual e exibir eventos realizados por usuários individuais a partir do momento em que cria este perfil.
        Nota:
        Gestão de ativos de software extrai os eventos a partir do momento em que você começa a analisar a atividade do usuário, independentemente da data de criação do perfil.
        Você pode modificar este valor no campo Limite de última atividade das regras de recuperação de software. Para obter mais informações, consulte Revisar uma regra de recuperação de software.
      3. Na seção Recuperar subfluxo de assinatura, verifique se o campo Subfluxo está definido como Jira Recuperar assinatura.
        Nota:
        A caixa de seleção Recuperar assinaturas está marcada por padrão. Se você não quiser recuperar assinaturas, poderá desmarcar esta caixa de seleção. Se você desmarcar, os candidatos a remoção serão criados, mas o subfluxo de assinatura de recuperação não será acionado ou o processo de recuperação não será iniciado.
    4. Selecione Save (Salvar).
      Um perfil de integração de rascunho é criado.

      O campo Conexão e credencial é exibido e definido automaticamente como sn_jira_spoke.Jira.

    5. Especifique os grupos que têm acesso a Jira produtos.
      Ao especificar esses grupos em sua instância ServiceNow, você pode recuperar dados e gerenciar licenças somente para os usuários desses grupos.
      1. Em uma nova guia, abra o portal Atlassian Administration.
      2. Faça login na sua conta de administrador do site.
      3. Selecione o botão Selecionar na organização necessária.
      4. Selecione a guia Produtos.
      5. Na página Produtos, selecione Gerenciar produto na linha de produto Jira.
      6. Exibir a lista de grupos que têm acesso ao software Jira.
        Anote essas informações para uso posterior.
      7. Retorne à sua instância ServiceNow e navegue até Jira > Grupos do Jira.
      8. No formulário Jira Grupos, selecione o link relacionado Adicionar grupos.
        A caixa de diálogo Adicionar Jira Grupos é aberta.
      9. Na lista Disponível, selecione os grupos que têm acesso a Jira produtos.
        Dica:
        A lista Disponível inclui todos os grupos associados à sua conta Atlassian. Selecione somente os grupos que têm acesso a Jira produtos.
      10. Selecione o botão de seta para a direita para mover os grupos da lista Disponível para a lista Selecionada.
      11. Selecione OK.
    6. No formulário de perfil de integração, selecione Validar conexão para verificar os detalhes de conexão e credencial desta integração.

      A validação da conexão verifica as APIs Baixar assinaturas e Calcular atividade, mas não as APIs Recuperar assinaturas.

    7. Depois que a conexão for verificada, selecione Publicar.
    8. Na caixa de diálogo Confirmação de publicação, selecione OK.
      Nota:
      Se você desmarcar a caixa de seleção Atividade de download após a publicação do perfil de integração, deverá revalidar as conexões e publicar novamente o perfil de integração, pois ocorrem os seguintes eventos:
      • O campo Status no formulário de perfil de integração muda para Rascunho.
      • O botão Validar conexão aparece no formulário.
      • O trabalho SAM - Refresh <displayname> Activity atual é excluído.

    O que Fazer Depois

    Depois que a integração se conecta, sua instância ServiceNow cria automaticamente modelos de software, regras de recuperação e assinaturas de software que são atualizadas diariamente.

    Se você quiser configurar vários perfis de integração com conexões exclusivas, crie aliases secundários para gerenciar diferentes configurações e definições para cada perfil de integração. Para obter mais informações, consulte Crie um alias secundário para configurar vários perfis de integração.

    Revise todas as regras de recuperação geradas automaticamente para recuperar assinaturas de usuário. Para obter mais informações, consulte Revisar uma regra de recuperação de software.

    Crie direitos de software para os modelos de software gerados automaticamente para rastrear o software usado em relação ao software de propriedade.
    A reconciliação também é executada em suas assinaturas como um trabalho agendado ou sob demanda. Você pode exibir os resultados da reconciliação no Workbench de licenças (Gestão de ativos de software aplicação clássica) ou na exibição de uso de licença (Software Asset Workspace). Use esses resultados para determinar sua posição de conformidade de licença e corrigir qualquer não conformidade.