---
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 Roadmunk
# Integração com Roadmunk {#ariaid-title1}
* Versão de lançamento: Yokohama
*
* Atualizado 30 de jan. de 2025
*
*  8 min. de leitura
Integrando seu Gestão de ativos de softwareaplicação com Roadmunka aplicação permite que você rastreie suas assinaturas de software e recupere licenças não utilizadas.
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-roadmunk__table_box__entry__3}
| Processo | Função de usuário necessária no Roadmunkaplicação | Escopos de autenticação |
|-|-|-|
| Download de assinaturas | Administrador de conta | Nenhum escopo |
| Extrair atividade do usuário | Administrador de conta | Nenhum escopo |
| Recuperar assinatura | Administrador de conta | Nenhum escopo |
[Tabela 1. Permissões mínimas do usuário]
{#integrate-with-roadmunk__box-title}
## Gere um RoadmunkToken de acesso à API {#ariaid-title2}
Gere um token de acesso à API que autoriza o acesso ao RoadmunkGraphQL API.
### Antes de Iniciar
Roadmunk Função necessária: Administrador de conta
### Procedimento
1. Em um navegador da web, abra [Roadmunk](https://roadmunk.com/).
2. Faça login usando as credenciais de administrador da sua conta.
3. No menu de navegação esquerdo do Roadmunkpainel, selecione o ícone do seu perfil e, em seguida, selecione Configurações da conta .
4. No cabeçalho da página das configurações da sua conta, selecione Integrações .
5. Em Integrações existentes, selecione Adicione uma integração .
6. Quando solicitado a selecionar uma integração para configurar, selecione Tokens de API .
7. Em RoadmunkToken de API, insira um nome para o token de acesso à API no Nome da aplicação campo.
8. Selecione Criar token de API .
O token de acesso à API é gerado e, em seguida, a caixa de diálogo Token de API criado é aberta.
9. Na caixa de diálogo Token de API criado, copie seu token de acesso à API selecionando Copiar para a área de transferência .
Salve-o em um local seguro para uso posterior.
## Crie um Roadmunkconexão {#ariaid-title3}
Crie uma conexão entre o. Roadmunke seu ServiceNowpara que sua instância possa recuperar dados do usuário de suas aplicações.
### Antes de Iniciar
ServiceNow Função necessária: administrador
### Procedimento
1. Do seu ServiceNowinstância, navegue até Automação de ProcessoFlow Designer.
O Designer de fluxo é iniciado em uma nova guia.
2. Selecione a guia Conexões.
3. Localize seu Roadmunke, em seguida, selecione Adicionar conexão .
4. Na caixa de diálogo, preencha os campos.
{#create-roadmunk-connection__table_xd2_qht_lnb__entry__2}
| Campo | Descrição |
|-|-|
| Informação de conexão ||
| Nome da conexão | Nome do Roadmunkconexão. Este campo é preenchido automaticamente. |
| URL de conexão | URL da conexão. Este campo é definido automaticamente como https://app-gateway.roadmunk.com , em que app É a região geográfica padrão (América do Norte) na qual a conexão está sendo criada. Se você estiver criando a conexão fora do padrão app (América do Norte), você pode alterar o valor da região para qualquer uma delas ue (Europa) ou apac (Região Ásia-Pacífico). |
| Informações de credencial ||
| Token de API | Token de acesso à API que autoriza o acesso ao RoadmunkGraphQL API. Insira o mesmo token de acesso à API que você gerou em [Gere um RoadmunkToken de acesso à API](https://servicenow-prod.fluidtopics.net/DjjK4sSybQNP3hJjmvC53A#generate-roadmunk-api-token "Gere um token de acesso à API que autoriza o acesso ao RoadmunkGraphQL API."). |
[Tabela 2. Caixa de diálogo Criar conexão]
{#create-roadmunk-connection__table_xd2_qht_lnb}
5. Selecione Criar conexão.
{#create-roadmunk-connection__steps_yxg_1dg_cqb}
## Criação do perfil de Integração Roadmunk {#ariaid-title4}
Crie um Roadmunkperfil de integração para rastrear assinaturas de software e otimizar o licenciamento para o. Roadmunkaplicações.
### Antes de Iniciar
Para criar um Roadmunkperfil 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/).
ServiceNow Função necessária: sam_integrator ou admin
Importante:
Você deve selecionar Roadmunk 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. Roadmunkperfil 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 Roadmunk . {#create-integration-profile-roadmunk__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 Roadmunk na lista suspensa. 4. Selecione Continuar. {#create-integration-profile-roadmunk__ol_wjd_bjk_qtb} |
|-|-|
{#create-integration-profile-roadmunk__choicetable_o3p_z3k_qtb}
2. No formulário, preencha os campos.
{#create-integration-profile-roadmunk__table_v44_nq1_wmb__entry__2}
| Campo | Descrição |
|-|-|
| Nome de exibição | Nome do perfil de integração. Por exemplo, Integração do Roadmunk . |
| 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-profile-roadmunk__ul_hfl_cz5_hdc} |
| Tipo de Perfil | Tipo de perfil de integração. Este campo é definido automaticamente como Assinatura do Roadmunk . |
[Tabela 3. Formulário de perfil de integração]
{#create-integration-profile-roadmunk__table_v44_nq1_wmb}
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/DjjK4sSybQNP3hJjmvC53A#create-integration-profile-roadmunk "Crie um Roadmunkperfil de integração para rastrear assinaturas de software e otimizar o licenciamento para o. Roadmunkaplicações.")tabela.
1. Na seção Baixar subfluxo de assinatura, verifique se Subfluxo o campo está definido como Assinaturas de download do Roadmunk .
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 no Roadmunk .
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 Roadmunk .
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-profile-roadmunk__substeps_rcm_pwm_vcc}
4. Selecione Salvar.
Seu ServiceNowa instância cria um perfil de integração de rascunho.
. Conexão e credencial o campo aparece e é definido automaticamente como sn_roadmunk_spoke.roadmunk .
5. **Opcional:** Para evitar que seu perfil de integração inclua usuários inativos em sua lista de Roadmunkassinaturas, habilite o. RoadmunkSubfluxo de download de assinaturas para baixar somente os usuários ativos em seu Roadmunkconta.
Por padrão, o. RoadmunkO subfluxo Baixar assinaturas baixa todos os usuários no Roadmunkconta, incluindo usuários ativos e inativos.
1. Em uma nova guia ou janela, abra [Roadmunk](https://roadmunk.com/).
2. Faça login usando suas credenciais de administrador de conta.
. Roadmunko painel é aberto.
3. No menu de navegação esquerdo do Roadmunkpainel, selecione o ícone do seu perfil e, em seguida, selecione Configurações da conta .
As configurações da sua conta estão abertas.
4. No cabeçalho da página das configurações da sua conta, selecione Relatórios .
5. Da lista de disponíveis Roadmunkrelatórios, selecione Baixar CSV do usuário .
. RoadmunkOs relatórios do usuário são baixados em .csv formato. {#create-integration-profile-roadmunk__download-user-report}
{#create-integration-profile-roadmunk__download-user-report}
6. Retorne ao formulário Perfil de integração.
7. No cabeçalho do formulário, selecione Gerenciar anexos ícone ( ![Ícone Gerenciar anexos.]()).
8. Na caixa de diálogo Anexos, selecione Escolha o arquivo para localizar e selecionar o. RoadmunkRelatório do usuário que você baixou em [etapa e.](https://servicenow-prod.fluidtopics.net/DjjK4sSybQNP3hJjmvC53A#create-integration-profile-roadmunk__download-user-report).
9. Depois que o relatório for carregado com sucesso, feche a caixa de diálogo para retornar ao formulário Perfil de integração.
{#create-integration-profile-roadmunk__substeps_xsf_1vj_kqb}
Dica:
Para remover continuamente usuários inativos da sua lista de Roadmunkassinaturas, baixe e anexe a versão mais recente do RoadmunkRelatório do usuário periodicamente. {#create-integration-profile-roadmunk__deactivate-user}
{#create-integration-profile-roadmunk__deactivate-user}
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. Selecione Publicar.
9. 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-profile-roadmunk__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-profile-roadmunk__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-profile-roadmunk__ul_qgf_zhr_sqb}