Criar um perfil de integração personalizado

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. 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 na sua instância ServiceNow, configure um método de autenticação no administrador da aplicação SaaS ou na conta de desenvolvedor. 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 para 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 para a aplicação OAuth. Você inserirá esses valores na sua instância ServiceNow.

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

    Função necessária: sam_integrator ou admin

    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 de perfil de integração
      Campo Valor
      Nome de visualização Nome à 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 clique em Novo. No formulário Aliases de conexão e credencial, preencha os campos.
      • Nome: 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 IntegrationHub existente ou um novo spoke que você criou. Você pode mudar a aplicação na seção Desenvolvedor do ícone Configuraçõesdo sistema 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 nova tentativa padrão: política de nova tentativa 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 do 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 do 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 de 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 desenvolvedor ou de administrador da aplicação SaaS.
      Segredo do cliente OAuth Segredo do cliente que você criou na conta de desenvolvedor ou de administrador 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 de 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 de desenvolvedor da aplicação SaaS.
      Chave de API Token de API criado no administrador da aplicação SaaS ou na conta do desenvolvedor.
      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 de Alias de conexão e credencial. Se a conexão falhar, você deverá excluir o registro da conexão, o registro da credencial e o 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.