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

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é Todos > Descoberta > Credenciais.
2. Clique em Nova.
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.
4. Adicione o nome de usuário e a senha necessários para acessar o dispositivo.
5. Clique em Enviar.
6. Configure um classificador HTTP navegando até Definição de Descoberta > Classificação de IC > HTTP.
7. Clique em Nova.
8. Preencha os campos do formulário (ver tabela):

   Figura 1. A classificação F5 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: Selecione o ícone de pesquisa para ver a lista de Serviços IP. Selecione Novo e crie um mapeamento de porta para protocolo. 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 que a Descoberta enviou.
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. Clique em Nova.
    2. No formulário Correspondência de classificação HTTP, preencha os campos do formulário (consulte a tabela).
       

       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. Clique em Enviar.
    4. Defina quantas correspondências de classificação HTTP forem necessárias.
       Você pode fazer isso se houver padrões diferentes para versões diferentes do dispositivo que está tentando descobrir.

Exemplo

Neste exemplo, a classificação HTTP é 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 Linux ou credenciais SNMP, poderá ver como a aplicação Descoberta processa a descoberta HTTP:

1. Navegar até Descoberta > Cronogramas de descoberta e execute uma descoberta.
2. Depois que o processo de descoberta for concluído, verifique a Fila do ECC para ver os resultados da descoberta HTTP.

   Você deve ver isso depois que a probe Shazzam foi iniciada e que as probes de classificação Unix e SNMP falharam. O probe HTTP - Classify e o padrão especificado no registro de classificação HTTP devem ser iniciados.