Integração com Aha!

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 5 min. de leitura

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

    Para obter mais informações sobre o serviço Aha!, consulte Aha! Guia de gestão de produtos.

    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 Aha! Escopos de autenticação
    Download de assinaturas administrador Nenhum(a)
    Extrair atividade do usuário administrador Nenhum(a)
    Recuperar assinatura administrador Nenhum(a)

    Criar uma Aha! aplicação OAuth2

    Crie uma aplicação Aha! OAuth2 para obter acesso à API Aha!.

    Antes de Iniciar

    Aha! Função necessária: administrador

    Procedimento

    1. Vá para Autenticação OAuth2.
    2. Faça login no site Aha! usando suas credenciais de administrador.
    3. Na página Configurações pessoais, selecione Desenvolvedor.
    4. Selecione a guia Aplicações OAuth.
    5. Selecione Registrar aplicação OAuth.
    6. No formulário Registrar nova aplicação OAuth, insira https://instance/oauth_redirect.do como o URI de redirecionamento, em que instance é o nome da sua ServiceNow instância.
    7. Selecione Criar.
      A guia Aplicações OAuth mostra as chaves de ID de cliente e segredo do cliente.
    8. Anote os valores nos campos ID do cliente e Segredo do cliente.

    Configurar instância ServiceNow para Aha!

    Configure sua instância ServiceNow para adicionar as chaves Aha! de ID de cliente e Segredo do cliente.

    Antes de Iniciar

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

    Procedimento

    1. Faça login na sua instância ServiceNow.
    2. Navegar até Conexões e Credenciais > Aliases de conexão e credenciais.
      A página Aliases de conexão e credenciais é exibida e mostra a lista de apps.
    3. Localize e abra o registro de conexão e credenciais para Aha!.
    4. Selecione o link relacionado Criar nova conexão e credencial.
    5. No formulário Criar conexão e adicionar credencial, preencha os detalhes.
      Tabela 2. Formulário Criar conexão e adicionar credencial
      Campos Descrições
      Nome da Conexão Nome do perfil de integração.
      URL de conexão URL de conexão para Aha!.
      ID do cliente do OAuth Chave OAuth2 que você recebeu ao criar uma autenticação OAuth2 do site Aha!.
      Segredo do cliente do OAuth Chave secreta do cliente OAuth que você recebeu ao criar uma autenticação OAuth2 do site Aha!.
      URL de redirecionamento do OAuth ServiceNow URL de redirecionamento.
    6. Selecione Configurar e obter token OAuth e, em seguida, selecione Autorizar.
      Nota:
      Para a função necessária para executar esta etapa, consulte a tabela Permissões mínimas do usuário.

    Criar um perfil de integração Aha!

    Crie um perfil de integração para rastrear assinaturas de software e otimizar o licenciamento do serviço Aha!.

    Antes de Iniciar

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

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

    Importante:
    Você deve selecionar o Aha! Caixa de seleção Spoke para esta integração ao instalar recursos opcionais na página Application Manager. 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 perfil de integração Aha! em IU principal estará inativa.

    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 Aha.
      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 Aha! na lista suspensa.
      4. Selecione Continuar.
    2. No campo Nome de exibição, insira um nome de exibição de sua escolha.
      Tabela 3. Formulário Perfil de integração
      Campo Descrição
      Nome para exibição Nome do perfil de integração. Por exemplo, Aha 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 Aha! Assinatura.
    3. Revise as funções de usuário necessárias ou as permissões de API especificadas no campo Configuração do fornecedor para cada processo para minimizar os riscos de segurança e otimizar SaaS licenças.
      Nota:
      Para obter mais informações, consulte Tabela de permissões mínimas do usuário.
      1. Na seção Subfluxo de assinatura de download, verifique se o campo Subfluxo está definido como Aha! Baixar assinaturas.
        Nota:
        A caixa de seleção Baixar assinaturas está marcada por padrão e você não pode desmarcá-la.
      2. Na seção Recuperar subfluxo de assinatura, verifique se o campo Subfluxo está definido como Aha! Recuperar assinatura.
        Nota:
        A caixa de seleção Recuperar assinaturas está marcada por padrão. Se você não quiser recuperar assinaturas, poderá desmarcar esta caixa de seleção. Se você desmarcar, os candidatos a remoção serão criados, mas o subfluxo de assinatura de recuperação não será acionado ou o processo de recuperação não será iniciado.
    4. Selecione Save (Salvar).
      Sua instância ServiceNow cria um perfil de integração de rascunho.

      O campo Conexão e credencial é exibido e definido automaticamente como sn_aha_spoke.Aha_.

    5. 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 de download de assinaturas, mas não as APIs de recuperação de assinaturas.

    6. Depois que a conexão for verificada, selecione Publicar.
    7. Na caixa de diálogo Confirmação de publicação, selecione OK.

    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 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 definiçõ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 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.