> For the complete documentation index, see [llms.txt](https://docs.dispel.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dispel.com/documentation/documentation-pt-br/integre-e-administre/integrations/asset-discovery/nozomi.md).
# Nozomi Networks
Conecte o Nozomi Networks (Vantage ou Guardian) para trazer seu inventário de ativos de OT e IoT para a Dispel, mapear os sites do fornecedor para Wickets e manter os dados dos dispositivos e as descobertas de vulnerabilidades em sincronia.
## Visão geral
A integração da Nozomi Networks permite que o Dispel puxe o inventário de ativos de OT e IoT que a Nozomi descobriu na sua rede e traga esses ativos como dispositivos do Dispel. Você se conecta uma vez, mapeia cada site da Nozomi para uma unidade do Dispel e Wicket, e o Dispel importa os dispositivos correspondentes e os mantém atualizados em sincronizações recorrentes.
A Nozomi é uma **integração de descoberta de ativos** integração. O Dispel lê da Nozomi — ele nunca grava de volta no seu console da Nozomi.
Uma única integração suporta os dois tipos de implantação da Nozomi, selecionados ao se conectar:
* **Vantage** — a plataforma em nuvem da Nozomi, com gerenciamento de riscos centralizado em todos os seus sites.
* **Guardian** — um appliance Nozomi local, com inventário abrangente de ativos e visibilidade de rede para um único ambiente.
#### O que o Dispel importa
* Ativos descobertos (nome, endereço IP, endereço MAC, fabricante/modelo, sistema operacional, firmware) como dispositivos do Dispel.
* Protocolos e portas de rede observados para cada ativo.
* Um link de volta para o ativo no seu console da Nozomi, além da pontuação de risco da Nozomi, armazenado no dispositivo.
* **Descobertas de vulnerabilidades** para cada dispositivo importado, atualizadas a cada sincronização.
{% hint style="info" %}
**Onde encontrar.** Entre como administrador da organização e abra **Configurações → Integrações**. A Nozomi aparece na **Descoberta de ativos / Visibilidade de rede** seção. Clique em **Conectar** no cartão da Nozomi para começar.
{% endhint %}
## Antes de começar
Você precisará do seguinte no seu console da Nozomi:
* Uma **chave de API** — seu **Nome da Chave** (o identificador) e **Token da Chave** (o segredo). Gere isso no seu console da Nozomi.
* O **URL da API** da sua implantação:
* Para o Vantage, a URL do seu tenant — por exemplo `https://customer.vantage.nozominetworks.io`.
* Para o Guardian, a URL do seu appliance.
{% hint style="warning" %}
**Adicione o IP do Dispel à allowlist.** Ao abrir o formulário de conexão, o Dispel mostra um **IP da whitelist** valor. Adicione este endereço à lista de permissões da sua Nozomi (ou do firewall de rede) para que o Dispel consiga acessar a API — isso é especialmente importante para appliances Guardian locais.
{% endhint %}
## Conectando a Nozomi
1. Vá para **Configurações → Integrações** e clique em **Conectar** no cartão da Nozomi.
2. Opcionalmente, defina um **Nome de exibição** para diferenciar esta integração das outras (você pode conectar mais de uma Nozomi).
3. Escolha a **Tipo de API da Nozomi** — **API do Vantage** ou **API do Guardian**.
4. Preencha os campos de conexão:
| Campo | Tipo | Observações |
| ------------------ | ---------- | ------------------------------------------------------------------------------- |
| **URL da API** | Config | A URL do seu tenant no Vantage ou a URL do appliance Guardian. |
| **Nome da Chave** | Credencial | O identificador da chave de API do seu console da Nozomi. |
| **Token da Chave** | Credencial | O token secreto da chave de API. Armazenado criptografado e nunca mais exibido. |
5. Clique em **Testar conexão** para confirmar que o Dispel pode se autenticar na Nozomi. Corrija qualquer erro relatado antes de salvar.
6. Clique em **Salvar**. O Dispel salva a integração e executa imediatamente a sincronização inicial para descobrir seus sites da Nozomi.
{% hint style="info" %}
**Suas credenciais são criptografadas.** O Key Token (e qualquer outro segredo) é criptografado em repouso e nunca mais é exibido depois que você salva. Ao editar mais tarde, deixe os campos de credenciais em branco para manter os valores armazenados.
{% endhint %}
## Mapeando sites para Wickets
Quando a sincronização inicial terminar, abra a integração para encontrar a **Mapeamento de site** seção. É aqui que você decide quais sites da Nozomi se tornam dispositivos do Dispel e onde eles serão alocados.
> Mapeie cada site do fornecedor para uma instalação e um wicket do Dispel. Os dispositivos dos sites mapeados serão sincronizados no Dispel.
Para cada site que você deseja importar:
1. Escolha uma **Instalação**.
2. Escolha uma **Wicket**. Se a instalação tiver apenas um Wicket, o Dispel o seleciona para você.
3. *(Opcional)* Restrinja a importação a zonas específicas **Zonas**. A Nozomi marca os ativos com zonas nativas; use o seletor Zonas para importar apenas os ativos nas zonas que você escolher. Deixe em branco para importar todos os ativos do site.
4. Clique em **Salvar mapeamentos e importar**.
O Dispel processa cada site mapeado — você verá o progresso de cada site passar de aguardando, para buscando, para sincronizando, até concluir — e então informa quantos dispositivos foram importados (por exemplo, **"12 dispositivos importados"** ou uma discriminação entre dispositivos novos e já importados). Os dispositivos importados aparecem no Wicket mapeado junto com quaisquer dispositivos que você adicionou manualmente.
## Mantendo seu inventário atualizado
* O Dispel **ressincroniza automaticamente** em um cronograma recorrente, para que os ativos descobertos recentemente e os detalhes alterados sejam capturados sem nenhuma ação da sua parte.
* Para obter o inventário mais recente imediatamente, abra a integração e escolha **Atualizar**.
* Para alterar os detalhes da conexão ou renovar credenciais, edite a integração e use **Salvar e sincronizar**. Deixe os campos de credenciais em branco para manter o segredo atual.
## Descobertas de vulnerabilidades
A Nozomi relata vulnerabilidades conhecidas para os ativos que monitora. Após cada sincronização bem-sucedida, o Dispel puxa os achados de vulnerabilidades dos seus dispositivos importados e os anexa a esses dispositivos, para que você possa ver os problemas conhecidos de um dispositivo sem sair do Dispel. Os achados são atualizados a cada sincronização, e os achados resolvidos desaparecem automaticamente.
## Status da conexão
Cada integração mostra um status para que você sempre saiba em que situação ela está:
| Status | Significado |
| -------------------------- | ----------------------------------------------------------------------------------- |
| **Não inicializado** | Salvo, mas a primeira sincronização ainda não foi executada. |
| **Inicializando** | Executando a primeira sincronização e descobrindo sites. |
| **Pronto** | Conectado e sincronizado; os mapeamentos são aplicados. |
| **Precisa de atualização** | Novos dados do fornecedor estão disponíveis; execute uma atualização para obtê-los. |
| **Atualizando** | Uma sincronização está em andamento. |
| **Alterações pendentes** | As alterações de mapeamento foram salvas, mas ainda não foram aplicadas. |
| **Aplicando** | Importando dispositivos para seus mapeamentos salvos. |
| **Falhou** | A última operação falhou — consulte a orientação do erro. |
Um **indicador de integridade** (Conectado, Degradado, Inalcançável) indica se o Dispel consegue acessar a API da Nozomi no momento.
## Solução de problemas
Se uma sincronização ou teste de conexão falhar, o Dispel classifica o erro e sugere uma correção:
| Erro | O que geralmente significa e como corrigir |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Falha na autenticação** | O Nome/Token da Chave foi rejeitado. A chave pode ter sido rotacionada, expirada ou revogada — gere uma nova e atualize a integração. |
| **Endpoint inacessível** | O Dispel não conseguiu acessar a API. Verifique a URL da API e se o IP do Dispel está na lista de permissões do seu firewall. |
| **Tempo de conexão esgotado** | O appliance demorou demais para responder — geralmente por latência de rede ou regra de firewall. Comum no Guardian local. |
| **Limitado pela taxa** | A Nozomi limitou as solicitações. A próxima sincronização agendada deverá ter sucesso. |
| **Erro de configuração** | A URL da API ou o tipo de API parece estar incorreto (por exemplo, uma URL do Guardian com o tipo Vantage selecionado). Verifique novamente as configurações da conexão. |
## Perguntas frequentes
Posso conectar mais de uma implantação da Nozomi?
Sim. A Nozomi suporta várias integrações, então você pode conectar vários appliances Guardian e/ou um tenant Vantage lado a lado. Dê a cada um um identificador distinto **Nome de exibição** nome distinto para diferenciá-los.
Conectar a Nozomi muda algo no meu console da Nozomi?
Não. O Dispel apenas lê da Nozomi. Ele nunca cria, modifica ou exclui dados no lado da Nozomi.
O que acontece com os dispositivos importados se eu remover um mapeamento de site?
Dispositivos que não estão mais cobertos por um mapeamento ativo deixam de ser atualizados nas sincronizações subsequentes. Remover um mapeamento afeta apenas sincronizações futuras — não exclui o histórico retroativamente.
Por que não vejo a opção Zonas?
A filtragem por zona é específica da Nozomi. O seletor Zonas só aparece para sites cujos ativos têm tags de zona da Nozomi. Se um site não tiver zonas, todos os seus ativos são importados.
Com que rapidez novos ativos aparecem?
Novos ativos aparecem na próxima sincronização — automaticamente no cronograma recorrente, ou imediatamente se você escolher **Atualizar**.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.dispel.com/documentation/documentation-pt-br/integre-e-administre/integrations/asset-discovery/nozomi.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.