Integração com Jira Nuvem de software

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 10 min. de leitura

    • Integrando seu Software Asset Management aplicação com Atlassian Jira O 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 à 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 no Jira Aplicação de nuvem de software Escopos de autenticação
    Download de assinaturas Permissão para acessar Jira
    • aplicação-role:jira
    • grupo:jira
    • usuário:jira
    • avatar:jira
    Extrair atividade do usuário
    • Administrar Jira permissão global
    • Procurar permissão de projetos para o projeto que contém o problema.

      Se a segurança no nível do problema estiver configurada, a permissão de segurança no nível do problema para exibir o problema.
    • usuário:jira
    • issue-details:jira
    • audit-log:jira
    • avatar:jira
    • field-configuration:jira
    • issue-meta:jira
    Recuperar assinatura Administração do site, ou seja, membro do grupo site-admin
    • grupo:jira
    • write:group:jira

    Usando autenticação básica

    Integrar o. Software Asset Management aplicação e. Jira Usando uma chave de API para autenticar ServiceNow solicitações.

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

    Crie um Jira Token de API da conta

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

    Antes de Iniciar

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

    Procedimento

    1. Navegue até Tokens de API Atlassian .
    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.

    Configure a conexão e o registro de credencial

    Configure a conexão padrão e o registro de alias de credencial para autenticar as solicitações do 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 enviado com o spoke.
    3. Selecione Criar nova conexão e credencial link relacionado.
    4. No formulário, preencha os campos.
      Tabela 2. Criar conexão e credencial
      Campo Descrição
      URL de conexão URL do seu Jira instância em https://<provider-domain-name>.atlassian.net formato.
      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.

    Usando autenticação OAuth

    Integrar o. Software Asset Management com seu Jira Conta usando OAuth para autenticar ServiceNow solicitações.

    Crie uma integração do OAuth 2,0 no Jira conta

    Crie uma integração do OAuth 2,0 no Atlassian Console do desenvolvedor para autenticar as solicitações.

    Antes de Iniciar

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

    Procedimento

    1. Faça login em Console do desenvolvedor do Atlassian .
    2. Em Meus apps , selecione Criar e selecione Integração do 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 do seu ServiceNow instância 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 > JIRA API > Configurar.
    8. Selecione Escopos granulares guia.
    9. Selecione Editar escopos para adicionar os seguintes escopos:
      • aplicação-role:jira
      • grupo:jira
      • usuário:jira
      • avatar:jira
      • audit-log:jira
      • issue-details:jira
      • field-configuration:jira
      • issue-meta:jira
      • write:group:jira
      Você pode configurar outros escopos de acordo com sua necessidade.

    Obtenha o valor do ID da nuvem de Jira instância

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

    Antes de Iniciar

    Jira Função necessária: administrador

    Procedimento

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

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

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

    Crie um Jira Perfil de integração do Software Cloud

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

    Antes de Iniciar

    Para criar um Jira perfil de integração, solicite o. Software Asset Management- Gestão de licenças de SaaS plug-in (sn_sam_saas_int) do ServiceNow Store .

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

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

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

    Importante:
    Você deve selecionar Spoke do JIRA caixa de seleção desta integração ao instalar recursos opcionais no Application Manager página. 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. Jira perfil de integração em IU principal está inativo.

    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, Jira integração.
      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 permissões de API especificadas em Configuração do fornecedor campo para cada processo para minimizar os riscos de segurança e otimizar SaaS licenças.
      Nota:
      Para obter mais informações, consulte Permissões mínimas do usuário tabela.
      1. Na seção Baixar subfluxo de assinatura, verifique se Subfluxo o campo está definido como Assinaturas de download do JIRA .
        Nota:
        . Baixar assinaturas a caixa de seleção está marcada por padrão e você não pode desmarcá-la.
      2. Na seção Calcular subfluxo de atividade, verifique se Subfluxo o campo está definido como Atualizar atividade do usuário do JIRA .
        Nota:
        . Atividade de download a caixa de seleção está marcada por padrão. Se você limpar, a atividade será programada SAM - Refresh <displayname> Activitynão foi criado.
        Em Analisar a atividade do usuário , você também pode selecionar a data e a hora a partir da qual 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 você cria este perfil.
        Nota:
        Software Asset Management extrai os eventos da hora 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 da última atividade das regras de recuperação de software. Para obter mais informações, consulte Revise uma regra de recuperação de software.
      3. Na seção Recuperar subfluxo de assinatura, verifique se Subfluxo o campo está definido como Assinatura de recuperação do JIRA .
        Nota:
        . Recuperar assinaturas a caixa de seleção está marcada por padrão. Se você não quiser recuperar assinaturas, desmarque esta caixa de seleção. Se você limpar, os candidatos a remoção serão criados, mas o subfluxo Recuperar assinatura 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.

      . Conexão e credencial o campo aparece e é definido automaticamente como sn_jira_spoke.jira_subscription_activity_reclaim .

      Nota:
      O valor preenchido automaticamente em Conexão e credencial o campo muda com base na seleção no Atividade de download e. Recuperar assinaturas caixas de seleção.
      Tabela 4. Valores de conexão e credencial preenchidos automaticamente com base na seleção
      Seleção Valor de conexão e credencial
      Ambos Atividade de download e. Recuperar assinaturas selecionados. sn_jira_spoke.jira_subscription_activity_reclaim
      Apenas Atividade de download selecionado. sn_jira_spoke.jira_subscription_activity
      Apenas Recuperar assinaturas selecionado. sn_jira_spoke.jira_subscription_reclaim
      Ambos Atividade de download e. Recuperar assinaturas não estão selecionados. sn_jira_spoke.jira_subscription
    5. Especifique os grupos aos quais têm acesso Jira produtos.
      Especificando esses grupos em seu ServiceNow, você pode recuperar dados e gerenciar licenças somente para os usuários desses grupos.
      1. Em uma nova guia, abra Portal de administração do Atlassian .
      2. Faça login na sua conta de administrador do site.
      3. Selecione Selecione na organização necessária.
      4. Selecione Produtos guia.
      5. Na página Produtos, selecione Gerenciar produto em Jira linha do produto.
      6. Exiba a lista de grupos aos quais têm acesso Jira Software.
        Anote essas informações para uso posterior.
      7. Retorne ao seu ServiceNow e navegue até Jira > Grupos do Jira.
      8. Em Jira Formulário Grupos, selecione Adicionar grupos link relacionado.
        Adicionar Jira A caixa de diálogo Grupos é aberta.
      9. Na lista Disponível, selecione os grupos aos quais têm acesso Jira produtos.
        Dica:
        A lista Disponível inclui todos os grupos associados ao seu Atlassian conta. Selecione somente os grupos aos quais têm acesso Jira produtos.
      10. Selecione o botão de seta para a direita para mover os grupos da lista Disponível para a lista Selecionado.
      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.

      Validar a 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ê limpar Atividade de download caixa de seleção depois que o perfil de integração for publicado, você deve revalidar as conexões e publicar novamente o perfil de integração porque ocorrem os seguintes eventos:
      • . Status o campo no formulário de perfil de integração muda para Rascunho .
      • . Validar conexão o botão aparece no formulário.
      • O atual SAM - Refresh <displayname> Activityo trabalho é excluído.

    O que Fazer Depois

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

    Depois de criar um perfil de integração, exiba informações sobre o perfil no Espaço para ativos de software navegando até Operações de licença > Assinatura de usuário > Perfis de integração diretos. Você pode selecionar um perfil de integração para exibir as listas relacionadas a seguir. Se todas as listas relacionadas a seguir não estiverem visíveis para um perfil de integração na exibição padrão, você poderá selecionar a exibição de integração personalizada na guia Detalhes:
    • Modelos de software
    • Identificadores de assinatura não reconhecidos
    • Trabalhos agendados
    • Resultados de trabalhos programados
    • Assinaturas de Software
    • Regra de exclusão de identificador de assinatura
    • Regra de exclusão do usuário de assinatura

    Depois de criar um perfil de integração, você pode definir regras de exclusão de assinatura para manter determinadas assinaturas dos cálculos de custo de licença. Para obter mais informações, consulte Exclusões de assinatura para SaaS E aplicações SSO.

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

    Revise todas as regras de recuperação geradas automaticamente para recuperar assinaturas do usuário. Para obter mais informações, consulte Revise 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 próprio.
    A reconciliação também é executada em suas assinaturas como um trabalho agendado ou sob demanda. Você pode exibir os resultados de reconciliação no Workbench de licença ( Software Asset Management aplicação clássica) ou 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.