Criar um perfil de integração personalizado

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 4 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, certifique-se de habilitar 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 e o segredo do cliente da aplicação OAuth. Você inserirá esses valores em sua instância ServiceNow.

    Se você criar um token de API, registre o valor do token de API. Você inserirá este valor em sua instância ServiceNow.

    Função necessária: sam_integrator ou administrador

    Procedimento

    1. Navegar até Todos > Licença de SaaS > Administração > Criar novo perfil e selecione Perfil de integração personalizado.
    2. No formulário, preencha os campos.
      Tabela 1. Formulário Perfil de integração
      Campo Valor
      Nome de visualização Nome de sua escolha. Por exemplo, o nome da aplicação SaaS com a qual você está integrando.
      Conexão e Credencial Clique no ícone de pesquisa ( ícone de pesquisa) e, em seguida, clique em Novo. 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ódigode 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.
      Clique em 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. Clique em Salvar.
    4. Abra o registro de alias de conexão e credencial clicando no ícone de visualização (ícone de visualização) e, em seguida, clicando em Abrir registro.
    5. Clique no link relacionado Criar nova conexão e credencial.
    6. Se você estiver usando o modelo de configuração de código de autorização OAuth, preencha o formulário conforme mostrado.
      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 do 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 OAuth ID de cliente que você criou na conta de administrador ou desenvolvedor da aplicação SaaS.
      Segredo do cliente 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 de desenvolvedor da aplicação SaaS.
    7. Se você estiver usando o modelo de configuração Autenticação básica com chave de API, preencha o formulário conforme mostrado.
      Tabela 3. Formulário Criar Conexão e Credencial
      Campo Valor
      URL de Conexão URL da sua conta de 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.
      Nota:
      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.
    8. Clique em Criar e conceda acesso para a integração.
      Dica:
      Faça login na sua conta de administrador da aplicação SaaS em uma nova guia do navegador para garantir que a integração se conecte à conta correta.
      Se a conexão for bem-sucedida, um novo 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.
      • Navegar até Conexões e Credenciais > Conexões e exclua o registro de conexão da aplicação SaaS.
      • Navegar até Conexões e Credenciais > Credenciais e exclua o registro de credencial da aplicação SaaS.
      • Navegar até OAuth de Sistema > Registro de aplicações e exclua o registro da aplicação para a aplicação SaaS.
      Retorne ao registro de alias de conexão e credencial da aplicação SaaS e clique no link relacionado Criar nova conexão e credencial para tentar a conexão novamente.