Como integrar com monday.com

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

    • Integrar sua aplicação Gestão de ativos de software com monday.com 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 monday.com Escopos de autenticação
    Baixar assinaturas Membro users:read
    Extrair atividade do usuário Membro users:read

    Criar uma monday aplicação OAuth2

    Crie uma aplicação monday OAuth2 para autorizar o acesso à API monday.com.

    Antes de Iniciar

    monday.com Função necessária: consulte a tabela Permissões mínimas do usuário.

    Por Que e Quando Desempenhar Esta Tarefa

    Uma aplicação monday permite que você crie fluxos de trabalho, experiências do usuário e produtos sobre o sistema operacional monday.com de trabalho existente (SO do Work). Quando você configura uma aplicação monday para usar o OAuth2, o acesso é concedido à API monday.com para que ela possa ler e modificar os dados do usuário.

    Procedimento

    1. Em um navegador da Web, acesse monday.com.
    2. Faça login usando suas credenciais de administrador.
    3. Na parte inferior do menu de navegação à esquerda, selecione o ícone do seu perfil e selecione Desenvolvedores.
      A página Meus apps é aberta.
    4. Selecione Criar app.
      A página Informações Básicas da nova aplicação é aberta.
    5. Na seção Exibir informações, preencha os campos.
      Tabela 2. Exibir informações
      Campo Descrição
      Nome Nome da aplicação monday.
      Descrição resumida Descrição da aplicação.
    6. Opcional: Na mesma seção, adicione seu próprio ícone de aplicação selecionando o ícone gerado automaticamente e, em seguida, selecionando uma imagem de ícone.
      Você também pode mudar a cor do ícone selecionando Cor da aplicação e, em seguida, selecionando uma cor predefinida ou personalizada. Se você não adicionar seu próprio ícone de aplicação ou selecionar uma cor de ícone, a aplicação usará o ícone gerado automaticamente e a cor do ícone padrão.
    7. Na seção Credenciais do app, copie os valores nos campos ID do cliente e Segredo do cliente.
      Salve-os em um local seguro para uso posterior.
    8. Selecione Salvar app.
    9. No menu de navegação à esquerda da nova aplicação, navegue até Geral > OAuth.
      A guia Escopos da página OAuth e Permissões é aberta.
    10. Na seção Escopos, especifique como a aplicação pode acessar ou usar diferentes tipos de dados do usuário marcando a caixa de seleção do escopo users:read do OAuth.
    11. Selecione Salvar recurso.
    12. Selecione a guia Redirecionar URLs da página OAuth e Permissões.
    13. Na seção Redirecionar URLs, insira o URL do provedor OAuth para o qual os usuários são redirecionados após a autenticação.
      Insira https://instance.service-now.com/oauth_redirect.do, em que <instance> é o nome da sua instância ServiceNow.
    14. Selecione Salvar recurso.

    Criação do perfil de Integração monday.com

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

    Antes de Iniciar

    Para criar um perfil de integração monday.com, 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 Espaço para ativos de software, a opção para criar o perfil de integração [ monday.com em 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 monday.com.
      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 monday.com 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, Integração monday.com.
      Conexão e Credencial Alias de conexão e credencial para o spoke monday.com.

      Este campo é definido automaticamente como sn_monday_com_spok.Monday.
      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 monday.com.
    3. Na guia Subfluxo de assinatura de download, verifique se o campo Subfluxo está definido como Subfluxo de assinaturas de download do monday.com.
    4. Selecione Salvar.
      Sua instância ServiceNow cria um perfil de integração de rascunho. O perfil de integração usa os subfluxos monday.com Baixar assinaturas e monday.com Atualizar atividade do usuário para recuperar dados do usuário de suas monday aplicações.
    5. Abra o registro de aliases de conexão e credencial selecionando o ícone de visualização (ícone de visualização) ao lado do campo Conexão e credencial e selecionando Abrir registro na visualização do registro.
    6. No formulário Aliases de conexão e credencial, selecione o link relacionado Criar nova conexão e credencial.
    7. Na caixa de diálogo, preencha os campos.
      Tabela 4. Caixa de diálogo Criar conexão e credencial
      Campo Descrição
      Nome da conexão O nome da conexão.
      URL de Conexão URL base para a API monday.com.

      Este campo é definido automaticamente como https://api.monday.com/.
      ID do cliente OAuth ID de cliente atribuído à sua aplicação monday.
      Segredo do cliente OAuth Segredo do cliente atribuído à sua aplicação monday.
      URL de redirecionamento do OAuth URL do provedor OAuth para o qual os usuários são redirecionados após a autenticação.

      Este campo é preenchido automaticamente com base no URL de redirecionamento que você especificou em Criar uma monday aplicação OAuth2.
    8. Selecione Criar e obter um Token do OAuth.
      Nota:
      Para a função necessária para executar esta etapa, consulte a tabela Permissões mínimas do usuário.
    9. Na caixa de diálogo Autorizar aplicação, entre usando as mesmas credenciais monday.com que você usou para criar sua aplicação monday.
    10. Selecionar Permitir.
      A caixa de diálogo é fechada e você retorna automaticamente ao formulário de perfil de integração.
    11. Selecione 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.