Como integrar com Asana

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

    • A integração da aplicação Gestão de ativos de software com a aplicação Asana permite que você rastreie suas assinaturas de software e recupere licenças não utilizadas.

    Nota:
    Esta integração oferece suporte a todos os planos de Asana somente no nível da organização.
    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 Asana Escopos de autenticação
    Baixar assinaturas administrador padrão
    Extrair atividade do usuário administrador padrão
    Recuperar assinatura administrador padrão

    Registrar uma Asana aplicação OAuth 2.0

    Registre uma aplicação Asana OAuth para acessar a Asana API 1.0 e receber um ID de cliente e segredo do cliente.

    Antes de Iniciar

    Asana Função necessária: administrador

    Procedimento

    1. Faça login na sua conta Asana.
    2. Selecione o ícone do perfil do usuário no canto superior direito.
    3. Selecione Minhas configurações.
    4. Selecione a guia Aplicações.
    5. Selecione o link Gerenciar app de desenvolvedores na parte inferior para navegar até a janela do console do desenvolvedor.
    6. Selecione + Criar novo app.
    7. Na página Criar nova aplicação, forneça um nome para sua aplicação.
    8. Marque a caixa de seleção Concordo com os termos e condições da API.
    9. Selecione Criar app.
    10. Opcional: Forneça informações básicas sobre sua aplicação.
    11. Selecione OAuth no painel esquerdo.
    12. Copie o ID do cliente e o segredo do cliente para uso posterior.
    13. No campo URLs de redirecionamento, selecione + Adicionar URL de redirecionamento.
    14. Insira https:// <instance> .service-now.com/oauth_redirect.do em que é o nome da sua instância ServiceNow.

    Criar um perfil de integração Asana

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

    Antes de Iniciar

    O plug-in Gestão de ativos de software - Gestão de licenças de SaaS Integrations (com.sn_sam_saas_int) deve ser instalado a partir da ServiceNow Store.

    Função necessária: administrador ou sam_integrator

    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 Asana.
      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 Asana na lista suspensa.
      4. Selecione Continuar.
    2. No formulário, preencha os campos.
      Tabela 2. Formulário de perfil de integração
      Campo Valor
      Nome de visualização Nome do perfil de integração. Por exemplo, integração Asana.
      Conexão e Credencial Alias de conexão e credencial para o spoke Asana. Este campo é definido automaticamente como sn_asana_spoke.Asana.
      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 Asana Assinatura.
    3. Na guia Subfluxo de assinatura de download, verifique se o campo Subfluxo está definido como Asana Assinaturas de download.
    4. Na guia Calcular subfluxo de atividade, verifique se o campo Subfluxo está definido como Asana Atualizar subfluxo de atividade do usuário.
    5. Opcional: No campo Analisar atividade do usuário a partir de, selecione a data e a hora a partir das quais você deseja começar a analisar a 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.
    6. Na guia Recuperar subfluxo de assinatura, verifique se o campo Subfluxo está definido como Asana Recuperar assinaturas.
    7. Selecione Salvar.
      Um perfil de integração de rascunho é criado. O perfil de integração usa os subfluxos Asana Baixar assinaturas, Asana Atualizar atividade do usuário e Asana Recuperar assinatura para recuperar dados do usuário da aplicação Asana.
    8. Abra o registro de aliases de conexão e credencial selecionando o ícone de visualização (ícone Visualizar) ao lado do campo Conexão e credencial.
    9. Selecione Abrir registro na visualização do registro.
    10. Selecione o link relacionado Criar nova conexão e credencial.
    11. No formulário, preencha os campos.
      Tabela 3. Formulário Criar Conexão e Credencial
      Campo Valor
      Nome da conexão Nome da conexão Asana. Este campo é preenchido automaticamente.
      URL de Conexão URL da conexão. Este campo é definido automaticamente como https://app.asana.com.
      ID de cliente ID de cliente que você criou ao registrar Asana a aplicação OAuth.
      Segredo do cliente Segredo do cliente que você criou ao registrar a aplicação Asana OAuth.
      URL de redirecionamento do OAuth Este campo é preenchido automaticamente com https://<instance name> .service-now.com/oauth_redirect.do , em que instance name é o nome da sua instância ServiceNow.
    12. Selecione Salvar.
    13. Retorne ao perfil de integração e 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.