Pular para conteúdo

Descoberta de rede

A Descoberta de rede (Administração › Descoberta de rede) varre faixas de IP a partir de um coletor e aponta equipamentos gerenciáveis — arrays de storage, switches SAN, gerenciadores de virtualização e NAS/objeto — que ainda não estão cadastrados na plataforma. Para cada um, o botão Adicionar abre o assistente de dispositivo já preenchido (plugin, endereço, nome, porta e coletor). Permissão: devices.manage global (papéis restritos a um tenant não podem varrer a rede) ou superadministrador.

Varra somente redes que você está autorizado a varrer

A descoberta abre conexões TCP em muitos endereços. Mesmo sendo limitada em taxa e somente leitura, ela pode disparar alertas em IDS/IPS e firewalls. Combine a janela com a equipe de rede/segurança e restrinja os alvos às sub-redes de gerenciamento dos equipamentos.

Como funciona

  1. Você informa os alvos, o coletor e o perfil de portas. A API valida os alvos e cria uma tarefa discover para o coletor escolhido (o mesmo mecanismo do Testar conexão).
  2. O coletor executa a varredura — ele é o ponto de vista de rede correto, já que fica perto dos equipamentos (coletor local ou remoto). O andamento aparece na tela a cada poucos segundos.
  3. Ao terminar, o coletor devolve um resumo e a lista de hosts que responderam. A plataforma marca os que já são gerenciados comparando IP, nome DNS, DNS reverso e o CN/SAN do certificado com os endereços dos dispositivos cadastrados.

O que o coletor faz em cada host

Tudo sem credenciais e somente leitura:

Sonda Para quê
Conexão TCP nas portas do perfil descobrir portas abertas (a conexão é fechada em seguida)
Handshake TLS ler o certificado (CN, SAN, emissor)
GET sem autenticação em / e em caminhos públicos dos fabricantes título da página, cabeçalho Server, respostas como /sdk/vimServiceVersions.xml (vCenter/ESXi), /api/api_version (Pure), /ConfigurationManager/configuration/version (Hitachi)
Leitura do banner SSH identificar o serviço SSH (nada é enviado)
DNS reverso sugerir o nome do dispositivo

Nunca há tentativa de login, POST, envio de credenciais nem acompanhamento de redirecionamentos para outros hosts.

Alvos

Um por linha (também aceita vírgulas e espaços; # inicia comentário):

Formato Exemplo
CIDR 10.20.0.0/24 (rede e broadcast são ignorados)
Faixa completa 10.20.0.10-10.20.1.20
Faixa no último octeto 10.20.0.10-80
IP avulso 10.20.0.15
Nome DNS array01.corp.local (resolvido pelo coletor)

Limites e recusas:

  • no máximo 4096 hosts por descoberta (e 256 linhas); divida faixas maiores em jobs separados;
  • são recusados loopback, link-local (inclui 169.254.169.254), multicast, faixas reservadas e os nomes dos serviços internos da plataforma (postgres, api, quantix-api-1…). Um nome DNS que resolve para um desses endereços é ignorado;
  • uma descoberta por coletor de cada vez; o coletor precisa estar online.

Perfis de portas

Perfil Portas TCP
Rápido 22, 443, 8443, 9440
Padrão 22, 80, 443, 5989, 7443, 8080, 8088, 8443, 8452, 9440
Completo Padrão + 902, 5480, 5988, 8008
Personalizado até 32 portas informadas

Limites de impacto

Limite Valor
Taxa de conexões 200/s por padrão (ajustável de 10 a 1000/s no formulário)
Hosts em paralelo 64
Timeout por sonda 3 s
Tempo máximo por host 45 s
Duração máxima da descoberta 30 min (o que foi verificado até ali é devolvido)
Hosts no resultado 2000 (identificados primeiro; o resumo indica resultado truncado)

Resultado

Cada host traz IP, DNS reverso, portas abertas, certificado, título/servidor HTTP e as correspondências com os plugins, com confiança (0–100 %) e as evidências (passe o mouse sobre a identificação). Estados:

  • Identificado — confiança ≥ 60 %;
  • Possível — entre 35 % e 60 % (confira antes de cadastrar);
  • Desconhecido — respondeu, mas não corresponde a nenhum plugin (servidores, BMCs, outros equipamentos).

Filtros: Não gerenciados (identificados/possíveis ainda não cadastrados), Já gerenciados, Desconhecidos e Todos.

Adicionar abre o assistente de dispositivo com plugin, endereço (nome DNS quando houver), nome sugerido, porta (quando o equipamento responde fora da porta padrão do plugin, ex.: WSAPI do Alletra na 443) e o coletor que fez a descoberta. Escolha a credencial, teste a conexão e salve. Para hosts desconhecidos o assistente começa na escolha da plataforma, com nome e endereço já preenchidos.

Plataformas reconhecidas: VMware vSphere (vCenter/ESXi), Nutanix Prism, Dell Unity, PowerMax, PowerStore e PowerScale, Pure FlashArray e FlashBlade, NetApp ONTAP, Huawei OceanStor, IBM Storage Virtualize e DS8000, Hitachi VSP, HPE 3PAR/Primera/Alletra, Infinidat InfiniBox, Brocade FOS e Cisco MDS.

A identificação é heurística

As impressões digitais usam páginas e endpoints públicos que variam entre versões de firmware e podem ser alterados (páginas de login personalizadas, proxies reversos, GUI desativada). Um equipamento pode aparecer como Possível ou Desconhecido; o Testar conexão do assistente é a confirmação definitiva. Equipamentos gerenciados só por SSH (ex.: Storage Virtualize) tendem a ter confiança menor.

Cancelar, histórico e auditoria

  • Cancelar interrompe a varredura no coletor no próximo reporte de andamento (até ~5 s); o que já foi encontrado é mantido.
  • Se o coletor não buscar a tarefa em 10 min, ou parar de reportar andamento por 15 min (reiniciado, sem conexão), a descoberta é marcada como Falhou.
  • As 50 descobertas mais recentes ficam listadas; exclua as que não precisar mais.
  • Início, cancelamento e exclusão ficam na Auditoria (discovery_started, discovery_cancelled, discovery_deleted), com usuário, coletor, alvos e portas.

API

Método e rota Descrição
GET /api/v1/discovery/profiles perfis de portas, limite de hosts e plataformas reconhecidas
GET /api/v1/discovery/jobs descobertas recentes (sem a lista de hosts)
POST /api/v1/discovery/jobs inicia: {collector_id, targets[], profile, ports?, rate, concurrency}
GET /api/v1/discovery/jobs/{id} andamento, resumo e hosts (com managed)
POST /api/v1/discovery/jobs/{id}/cancel cancela
DELETE /api/v1/discovery/jobs/{id} exclui uma descoberta encerrada
GET /api/v1/discovery/jobs/{id}/prefill?ip=&plugin= dados para o assistente de dispositivo