Execute a descoberta por meio de uma chamada REST HTTP ou HTTPS

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 3 min. de leitura
  • A Descoberta pode classificar dispositivos usando o protocolo HTTP(S). Você pode criar seu próprio classificador HTTP para encontrar dispositivos e acessá-los com credenciais de Autenticação básica, em vez de usar credenciais SNMP ou SSH.

    Antes de Iniciar

    Função necessária: discovery_admin

    Procedimento

    1. Navegar até Tudo > Descoberta > Credenciais.
    2. Selecione Novo.
    3. Selecione Credenciais de autenticação básica .
      Na maioria dos casos, você pode usar Credenciais de autenticação básica para acessar um dispositivo por meio de uma chamada REST HTTP ou HTTPS.
      Importante:
      A probe HTTP Classify não tenta mais credenciais pelo protocolo HTTP por padrão. Para substituir esse comportamento, você pode habilitar mid.http_classy.allow_credentials_over_http. No entanto, habilitar esta configuração pode expor credenciais a ataques man-in-the-middle (MITM). Portanto, é altamente recomendável manter esta propriedade definida como falso E use HTTPS sempre que possível.
    4. Adicione o nome de usuário e a senha necessários para acessar o dispositivo.
    5. Selecione Enviar.
    6. Para configurar um classificador HTTP, navegue até Definição de Descoberta > Classificação de IC > HTTP.
    7. Selecione Novo.
    8. Preencha os campos do formulário (consulte a tabela):
      Figura 1. A classificação F5 de HTTP
      Classificação de HTTP
      Campo Descrição
      Nome Insira um nome para o classificador.
      Caminho Insira o caminho da solicitação HTTP GET.
      Cabeçalhos Adicione um cabeçalho de opção com um valor. Você pode usar uma variável no formato ${variable} em vez de um valor estático.

      Os cabeçalhos compatíveis dependem do provedor de serviço Web REST ao qual você deseja se conectar. Consulte a documentação do seu provedor de serviço Web para identificar quais cabeçalhos são válidos ou necessários.

      Porta (Serviço IP)

      Se você quiser que este classificador use uma porta personalizada que ainda não seja um valor padrão na tabela Serviço IP [cmdb_ip_service], faça o seguinte:

      1. Selecione o ícone de pesquisa para ver a lista de Serviços IP.
      2. Selecione Novo e crie um mapeamento de porta para protocolo.
      3. Selecione esse mapeamento de porta para protocolo para este campo Porta.

      Muitos protocolos usados com frequência já estão mapeados para portas por padrão, como http para a porta 80 e https para a porta 443.

      Se você quiser usar um desses mapeamentos de porta para protocolo padrão, não insira nenhum valor no campo Porta. O probe de porta HTTP usa o correto por padrão.

      Ordem

      Insira um número que represente a prioridade deste classificador. Se o Descoberta encontrar mais de um classificador que se aplique, ele usará o classificador com número de Ordem inferior.

      Protocolo

      [optional]

      Este campo não está visível por padrão. Você deve configurar o formulário para adicioná-lo.

      Se você configurar um mapeamento de porta para protocolo exclusivo para o campo Porta, insira uma substituição de protocolo opcional que a Descoberta usa com este classificador.

      Por exemplo, se você quiser usar a porta 5000 e o protocolo HTTP, adicione o mapeamento de porta para protocolo 5000/HTTP ao campo Porta e escolha http no campo Protocolo.
    9. Clique com o botão direito do mouse no cabeçalho e selecione Salvar.
      A lista relacionada Correspondência de classificação HTTP é exibida. Esta lista relacionada mostra critérios que você pode configurar para corresponder ao corpo da resposta à solicitação GET enviada pela Descoberta.
    10. Na lista relacionada Correspondência de classificação HTTP, defina os critérios de correspondência e especifique o padrão a ser iniciado para este classificador:
      1. Selecione Novo.
      2. No formulário Correspondência de classificação HTTP, preencha os campos do formulário (consulte a tabela).
        Correspondência da classificação de HTTP
        Campo Descrição
        Operador Escolha o operador que o sistema usa para avaliar a condição:
        • Contém
        • É igual a
        • Regex
        Ordem

        Insira um número que represente a prioridade desta condição. Se o Descoberta encontrar mais de uma condição que se aplique, ele usará a condição com número de Ordem inferior.

        Padrão Especifique o padrão a ser iniciado após uma correspondência correta. Este padrão deve usar HTTP para descobrir o dispositivo.
        valor Insira o valor que o corpo do método REST retornado deve ter.
      3. Selecione Enviar.
      4. Defina quantas correspondências de classificação HTTP forem necessárias.
        Você pode querer fazer isso se houver padrões diferentes para diferentes versões do dispositivo que você está tentando descobrir.

    Exemplo

    Neste exemplo, a classificação HTTP está configurada para usar a API do balanceador de carga F5:

    O que Fazer Depois

    Se você não tiver outros tipos de credenciais que possam encontrar dispositivos, como credenciais do Linux ou credenciais SNMP, poderá ver como a aplicação Descoberta processa a descoberta HTTP:
    1. Navegar até Descoberta > Cronogramas de descoberta e executar uma descoberta.
    2. Após a conclusão do processo de descoberta, verifique a fila do ECC para ver os resultados da descoberta HTTP.

      Depois que a probe do Shazzam foi iniciada e as probes de classificação UNIX e SNMP falharam. A probe HTTP - Classificar e o padrão especificado no registro de classificação HTTP devem ser iniciados.

      Registros de Fila ECC de classificação HTTP