Integração com Roadmunk

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 9 min. de leitura
  • Integrando seu Software Asset Management aplicação com Roadmunk o aplicativo permite que você rastreie suas assinaturas de software e recupere licenças não utilizadas.

    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 Roadmunk aplicação Escopos de autenticação
    Download de assinaturas Administrador de conta Não há escopos
    Extrair atividade do usuário Administrador de conta Não há escopos
    Recuperar assinatura Administrador de conta Não há escopos

    Gere um Roadmunk Token de acesso à API

    Gere um token de acesso de API que autoriza o acesso ao Roadmunk GraphQL API.

    Antes de Iniciar

    Roadmunk Função necessária: Administrador de conta

    Procedimento

    1. Em um navegador da Web, abra Roadmunk .
    2. Faça login usando suas credenciais de administrador de conta.
    3. No menu de navegação esquerdo do Roadmunk painel, 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 guia.
    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 Roadmunk Formulário Tokens de API, insira um nome para o token de acesso de 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 de API selecionando Copiar para a área de transferência .
      Salve-o em um local seguro para uso posterior.

    Criar uma conexão do Roadmunk

    Crie uma conexão entre seu Roadmunk e seu ServiceNow para 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 ServiceNow instância, navegue até Automação de Processo > Flow Designer.
      O Flow Designer é iniciado em uma nova guia.
    2. Selecione Conexões guia.
    3. Localize seu Roadmunk e selecione Adicionar conexão .
    4. Na caixa de diálogo, preencha os campos.
      Tabela 2. Caixa de diálogo Criar conexão
      Campo Descrição
      Informação de conexão
      Nome da Conexão Nome do Roadmunk conexã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 aplicação É 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 aplicação (América do Norte), você pode mudar o valor da região para qualquer um ue (Europa) ou apac (Região Ásia-Pacífico).

      Informações de credencial
      Token de API Token de acesso de API que autoriza o acesso ao Roadmunk GraphQL API.

      Insira o mesmo token de acesso à API que você gerou em Gere um Roadmunk Token de acesso à API.

    5. Selecione Criar conexão.

    Criação do perfil de Integração Roadmunk

    Crie um Roadmunk perfil de integração para rastrear assinaturas de software e otimizar o licenciamento para seu Roadmunk aplicações.

    Antes de Iniciar

    Para criar um Roadmunk 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 .

    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 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. Roadmunk 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 Roadmunk .
      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 Roadmunk na lista suspensa.
      4. Selecione Continuar.
    2. No formulário, preencha os campos.
      Tabela 3. Formulário Perfil de integração
      Campo Descrição
      Nome de exibição Nome do perfil de integração. Por exemplo, Roadmunk Integration .
      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 Tipo de perfil de integração. Este campo é definido automaticamente como Assinatura do Roadmunk .
    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 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 Atualização de atividade do usuário do Roadmunk .
        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 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 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).

      . ServiceNow a 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 Roadmunk assinaturas, habilite o. Roadmunk Baixar subfluxo de assinaturas para baixar somente os usuários ativos em seu Roadmunk conta.
      Por padrão, o Roadmunk O subfluxo Baixar assinaturas baixa todos os usuários em seu Roadmunk conta, incluindo usuários ativos e inativos.
      1. Em uma nova guia ou janela, abra Roadmunk .
      2. Faça login usando suas credenciais de administrador de conta.
        . Roadmunk o painel é aberto.
      3. No menu de navegação esquerdo do Roadmunk painel, selecione o ícone do seu perfil e, em seguida, selecione Configurações da conta .
        Suas configurações de conta são abertas.
      4. No cabeçalho da página das configurações da sua conta, selecione Relatórios guia.
      5. Na lista de disponíveis Roadmunk relatórios, selecione Baixar CSV do usuário .
        . Roadmunk Os relatórios do usuário são baixados em .csv formato.
      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 Roadmunk Relatório do usuário que você baixou em etapa e. .
      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.
      Dica:
      Para remover continuamente usuários inativos da sua lista de Roadmunk baixe e anexe a versão mais recente do Roadmunk Relatório do usuário periodicamente.
    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. Selecione Publicar.
    9. 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 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.