Criar um perfil de integração personalizado

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

    • Crie um perfil de integração personalizado para rastrear assinaturas de software e otimizar licenças obsoletas para qualquer aplicação SaaS.

    Antes de Iniciar

    Antes de criar um perfil de integração personalizado em sua instância ServiceNow, configure um método de autenticação na conta de administrador ou desenvolvedor da aplicação SaaS. Por exemplo, crie uma aplicação OAuth ou um token de API.

    • Se você criar uma aplicação OAuth, confirme se habilitou os escopos apropriados. O app precisa de escopos para ler usuários, ler a atividade do usuário e modificar ou excluir usuários. Esses escopos permitem que a integração obtenha uma lista de usuários, obtenha a atividade do usuário e recupere assinaturas não utilizadas. Registre o ID do cliente e o segredo do cliente da aplicação OAuth. Você insere esses valores em sua instância ServiceNow.
    • Se você criar um token de API, registre o valor do token de API. Você insere este valor em sua instância 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 personalizado no IU principal estará inativa.

    Procedimento

    1. Navegue até o perfil de integração personalizado.
      InterfaceAção
      IU principal
      1. Navegar até Tudo > Licença de SaaS > Administração > Criar novo perfil.
      2. Selecione Perfil de integração personalizado.
      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 Personalizado na lista suspensa.
      4. Selecione Continuar.
    2. No formulário, preencha os campos.
      Tabela 1. Formulário Perfil de integração personalizada
      Campo Valor
      Nome de exibição Nome do perfil de integração personalizado.

      Por exemplo, o nome da aplicação SaaS com a qual você está integrando.
      Conexão e Credencial
      1. Clique no ícone de pesquisa (ícone de pesquisa).
      2. Selecione Novo.
      3. No formulário Aliases de conexão e credencial, preencha os campos:
        • Nome: o nome de sua escolha. Por exemplo, app_alias, em que app é o nome da aplicação SaaS com a qual você está integrando.
        • Aplicação: spoke para conexão com a aplicação SaaS. Este spoke pode ser um spoke Integration Hub existente ou um novo spoke que você criou. Você pode mudar a aplicação na seção Desenvolvedor das Configurações do sistema ícone Configurações.
        • Tipo: conexão e credencial.
        • Tipo de conexão: HTTP.
        • Suporte a várias conexões ativas: não selecionado.
        • Política de repetição padrão: política de repetição de HTTP padrão.
        • Modelo de configuração: se você estiver usando o tipo de concessão de código de autorização OAuth, Código de autorização OAuth. Se você estiver usando um token de API, Autenticação básica com chave de API. Se você estiver usando outro método de autenticação, crie um modelo de configuração. Para obter mais informações, consulte Criar um modelo de configuração e Configurar um modelo para o tipo de concessão de portador OAuth JWT.
      4. Selecione Enviar.
      Status Status do perfil de integração. As opções são Rascunho e Publicado. Este valor é preenchido automaticamente.
      Tipo de perfil Integração personalizada. Este valor é preenchido automaticamente.
    3. Selecione Save (Salvar).
    4. Abra o registro de alias de conexão e credencial selecionando o ícone de visualização ( ícone de visualização) e selecionando Abrir registro.
    5. Selecione o link relacionado Criar nova conexão e credencial.
      • Se você estiver usando o modelo de configuração de código de autorização OAuth, preencha os campos.
        Tabela 2. Formulário Criar Conexão e Credencial
        Campo Valor
        URL de conexão URL base da API.
        URL de Autorização Endpoint do código de autorização do OAuth.
        URL de Token Endpoint do OAuth para recuperar e atualizar tokens de acesso.
        URL de revogação do token Endpoint do OAuth para revogar tokens de acesso.
        URL de redirecionamento do OAuth https://instance.service-now.com/oauth_redirect.do, em que instance é o nome da sua instância ServiceNow.
        Tempo de vida do token de atualização 8640000.
        ID do cliente do OAuth ID de cliente que você criou na conta de administrador ou desenvolvedor da aplicação SaaS.
        Segredo do cliente do OAuth Segredo do cliente que você criou na conta de administrador ou desenvolvedor da aplicação SaaS.
        Escopos do OAuth Escopos que você habilitou para sua aplicação OAuth na conta de administrador ou desenvolvedor da aplicação SaaS.
      • Se você estiver usando o modelo de configuração Autenticação básica com chave de API, preencha os campos.
        Tabela 3. Formulário Criar Conexão e Credencial
        Campo Valor
        URL de conexão URL da sua conta SaaS.
        Nome de usuário Endereço de e-mail do usuário administrador que criou o token de API na conta de administrador ou desenvolvedor da aplicação SaaS.
        Chave de API Token de API criado na conta de administrador ou desenvolvedor da aplicação SaaS.
      • Se você estiver usando um método diferente de autenticação, os campos disponíveis serão determinados pelo modelo de configuração que você criou.
    6. Selecione Criar e conceder acesso para a integração.
      Dica:
      Faça login na sua conta de administrador de aplicações SaaS em uma nova guia do navegador para verificar se a integração se conecta à conta correta.
      • Se a conexão for bem-sucedida, um registro de conexão será criado na lista relacionada Conexões no registro Alias de conexão e credencial.
      • Se a conexão falhar, você deverá excluir o registro de conexão, o registro de credencial e o registro de registro da aplicação que foram criados durante a tentativa de conexão.
        1. Para excluir o registro de conexão, navegue até Conexões e Credenciais > Conexões e exclua o registro da aplicação SaaS.
        2. Para excluir o registro de credencial, navegue até Conexões e Credenciais > Credenciais e exclua o registro da aplicação SaaS.
        3. Para excluir o registro de registro da aplicação, navegue até OAuth de Sistema > Registro de aplicações e exclua o registro da aplicação SaaS.
        4. Retorne ao registro Alias de conexão e credencial da aplicação SaaS e selecione o link relacionado Criar nova conexão e credencial para tentar a conexão novamente.

    O que Fazer Depois

    Criar uma ação de fluxo de dados para obter usuários e exibir SaaS análises relacionadas em SaaS painel de visão geral.

    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 (aplicação clássica do Software Asset Management) 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.