Configure uma entrada de dados da REST API no Análise de logs de integridade manualmente

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura
  • Configure uma entrada de dados da REST API para transmitir dados de log para seu ServiceNow instância.

    Antes de Iniciar

    • Verifique se um MID Server Está instalado e configurado com o recurso de ingestão de log habilitado. Para obter mais informações, consulte MID Server system requirements.

      Configuração DO MID Server com o recurso de ingestão de log habilitado.

      Importante:
      Análise de logs de integridade Não é compatível com IPv6. Para trabalhar com a aplicação, configure o. MID Server Para IPv4.

      No formulário Contexto do MID Web Server, em Executar em campo, selecione MID Server específico e não a opção de cluster. Em MID Server selecione o específico MID Server para o qual os dados de log são extraídos.

    • . MID Server O endereço IP é exposto por meio da conversão de endereços de rede (NAT), de um balanceador de carga ou de um dispositivo semelhante, o. MID Server Deve ter um endereço IP público para ser acessado por clientes externos, como Filebeat agentes, localizados fora de sua rede. Endereços IP privados não são roteáveis pela Internet, portanto, sem um IP público, esses clientes externos não podem se conectar ao MID Server mesmo se eles estiverem configurados com seu endereço. Em MID Server, adicione uma propriedade chamada mid.public_ipCom o endereço IP público como o valor. Para obter mais informações, consulte Crie uma propriedade do MID Server .
      Nota:
      . MID Server E os clientes externos estão na mesma rede, um IP público não é necessário e as conexões podem ser feitas usando o endereço IP privado.

    Função necessária: evt_mgmt_admin

    Procedimento

    1. Navegar até Tudo > Análise de logs de integridade > Entrada de dados > Entradas de dados.
    2. Na página Entradas de dados, selecione Novo .
    3. Escolha a entrada de dados da REST API.
    4. No formulário, preencha os campos.
      Para obter uma descrição dos campos, consulte REST API data input configuration fields.
    5. Selecione Save (Salvar).
      • Análise de logs de integridade adiciona o registro de entrada de dados ao Entradas de dados tabela.
      • O sistema gera automaticamente o URL de entrada de dados DA REST API para enviar logs para MID Server. O URL gerado estará neste formato: http://(MID_SERVER_IP):(MID_WEB_SERVER_PORT)/ap1/mid/hla/raw . HLA substitui (MID_SERVER_IP) e. (MID_WEB_SERVER_PORT) com os valores configurados.
    6. Copie o URL gerado.
    7. Instrua seu cliente de API a enviar mensagens de log para MID Server.
      1. No cliente de API, configure uma solicitação com os seguintes parâmetros:
        • Método HTTP: POST.
        • URL: O URL que você copiou na etapa anterior.
        • Autenticação: As credenciais de autenticação necessárias. Por exemplo, Autenticação básica (nome de usuário e senha).
          Nota:
          O método de autenticação deve ser o mesmo que o método configurado no MID Web Server.
        • Cabeçalhos: Defina Content-Type cabeçalho para corresponder ao formato da carga.
          • Para JSON: aplicação/json .
          • Para texto bruto: texto/sem formatação .
        • Corpo: A carga de logs em JSON ou texto bruto.
      2. Envie a solicitação.
        Uma resposta bem-sucedida indica que MID Server recebeu a carga. . MID Server processou as mensagens de log, a entrada de dados as transmite para seu ServiceNow Instância usando o protocolo REST.