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¶
- Você informa os alvos, o coletor e o perfil de portas. A API valida os alvos e cria
uma tarefa
discoverpara o coletor escolhido (o mesmo mecanismo do Testar conexão). - 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.
- 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 |