> 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/dragos.md).

# Dragos

Conecte a plataforma Dragos (SiteStore) para trazer ativos de OT descobertos para a Dispel, mapear sensores Dragos para Wickets e manter os dados dos dispositivos e as descobertas de vulnerabilidades em sincronia.

## Visão geral

A integração com o Dragos permite ao Dispel puxar os ativos de OT que a Plataforma Dragos descobriu e trazê-los como dispositivos do Dispel. Você se conecta ao seu Dragos **SiteStore** uma vez, mapeie cada sensor do Dragos para uma instalação e um Wicket do Dispel, e o Dispel importa os dispositivos correspondentes e os mantém atualizados em uma sincronização recorrente.

Dragos é uma **integração de descoberta de ativos** integração. O Dispel lê do Dragos — ele nunca escreve de volta na plataforma.

No Dragos, **sensores** são os pontos de coleta que monitoram sua rede industrial. O Dispel trata cada sensor do Dragos como um **site** que você mapeia para um Wicket do Dispel, para que os ativos caiam no lugar certo por sensor.

#### O que o Dispel importa

* Ativos descobertos (nome, endereço IP, endereço MAC, fabricante/modelo, sistema operacional, tipo de dispositivo) como dispositivos do Dispel.
* Protocolos e portas de rede observados para cada ativo.
* Um link de volta ao ativo no Dragos, armazenado no dispositivo.
* **Descobertas de vulnerabilidades** para cada dispositivo importado — abrangendo tanto problemas de hardware/firmware quanto de software/sistema operacional — atualizado em cada sincronização.

{% hint style="info" %}
**Onde encontrar.** Entre como administrador da organização e abra **Configurações → Integrações**. O Dragos aparece em **Descoberta de ativos / Visibilidade de rede** seção. Clique em **Conectar** no cartão do Dragos para começar.
{% endhint %}

## Antes de começar

Você precisará do seguinte do seu SiteStore do Dragos:

* Uma **chave de API** — seu **ID da chave de API** (o identificador) e **Segredo da chave de API**. Provisione isso no SiteStore.
* O **URL do SiteStore** da sua implantação — por exemplo `https://customer.dragos.cloud`.

{% hint style="warning" %}
**O segredo da chave de API é exibido apenas uma vez.** O Dragos exibe o segredo uma única vez quando você provisiona a chave. Copie-o nesse momento — se você o perder, provisione uma nova chave. Adicione também o IP do Dispel **IP da whitelist** (mostrado no formulário de conexão) à sua lista de permissões do firewall para que o Dispel possa alcançar o SiteStore, especialmente em implantações on-premises.
{% endhint %}

## Conectando o Dragos

1. Vá para **Configurações → Integrações** e clique em **Conectar** no cartão do Dragos.
2. Opcionalmente, defina um **Nome de exibição** para distinguir esta integração das outras (você pode conectar mais de um SiteStore).
3. Preencha os campos de conexão:

| Campo                       | Tipo       | Observações                                                                               |
| --------------------------- | ---------- | ----------------------------------------------------------------------------------------- |
| **URL do SiteStore**        | Config     | A URL base da sua instância do SiteStore do Dragos.                                       |
| **ID da chave de API**      | Credencial | O identificador da chave de API do seu SiteStore do Dragos.                               |
| **Segredo da chave de API** | Credencial | O segredo associado à chave. Armazenado de forma criptografada e nunca exibido novamente. |

4. Clique em **Testar conexão** para confirmar que o Dispel consegue se autenticar no SiteStore. Corrija qualquer erro relatado antes de salvar.
5. Clique em **Salvar**. O Dispel salva a integração e executa imediatamente a sincronização inicial para descobrir seus sensores.

{% hint style="info" %}
**Suas credenciais são criptografadas.** O segredo da chave de API é criptografado em repouso e nunca é exibido novamente depois que você salva. Ao editar mais tarde, deixe os campos de credenciais em branco para manter os valores armazenados.
{% endhint %}

## Mapeando sensores para Wickets

Quando a sincronização inicial terminar, abra a integração para encontrar a **Mapeamento de site** seção. Cada sensor do Dragos aparece como um site, e é aqui que você decide quais sensores 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 sensor 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. Clique em **Salvar mapeamentos e importar**.

O Dispel processa cada sensor mapeado — você verá o progresso por site avançar de aguardando, para buscando, para sincronizando, para concluído — 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

O Dragos relata vulnerabilidades conhecidas para os ativos que monitora. Após cada sincronização bem-sucedida, o Dispel busca os achados de vulnerabilidade para seus dispositivos importados — cobrindo tanto problemas de hardware/firmware quanto de software/sistema operacional — 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 sensores.                         |
| **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, Inacessível) reflete se o Dispel consegue alcançar atualmente a API do Dragos.

## 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 ID/Segredo da chave de API foi rejeitado. A chave pode ter sido rotacionada, expirado ou revogada — provisione uma nova e atualize a integração. |
| **Endpoint inacessível**      | O Dispel não conseguiu alcançar o SiteStore. Verifique a URL do SiteStore e se o IP do Dispel está na lista de permissões do seu firewall.         |
| **Tempo de conexão esgotado** | O SiteStore demorou demais para responder — muitas vezes devido à latência da rede ou a uma regra de firewall.                                     |
| **Limitado pela taxa**        | O Dragos limitou as solicitações. A próxima sincronização agendada deverá funcionar.                                                               |
| **Erro de configuração**      | A URL do SiteStore parece incorreta. Verifique novamente as configurações de conexão.                                                              |

## Perguntas frequentes

<details>

<summary>Posso conectar mais de um SiteStore do Dragos?</summary>

Sim. O Dragos oferece suporte a várias integrações, então você pode conectar várias instâncias do SiteStore lado a lado. Dê a cada uma uma **Nome de exibição** nome distinto para diferenciá-los.

</details>

<details>

<summary>O que é um "site" no Dragos?</summary>

O Dispel mapeia os **sensores** para sites. Cada sensor que monitora sua rede aparece na lista de mapeamento de sites, para que você possa direcionar ativos de diferentes sensores para diferentes instalações e Wickets.

</details>

<details>

<summary>Perdi o segredo da minha chave de API. O que eu faço?</summary>

O Dragos mostra o segredo apenas uma vez no momento do provisionamento. Se você não o tiver mais, provisione uma nova chave de API no SiteStore e atualize a integração com o novo ID e segredo.

</details>

<details>

<summary>Conectar o Dragos muda alguma coisa no SiteStore?</summary>

Não. O Dispel apenas lê do Dragos. Ele nunca cria, modifica ou exclui dados do lado do Dragos.

</details>


---

# 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/dragos.md?ask=<question>&goal=<user_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.