Integração com Roadmunk

  • 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.
    Tabela 1. Permissões mínimas do usuário
    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

    Gere um RoadmunkToken de acesso à API

    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 .
    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

    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 Processo > Flow 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.
      Tabela 2. Caixa de diálogo Criar conexão
      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.

    5. Selecione Criar conexão.

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

    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 .

    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 Managerpá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. Roadmunkperfil de integração em IU principalestá 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 ativos de 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 de perfil de integração
      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 .
      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 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 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 <displayname> 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.
      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.
    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 .
      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.
      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. .
      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 Roadmunkassinaturas, baixe e anexe a versão mais recente do RoadmunkRelató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.

      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 <displayname> Activityo trabalho é excluído.

    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.

    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.

    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 seus resultados de reconciliação no Workbench de licença ( Gestão de ativos de softwareaplicação clássica) ou o. Exibição de uso de licença (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.