--- sourceDocument: Yokohama Gestão de ativos de TI sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/it-asset-management Release : - yokohama ft:locale : - pt-BR ft:publication_title : - Yokohama Gestão de ativos de TI ft:clusterId : - itam bundleId : - itam workflow : - Technology --- # Integração com JiraNuvem de software # Integração com JiraNuvem de software {#ariaid-title1} * Versão de lançamento: Yokohama * * Atualizado 30 de jan. de 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 9 min. de leitura Integrando seu Gestão de ativos de softwareaplicação com Atlassian JiraO Software Cloud permite que você rastreie suas assinaturas de software e recupere licenças não utilizadas. Nota: No momento, 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.{#integrate-with-jira__table_box__entry__3} | Processo | Função de usuário necessária no JiraAplicação de nuvem de software | Escopos de autenticação | |-|-|-| | Download de assinaturas | Permissão para acessar Jira | * leitura:application-role:jira * grupo:jira * read:user:jira * leitura:avatar:jira {#integrate-with-jira__ul_pbx_m4p_pbc} | | Extrair atividade do usuário | * Administrar Jirapermissão global * Permissão Procurar 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. {#integrate-with-jira__ul_ut4_d3b_ybc} | * read:user:jira * edição:issue-details:jira * read:audit-log:jira * leitura:avatar:jira * read:field-configuration:jira * edição-meta:jira {#integrate-with-jira__ul_ghz_lqp_pbc} | | Recuperar assinatura | Administração do site, ou seja, membro do grupo site-admin | * grupo:jira * write:group:jira {#integrate-with-jira__ul_iwr_j3b_ybc} | [Tabela 1. Permissões mínimas do usuário] {#integrate-with-jira__box-title} ## Usando autenticação básica {#ariaid-title2} Integre o. Gestão de ativos de softwareaplicação e. JiraUsando uma chave de API para autenticar ServiceNowsolicitações. Você pode integrar um ServiceNowinstância com vários Jirainstâncias. Para esta integração, crie um registro de alias de conexão e credencial e um registro de conexão para cada um Jirainstância. ### Crie um JiraToken de API da conta {#ariaid-title3} Crie um token de API em Jirapara autenticar solicitações. #### Antes de Iniciar JiraFunção necessária: Consulte [Permissões mínimas do usuário](https://servicenow-prod.fluidtopics.net/gBUAyhap3cx0lGfDuzx9zA#integrate-with-jira "Integrando seu Gestão de ativos de softwareaplicação com Atlassian JiraO Software Cloud permite que você rastreie suas assinaturas de software e recupere licenças não utilizadas.")tabela. #### Procedimento 1. Navegue até [Tokens de API Atlassian](https://id.atlassian.com/manage/api-tokens). 2. Selecione Crie token de API . 3. Insira um nome para o token de API e selecione Criar . 4. Copie o token da API e salve-o. Você usará o token mais tarde. {#create-jira-api-token__steps_tw4_fwg_ynb} ### Configure o registro de conexão e credencial {#ariaid-title4} 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é TudoConexões e CredenciaisAliases de conexão e credencial. 2. Abra o registro de alias para Jiraque é enviado com o spoke. 3. Selecione Criar nova conexão e credencial link relacionado. 4. No formulário, preencha os campos. {#configure-basic-rec-jira__table_qcd_wh1_nwb__entry__2} | Campo | Descrição | |-|-| | URL de conexão | URL do seu Jirainstância em https://\.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 gerado para Jira. | [Tabela 2. Criar conexão e credencial] {#configure-basic-rec-jira__table_qcd_wh1_nwb} 5. Selecione Criar. ## Usando autenticação OAuth {#ariaid-title5} Integre o. Gestão de ativos de softwarecom seu JiraConta usando OAuth para autenticar ServiceNowsolicitações. ### Crie uma integração do OAuth 2,0 em Jiraconta {#ariaid-title6} Crie uma integração do OAuth 2,0 no AtlassianConsole do desenvolvedor para autenticar as solicitações. #### Antes de Iniciar JiraFunção necessária: Consulte [Permissões mínimas do usuário](https://servicenow-prod.fluidtopics.net/gBUAyhap3cx0lGfDuzx9zA#integrate-with-jira "Integrando seu Gestão de ativos de softwareaplicação com Atlassian JiraO Software Cloud permite que você rastreie suas assinaturas de software e recupere licenças não utilizadas.")tabela. #### Procedimento 1. Faça login em [Console do desenvolvedor Atlassian](https://id.atlassian.com/login?continue=https://developer.atlassian.com/console/myapps/). 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 do app é exibido. 4. Selecione Autorização . 1. Selecione Adicionar em Ação . 2. Em URL de retorno de chamada , Forneça o URL do seu ServiceNowinstância neste formato: https://\.service-now.com/oauth_redirect.do . Por exemplo, https://example.service-now.com/oauth_redirect.do . 3. Selecione Salvar mudanças. {#create-oauth-int-jira__substeps_j1m_cd5_mwb} 5. Selecione Configurações. 6. Em Detalhes da autenticação , Copie os valores de ID do cliente e Segredo do cliente. 7. Selecionar PermissõesJira APIConfigurar. 8. Selecione Escopos granulares . 9. Selecione Editar escopos para adicionar os seguintes escopos: * leitura:application-role:jira * grupo:jira * read:user:jira * leitura:avatar:jira * read:audit-log:jira * edição:issue-details:jira * read:field-configuration:jira * edição-meta:jira * write:group:jira {#create-oauth-int-jira__ul_jtr_h25_mwb}Você pode configurar outros escopos de acordo com sua necessidade. ### Obtenha o valor do ID da nuvem de Jirainstância {#ariaid-title7} Obtenha o valor do ID de nuvem do Jirainstância de nuvem. Este valor é necessário durante a configuração do registro de conexão no ServiceNowinstância. #### Antes de Iniciar Jira Função necessária: administrador #### Procedimento 1. Faça login em [Administração Atlassian](https://admin.atlassian.com/). 2. Selecione Selecione na organização necessária. 3. Selecione Produtos . 4. Na página Produtos, selecione Gerencie o produto em Jiralinha do produto. O URL está no seguinte formato em uma nova janela: https://admin.atlassian.com/o/\/Products/jira-software/\ . 5. Copie o valor do ID da nuvem para uso posterior. ## Crie um JiraPerfil de integração da nuvem de software {#ariaid-title8} Crie um perfil de integração para rastrear assinaturas de software e otimizar o licenciamento para Atlassian JiraNuvem de software. ### Antes de Iniciar Para criar um Jiraperfil de integração, solicite o. Gestão de ativos de software- Gestão de licenças de SaaSplug-in (sn_sam_saas_int) do [ServiceNow Store](https://store.servicenow.com/). Para habilitar o perfil de integração para recuperar e atualizar a atividade do usuário por meio do JiraAtualizar subfluxo de atividade do usuário, defina com.glide.transform.json.max-partial-lengthpropriedade do sistema Valor para 32768 . Atlassian Função necessária: Administrador do site ServiceNow Função necessária: administrador ou sam_integrator Importante: Você deve selecionar Jira spoke caixa de seleção desta integração ao instalar recursos opcionais no [Application Manager](https://www.servicenow.com/docs/access?context=application-manager&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US)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](https://servicenow-prod.fluidtopics.net/yYI1CnWl12Ncssjqd3facg "Solicite o. Gestão de ativos de software- Gestão de licenças de SaaSplug-in (sn_sam_saas_int) para que você possa criar e gerenciar integrações com o. SaaSE login único (SSO). Você pode usar essas integrações para rastrear o uso de licenças e recuperar licenças não utilizadas."). ### Por Que e Quando Desempenhar Esta Tarefa Se você estiver usando Espaço para ativos de software, a opção para criar o. Jiraperfil de integração em IU principalestá inativo. ### Procedimento 1. Navegue até o perfil de integração. | Interface | Ação | | IU principal | 1. Navegar até TudoAtivo de SoftwareLicença de SaaSPerfis de Integração Direta. 2. Selecione Novo. 3. Selecione Perfil de integração do Jira . {#create-integration-jira__ol_ijd_bjk_qtb} | | Espaço de ativos de software | 1. Navegar até Operações de licençaAssinaturas de UsuárioPerfis de integração diretos. 2. Selecione Novo. 3. Selecione Jira na lista suspensa. 4. Selecione Continuar. {#create-integration-jira__ol_wjd_bjk_qtb} | |-|-| {#create-integration-jira__choicetable_o3p_z3k_qtb} 2. No formulário, preencha os campos. {#create-integration-jira__table_iqh_2y5_mjb__entry__2} | Campo | Valor | |-|-| | Nome de exibição | Nome de sua escolha. Por exemplo, Jiraintegração. | | Status | Status do perfil de integração. * Se você não tiver publicado o perfil de integração, este campo será definido automaticamente como Rascunho . * Se você já tiver publicado o perfil de integração, este campo será definido automaticamente como Publicado . {#create-integration-jira__ul_wpy_zvq_dcc} | | Tipo de perfil | Jira Assinatura. Este campo é preenchido automaticamente. | [Tabela 3. Formulário de perfil de integração] {#create-integration-jira__table_iqh_2y5_mjb} 3. Revise as funções de usuário necessárias ou as permissões de API especificadas no Configuração do fornecedor campo para cada processo para minimizar os riscos de segurança e otimizar SaaSlicenças. Nota: Para obter mais informações, consulte [Permissões mínimas do usuário](https://servicenow-prod.fluidtopics.net/gBUAyhap3cx0lGfDuzx9zA#create-integration-jira "Crie um perfil de integração para rastrear assinaturas de software e otimizar o licenciamento para Atlassian JiraNuvem de software.")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 Jira Atualizar atividade do usuário . Nota: . Atividade de download a caixa de seleção está marcada por padrão. Se você limpar, o trabalho agendado da atividade SAM - Refresh \ Activitynão foi criado. Em Analise a atividade do usuário você também pode selecionar a data e a hora a partir de quando você 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: Gestão de ativos de software extrai os eventos 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 da última atividade das regras de recuperação de software. Para obter mais informações, consulte [Revise uma regra de recuperação de software](https://servicenow-prod.fluidtopics.net/VgyB0r_qG7JPagR7GMiDRA "Use regras de recuperação para cancelar assinaturas de usuário que têm atividade limitada a nenhuma."). 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 à remoção serão criados, mas o subfluxo de recuperação de assinatura não será acionado ou o processo de recuperação não será iniciado. {#create-integration-jira__substeps_rcm_pwm_vcc} 4. Selecione Salvar. Um perfil de integração de rascunho é criado. . Conexão e credencial o campo aparece e é definido automaticamente como sn_jira_spoke.jira . 5. Especifique os grupos aos quais têm acesso Jiraprodutos. 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 o. [Portal de administração Atlassian](https://admin.atlassian.com/). 2. Faça login na sua conta de administrador do site. 3. Selecione Selecione na organização necessária. 4. Selecione Produtos . 5. Na página Produtos, selecione Gerencie o produto em Jiralinha do produto. 6. Exiba a lista de grupos aos quais têm acesso JiraSoftware. Anote essas informações para uso posterior. 7. Retorne ao ServiceNowe navegue até JiraGrupos do Jira. 8. Em JiraFormulário Grupos, selecione Adicione grupos link relacionado. Adicionar JiraA caixa de diálogo Grupos é aberta. 9. Na lista Disponível, selecione os grupos aos quais têm acesso Jiraprodutos. Dica: A lista Disponível inclui todos os grupos associados ao seu Atlassianconta. Selecione somente os grupos aos quais têm acesso Jiraprodutos. 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. {#create-integration-jira__substeps_jtp_5sk_n4b} 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 de recuperação de 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 após a publicação do perfil de integração, 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 . * . Valide a conexão o botão aparece no formulário. * O atual SAM - Refresh \ Activityo trabalho é excluído. {#create-integration-jira__ul_adf_2v3_ddc} ### O que Fazer Depois Após a integração se conectar, seu ServiceNowa instância 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 configuraçõ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](https://servicenow-prod.fluidtopics.net/loeiE6zEEgiP9DeR7B3Ebg "Crie um alias secundário para configurar vários perfis de integração com conexões exclusivas e gerenciar configurações diferentes para cada perfil de integração."). Revise todas as regras de recuperação geradas automaticamente para recuperar assinaturas de usuário. Para obter mais informações, consulte [Revise uma regra de recuperação de software](https://servicenow-prod.fluidtopics.net/VgyB0r_qG7JPagR7GMiDRA "Use regras de recuperação para cancelar assinaturas de usuário que têm atividade limitada a nenhuma."). Crie direitos de software para os modelos de software gerados automaticamente para rastrear o software usado em relação ao software próprio. * Para obter mais informações sobre como criar direitos de software no Gestão de ativos de softwareIU principal, consulte [Crie direitos em Gestão de ativos de softwareclássico](https://servicenow-prod.fluidtopics.net/wvUP39nC3GSpHYfw~oagRg "Crie direitos no Gestão de ativos de softwareaplicação clássica para gravar os detalhes da sua licença e alocar direitos de software adquiridos para usuários ou dispositivos."). * Para obter mais informações sobre como criar direitos de software no Espaço de ativos de software, consulte [Crie direitos no espaço](https://servicenow-prod.fluidtopics.net/9M4OpOX2IQukgpQ7eT~bVw "Crie atribuições no Software Asset Workspace para inserir os detalhes da licença e alocar direitos de software comprados para usuários ou dispositivos."). * Para obter mais informações sobre como criar direitos de software usando o. Gestão de ativos de softwarePlaybook, consulte [Crie direitos usando o passo-a-passo guiado](https://servicenow-prod.fluidtopics.net/xsjN17LVbR0hE~BwBhy4Cw "Use o playbook guiado com passo a passo para um processo passo a passo de criação de direitos."). {#create-integration-jira__ul_cbz_vhr_sqb} A reconciliação também é executada em suas assinaturas como um trabalho agendado ou sob demanda. Você pode exibir seus resultados de reconciliação no [Workbench de licença](https://servicenow-prod.fluidtopics.net/1nnUed7YT2WIb2E8m9ROAw "Revise os resultados de reconciliação em uma exibição simplificada do workbench.")( Gestão de ativos de softwareaplicação clássica) ou o. [Exibição de uso de licença](https://servicenow-prod.fluidtopics.net/Z~KV_h0HfjerR7dhNx2hLg "Use a exibição de uso de licença como um plano único para entender a posição da licença de todos os produtos de software, corrigir não conformidade, exibir resultados de reconciliação, exibir ou adicionar candidatos à remoção e exibir Gestão de ativos de softwarerelatórios relacionados.")(Espaço de ativos de software). Use estes resultados para determinar sua posição de conformidade de licença e corrigir qualquer não conformidade. * Para obter mais informações sobre como executar reconciliação no Gestão de ativos de softwareaplicação clássica, consulte [Execute a reconciliação de software em Gestão de ativos de softwareclássico](https://servicenow-prod.fluidtopics.net/i3zbMbhqFaEHI5whaM61cw "A reconciliação é executada como um trabalho agendado (o padrão é semanal), mas você também pode executar a reconciliação manualmente para reconciliar produtos de software em seu ambiente sob demanda."). * Para obter mais informações sobre como executar a reconciliação no Espaço de ativos de software, consulte [Execute a reconciliação de software no espaço](https://servicenow-prod.fluidtopics.net/_a9GDr8o8ynhlQskHBlDBQ "A reconciliação é executada como um trabalho agendado (o padrão é semanalmente), mas você também pode executar a reconciliação manualmente para reconciliar produtos de software no ambiente do Software Asset Workspace sob demanda."). {#create-integration-jira__ul_qgf_zhr_sqb}