Como integrar com Roadmunk

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 6 min. de leitura

    • A integração da aplicação Gestão de ativos de software com a aplicação Roadmunk 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 do usuário necessária na aplicação Roadmunk Escopos de autenticação
    Baixar assinaturas Administrador de conta Sem escopos
    Extrair atividade do usuário Administrador de conta Sem escopos
    Recuperar assinatura Administrador de conta Sem escopos

    Gerar um Roadmunk token de acesso de API

    Gere um token de acesso de API que autorize o acesso à Roadmunk GraphQL API.

    Antes de Iniciar

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

    Procedimento

    1. Em um navegador da Web, abra o Roadmunk.
    2. Faça login usando suas credenciais de administrador de conta.
    3. No menu de navegação à esquerda do painel Roadmunk, selecione o ícone do seu perfil e selecione Configurações da conta.
    4. No cabeçalho da página das configurações da sua conta, selecione a guia Integrações.
    5. Em Integrações existentes, selecione Adicionar uma integração.
    6. Quando solicitado a selecionar uma integração para configurar, selecione Tokens de API.
    7. No formulário Roadmunk Tokens de API, insira um nome para o token de acesso à API no campo Nome da aplicação.
    8. Selecione Criar token de API.
      O token de acesso de API é gerado e a caixa de diálogo Token de API criado é aberta.
    9. Na caixa de diálogo Token de API criado, copie o token de acesso de API selecionando Copiar para área de transferência.
      Salve-o em um local seguro para uso posterior.

    Criar uma conexão do Roadmunk

    Crie uma conexão entre suas aplicações Roadmunk e sua instância 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. Em sua instância ServiceNow, navegue até Automação de Processo > Flow Designer.
      O Flow Designer é iniciado em uma nova guia.
    2. Selecione a guia Conexões.
    3. Localize sua conexão 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 da conexão Roadmunk. 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 da região do app padrão (América do Norte), poderá alterar o valor da região para eu (Europa) ou apac (Região da Ásia-Pacífico).
      Informações de credencial
      Token de API Token de acesso de API que autoriza o acesso à Roadmunk GraphQL API.

      Insira o mesmo token de acesso de API que você gerou em Gerar um Roadmunk token de acesso de API.
    5. Selecione Criar conexão.

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

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

    Antes de Iniciar

    Para criar um perfil de integração Roadmunk, solicite o plug-in Gestão de ativos de software - Gestão de licenças de SaaS (com.sn_sam_saas_int) na ServiceNow Store.

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

    Por Que e Quando Desempenhar Esta Tarefa

    Se você estiver usando o Software Asset Workspace, a opção para criar o perfil de integração Roadmunk na IU principal estará inativa.

    Procedimento

    1. Navegue até o perfil de integração.
      InterfaceAção
      IU principal
      1. Navegar até Todos > Ativo de Software > Licença de SaaS > Perfis de Integração Direta.
      2. Selecione Novo.
      3. Selecione o 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 direta.
      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.
      Conexão e Credencial Alias de conexão e credencial para o spoke Roadmunk. Este campo é definido automaticamente como sn_roadmunk_spoke.Roadmunk.
      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. Na guia Subfluxo de assinatura de download, verifique se o campo Subfluxo está definido como Assinaturas de download do Roadmunk.
    4. Na guia Calcular subfluxo de atividade, verifique se o campo Subfluxo está definido como Roadmunk Atualizar subfluxo de atividade do usuário.
      Você também pode selecionar a data e a hora em que deseja analisar a atividade do usuário no campo Analisar atividade do usuário de. 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 cria este perfil.
      Nota:
      Gestão de ativos de software extrai os eventos a partir 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 de última atividade das regras de recuperação de software. Para obter mais informações, consulte Revisar uma regra de recuperação de software.
    5. Na guia Recuperar subfluxo de assinatura, verifique se o campo Subfluxo está definido como Assinatura de recuperação do Roadmunk.
    6. Clique em Salvar.
      Sua instância ServiceNow cria um perfil de integração de rascunho. O perfil de integração usa os subfluxos Roadmunk Baixar assinaturas e Roadmunk Atualizar atividade do usuário para recuperar dados do usuário da aplicação Roadmunk.
    7. Opcional: Para impedir que seu perfil de integração inclua usuários inativos em sua lista de assinaturas Roadmunk, habilite o subfluxo Roadmunk Baixar assinaturas para baixar somente os usuários ativos em sua conta Roadmunk.
      Por padrão, o subfluxo Roadmunk Baixar assinaturas baixa todos os usuários na sua conta Roadmunk, incluindo usuários ativos e inativos.
      1. Em uma nova guia ou janela, abra o Roadmunk.
      2. Faça login usando suas credenciais de administrador de conta.
        O painel Roadmunk é aberto.
      3. No menu de navegação à esquerda do painel Roadmunk, clique no ícone do seu perfil e 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 a guia Relatórios.
      5. Na lista de relatórios Roadmunk disponíveis, clique em Baixar usuário CSV.
        O Roadmunk relatório do usuário é baixado no formato CSV.
      6. Retorne ao formulário Perfil de integração.
      7. No cabeçalho do formulário, clique no ícone Gerenciar anexos (ícone Gerenciar anexos).
        A caixa de diálogo Anexos é aberta.
      8. Na caixa de diálogo, clique em Escolher arquivo para localizar e selecionar o Roadmunk Relatório do usuário que você baixou na etapa e.
      9. Depois que o relatório for carregado com sucesso, feche a caixa de diálogo para retornar ao formulário de perfil de integração.
      Dica:
      ServiceNow recomenda que você baixe e anexe a versão mais recente do Roadmunk Relatório do Usuário periodicamente para que possa remover continuamente usuários inativos da sua lista de Roadmunk assinaturas.
    8. Clique em Publicar.

    O que Fazer Depois

    Depois que a integração se conecta, sua instância ServiceNow cria automaticamente modelos de software, regras de recuperação e assinaturas de usuário que são atualizadas diariamente.

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