Criar uma conexão com o ILMT ou o BigFix Inventory

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 8 min. de leitura
  • Se você estiver usando uma conexão HTTP ou tiver concluído a configuração inicial do HTTPS, estabeleça uma conexão entre o servidor IBM e o Now Platform.

    Antes de Iniciar

    Função necessária: sam_admin

    Por Que e Quando Desempenhar Esta Tarefa

    Nota:
    Se você estiver usando uma conexão HTTP ou HTTPS sem o MID Server, a porta do firewall deverá ser aberta para conectividade com o endereço IP da instância ServiceNow.

    Procedimento

    1. Navegar até Todos > Integração — ILMT/BigFix Inventory > Configuração.
    2. Na guia relacionada Conexões do formulário Aliases de conexão e credencial, selecione Novo.
      O formulário de conexão HTTP(s) é aberto.
      Formulário de conexão HTTPs.
    3. No formulário, preencha os campos.
      Tabela 1. Formulário de conexão HTTP
      Campo Descrição
      Nome Nome exclusivo da conexão.
      Credencial Credenciais que são usadas para estabelecer a conexão. Você pode usar credenciais de autenticação básica, como nome de usuário e senha, ou credenciais de chave de API.
      Nota:
      Selecione as mesmas credenciais que você usa para acessar o servidor ILMT.
      Alias de conexão

      Alias de conexão com o qual a conexão pode ser referenciada. Este alias de conexão resolve sua conexão e credenciais no tempo de execução.

      Este campo é definido automaticamente para o alias sn_samp_ibm.IBMServers.

      Ativo Opção indicando que a conexão está ativa.
      Domínio Domínio ao qual a conexão pertence.
    4. Especifique o URL da conexão.
      Dependendo se você está usando uma conexão HTTP ou HTTPS, use uma das seguintes opções para especificar o URL de conexão:
      • Conexão HTTP: especifique a URL de conexão HTTP usando o campo URL de conexão.

        No campo URL de conexão, insira um URL no formato http://<host-ip-address|dns-hostname>:<port>.
        Campo URL de conexão.
        Nota:
        Você não pode modificar o campo URL de conexão se marcar a caixa de seleção do construtor de URL.
      • Conexão HTTPS: especifique a URL da conexão HTTPS usando o construtor de URL ou um certificado SSL.
        Opção de URL de conexão HTTPS Procedimento
        Construtor de URL
        1. Para habilitar sua instância ServiceNow para criar um URL de conexão usando o construtor de URL, marque a caixa de seleção do construtor de URL.

          Os campos Autenticação mútua, Protocolo, Host, Substituir porta padrãoe Caminho base aparecem no formulário.

          Marcar a caixa de seleção do construtor de URL.
        2. No campo Protocolo, especifique o protocolo subjacente que é usado pela conexão.

          Este campo é definido automaticamente como https.

        3. No campo Host, insira o URL do host de destino que é usado pela conexão.

          Você deve inserir um URL no formato https://<host-ip-address|dns-hostname>:<port>.

        4. (Opcional) No campo Substituir porta padrão, insira o número da porta de destino que é usada pela conexão.

          Você deve inserir o mesmo número de porta usado para a configuração do ILMT ou do BigFix Inventory.

        5. (Opcional) No campo Caminho base, insira o caminho base da conexão.
        Certificado SSL
        1. Recupere um certificado SSL do servidor IBM.
        2. Dependendo se você está usando uma conexão HTTPS com ou sem o MID Server, use uma das seguintes opções para aplicar o certificado à sua instância ServiceNow :
          • Sem o MID Server:
            1. Em uma nova guia ou janela, carregue o certificado para sua instância ServiceNow.

              Consulte HTTPS sem o MID Server para obter instruções detalhadas.

            2. Retorne ao formulário de conexão HTTP(s).
            3. Habilite sua instância ServiceNow para criar um URL de conexão marcando a caixa de seleção do construtor de URL.

              Os campos Autenticação mútua, Protocolo, Host, Substituir porta padrãoe Caminho base aparecem no formulário.

              Marcar a caixa de seleção do construtor de URL.
            4. Habilite a autenticação mútua para a conexão marcando a caixa de seleção Autenticação mútua.

              O campo Protocolo é substituído pelo campo Perfil de protocolo.

              Marcar a caixa de seleção Autenticação mútua.
            5. No campo Perfil de protocolo, selecione o ícone de pesquisa ( ícone de pesquisa) para localizar e selecionar o perfil do protocolo HTTPS que especifica o certificado usado para autenticação mútua.

              Você deve selecionar o mesmo perfil de protocolo criado em HTTPS sem o MID Server.

          • Com o MID Server:
            1. Em uma nova guia ou janela, carregue o certificado para sua instância ServiceNow.

              Consulte HTTPS com o MID Server para obter instruções detalhadas.

            2. Retorne ao formulário de conexão HTTP(s) e marque a caixa de seleção Usar MID Server.

              A guia Configuração avançada do MID Server é exibida.

              Marcar a caixa de seleção Usar MID Server.
            3. No campo Seleção de MID da guia Configuração avançada do MID Server, especifique como você deseja selecionar um MID Server para a conexão.

              Selecione uma das seguintes opções.
              • Seleção automática de MID Server: seleciona automaticamente um MID Server na lista de MID Servers que estão configurados para a conexão. Esta opção é selecionada por padrão.

                Se você selecionar esta opção, a guia Configuração avançada do MID Server exibirá os campos Capacidades e Aplicação de MID. Você pode usar esses campos para filtrar a lista de MID Servers disponíveis com base em capacidades e aplicações MID Server compatíveis.
                • Para filtrar esta lista com base em MID Server capacidades, selecione o ícone Desbloquear capacidades ( Ícone Desbloquear capacidades.) no campo Capacidades. Depois de desbloquear o campo, selecione o ícone Pesquisar usando lista ( Pesquisar usando ícone de lista) para pesquisar e selecionar os recursos desejados.
                • Para filtrar esta lista com base em MID Server aplicações, selecione o ícone Pesquisar usando lista ( Pesquisar usando ícone de lista.) no campo Aplicação MID para pesquisar e selecionar as aplicações desejadas.

                Consulte Seleção do MID Server para obter mais informações sobre MID Server capacidades e aplicações.

              • MID Server específico: permite que você selecione um MID Server específico para a conexão.

                Se você selecionar esta opção, a guia Configuração avançada do MID Server exibirá o campo MID Server. Selecione o ícone Pesquisar usando lista ( Pesquisar usando ícone de lista.) no campo do MID Server para pesquisar e selecionar o MID Server que deseja usar para a conexão.
                Importante:
                Para selecionar um MID Server específico para a conexão, você deve desmarcar a caixa de seleção Incluído na aplicação TODOS para todas as aplicações que estão configuradas para usar o MID Serverespecificado. Para obter mais informações sobre esta caixa de seleção, consulte a seção Selecionar aplicações a serem incluídas na definição de TODOS para um MID Server de Configurar um MID Server padrão para cada aplicação.
              • Cluster MID específico: permite que você selecione um cluster MID Server específico para a conexão.

                Se você selecionar esta opção, a guia Configuração avançada do MID Server exibirá o campo Cluster do MID. Selecione o ícone Pesquisar usando lista ( Ícone Pesquisar usando lista.) no campo Cluster do MID para pesquisar e selecionar o cluster MID Server que você deseja usar para a conexão.

    5. Configure o tempo limite de conexão.
      Use uma das seguintes opções para configurar o tempo limite de conexão:
      • Propriedade do sistema glide.http.outbound.max_timeout.enabled : a propriedade do sistemaNow Platform glide.http.outbound.max_timeout.enabled permite especificar o número de segundos que as APIs RESTMessageV2 e SOAPMessageV2 aguardam por uma resposta de uma chamada síncrona. Você pode configurar esta propriedade do sistema abrindo uma nova guia ou janela e navegando até Propriedades do sistema > Todas as Propriedades > glide.http.outbound.max_timeout.enabled. Se esta propriedade do sistema estiver definida como verdadeira ou não estiver disponível em sua instância ServiceNow, sua instância usará um valor de tempo limite padrão de 30 segundos. Se esta propriedade do sistema estiver definida como falsa, sua instância ServiceNow usará um valor de tempo limite padrão de 600 segundos. Consulte Propriedades do sistema disponíveis para obter mais informações sobre esta propriedade do sistema.
      • Campo Tempolimite de conexão: o campoTempo limite de conexão no formulário Conexão HTTP(s) permite que você especifique o número de segundos que sua instância ServiceNow espera para estabelecer a conexão fornecida.
        Importante:
        Esta opção é aplicável somente nas versões San Diego e posteriores. Nas versões Rome e anteriores, você deve configurar o tempo limite de conexão usando somente a propriedade do sistema glide.http.outbound.max_timeout.enabled.
        A aplicação do campo Tempo limite de conexão depende da configuração da propriedade do sistema glide.http.outbound.max_timeout.enabled. Se a propriedade do sistema estiver definida como falsa, sua instância ServiceNow honrará o valor especificado no campo Tempo limite de conexão.
        Nota:
        Se o campo Tempo limite de conexão estiver vazio, sua instância ServiceNow usará um valor de tempo limite de conexão padrão de 300 segundos.

        Se a propriedade do sistema estiver definida como verdadeira ou não estiver disponível em sua instância ServiceNow, sua instância ignorará o valor especificado no campo Tempo limite de conexão. Em vez disso, sua instância usa um valor de tempo limite de conexão padrão de 30 segundos.

    6. Configure atributos adicionais para a conexão.
      Selecione a guia Atributos e preencha os campos.
      Guia Atributos no formulário de conexão HTTPs.
      Tabela 2. Guia Atributos
      Campo Descrição
      origem Origem dos seus dados de instalação de software IBM. As opções são ILMT e BigFix Inventory.
      computer_system_offset

      Valor de deslocamento que evita que sua instância ServiceNow importe novamente registros de computador do ILMT ou do BigFix Inventory. Cada vez que você executa uma importação, o valor de deslocamento é atualizado automaticamente com base nos registros de computador incluídos na importação. Cada importação subsequente recupera somente novos registros de computador a partir do valor de deslocamento especificado.

      Se você estiver estabelecendo uma nova conexão, verifique se o valor de deslocamento está definido como 0. Se você quiser reimportar todos os registros de computador para uma conexão existente, redefina o valor de deslocamento para 0.

      virtual_machine_offset

      Valor de deslocamento que evita que sua instância ServiceNow importe novamente registros de máquina virtual (VM) do ILMT ou do BigFix Inventory. Cada vez que você executa uma importação, o valor de deslocamento é atualizado automaticamente com base nos registros de VM incluídos na importação. Cada importação subsequente recupera somente novos registros de VM a partir do valor de deslocamento especificado.

      Se você estiver estabelecendo uma nova conexão, verifique se o valor de deslocamento está definido como 0. Se você quiser reimportar todos os registros de VM para uma conexão existente, redefina o valor de deslocamento para 0.

    7. Selecione Enviar.
      As informações de conexão ativa são exibidas.
    8. Opcional: Se você estiver usando a versão 1 das APIs do ILMT e do BigFix Inventory, importe os dados programados do ILMT ou do BigFix Inventory manualmente.
      1. Navegar até Integração — inventário ILMT/BigFix > Importação agendada e selecione Executar agora.
      2. Verifique se a importação foi concluída com sucesso.
        • Para verificar se a importação e a transformação foram concluídas com sucesso, navegue até Integração — inventário ILMT/BigFix > Histórico de Transformações.
          Nota:
          Cada registro na tabela Históricos de transformação exibe um valor de Inserções de 0.
        • Para exibir todos os dados que foram importados para a tabela Consumo de licença [samp_ilmt_sw_install], navegue até Integração — inventário ILMT/BigFix > Dados do conjunto de importação > Consumo de Licença.
        • Para exibir todos os dados que foram importados para a tabela Computador [cmdb_ci_computer], navegue até Integração — inventário ILMT/BigFix > Dados do conjunto de importação > Computadores.