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

# Claroty xDome

Conecte o Claroty xDome, por meio de sua API na nuvem, para importar dispositivos OT, IoT e IIoT descobertos para o Dispel — enriquecidos com achados de vulnerabilidade — mapeados para um Wicket.

## Visão geral

A integração do Claroty xDome permite que o Dispel puxe os ativos de OT, IoT e IIoT que o xDome descobriu e os traga como dispositivos do Dispel, enriquecidos com as descobertas de vulnerabilidades do xDome. Você se conecta ao seu tenant do xDome uma vez, mapeia-o 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.

O Claroty xDome é uma integração de descoberta de ativos na nuvem. O Dispel se autentica na API do xDome com um token da API e só lê dados dela. Como um tenant do xDome representa um único ambiente, o Dispel o trata como um único site que você mapeia para um único Wicket — não há uma lista por site para percorrer.

#### O que o Dispel importa

* Dispositivos que o xDome descobriu, correspondidos aos seus dispositivos existentes do Dispel e importados como novos dispositivos quando não há correspondência.
* As descobertas de vulnerabilidades do xDome (baseadas em CVE, com pontuações CVSS v3) como achados nos dispositivos correspondentes, para que você possa ver os problemas conhecidos de um dispositivo sem sair do Dispel.

{% hint style="info" %}
**Onde encontrar.** Entre como administrador da organização e abra [**Configurações → Integrações**](https://app.dispel.com/settings/integrations). O Claroty xDome aparece na **Descoberta de ativos / Visibilidade de rede** seção. Clique em **Conectar** no cartão Claroty xDome para começar.
{% endhint %}

## Antes de começar

Você precisará do seguinte no xDome:

* Uma **Token da API**. No xDome, vá para **Settings → Admin Settings → User Management**, crie um usuário de API e depois gere um token para ele.
* Seu **host da API do xDome** — por exemplo `https://api.claroty.com` ou `https://eu.api.claroty.com`.

{% hint style="warning" %}
**O token da API é exibido apenas uma vez.** O xDome exibe o token somente quando você o gera. Copie-o nesse momento; se perdê-lo, gere um novo.
{% endhint %}

{% hint style="info" %}
**As permissões do token limitam o que o Dispel vê.** O Dispel importa os ativos que o usuário de API tem permissão para ler, então conceda ao usuário de API acesso aos sites cujos dispositivos você quer no Dispel.
{% endhint %}

## Conectando o Claroty xDome

1. Acesse [**Configurações → Integrações**](https://app.dispel.com/settings/integrations) e clique em **Conectar** no cartão Claroty xDome.
2. Opcionalmente, defina um **Nome de exibição** para diferenciar esta integração das outras (você pode conectar mais de uma instância).
3. Preencha os campos de conexão:

| Campo                                | Tipo         | Observações                                                                                                                |
| ------------------------------------ | ------------ | -------------------------------------------------------------------------------------------------------------------------- |
| **URL da API**                       | Configuração | Seu host da API do xDome específico da região, por exemplo `https://api.claroty.com` ou `https://eu.api.claroty.com`.      |
| **Token da API**                     | Credencial   | O token gerado para um usuário de API no xDome. Armazenado criptografado e nunca mais exibido.                             |
| **Incluir dispositivos desativados** | Configuração | Opcional. Quando ativado, o Dispel também importa dispositivos que o xDome marcou como desativados. Desativado por padrão. |

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

{% hint style="info" %}
**Suas credenciais são criptografadas.** O token da API é criptografado em repouso e nunca mais é exibido depois que você salva. Ao editar mais tarde, deixe o campo do token em branco para manter o valor armazenado.
{% endhint %}

## Mapeando o tenant para um Wicket

Quando a sincronização inicial terminar, abra a integração para encontrar a **Mapeamento de sites** seção. O Claroty xDome aparece como um único site que representa seu tenant.

> Mapeie cada site do fornecedor para uma instalação e um Wicket do Dispel. Os dispositivos dos sites mapeados serão sincronizados no Dispel.

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 importa os dispositivos do xDome para o Wicket mapeado e então informa quantos dispositivos foram importados. Os dispositivos importados aparecem no Wicket mapeado junto com quaisquer dispositivos que você adicionou manualmente, com as descobertas de vulnerabilidades do xDome associadas.

## Mantendo seu inventário atualizado

* O Dispel faz nova sincronização automaticamente em uma agenda recorrente, de modo que dispositivos recém-descobertos, detalhes alterados e novos achados sejam capturados sem nenhuma ação sua.
* Para obter imediatamente o inventário mais recente, abra a integração e escolha **Atualizar**.
* Para alterar os detalhes da conexão ou rotacionar o token, edite a integração e use **Salvar e sincronizar**. Deixe o campo do token em branco para manter o token atual.

As descobertas de vulnerabilidades são atualizadas em cada sincronização, e as descobertas que o xDome não relata mais são removidas automaticamente.

## Status da conexão

Cada integração mostra um status para que você sempre saiba em que pé ela está:

| Status                     | Significado                                                                         |
| -------------------------- | ----------------------------------------------------------------------------------- |
| **Não inicializado**       | Salvo, mas a primeira sincronização ainda não foi executada.                        |
| **Inicializando**          | Executando a primeira sincronização.                                                |
| **Pronto**                 | Conectado e sincronizado; o mapeamento está aplicado.                               |
| **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 o mapeamento salvo.                                    |
| **Falhou**                 | A última operação falhou — consulte as orientações sobre o erro.                    |

Um selo separado **selo de saúde** (Conectado, Degradado, Inacessível) indica se o Dispel consegue alcançar a API do xDome 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 normalmente significa e como corrigir                                                                                                                                           |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Falha na autenticação**     | O token da API foi rejeitado. Confirme se o usuário de API está ativo no xDome e se o token está válido — ele é exibido apenas uma vez, então gere um novo se tiver sido perdido.     |
| **Endpoint inacessível**      | O Dispel não conseguiu alcançar o xDome. Verifique se a URL da API é o host correto específico da sua região (por exemplo `https://api.claroty.com` ou `https://eu.api.claroty.com`). |
| **Tempo de conexão esgotado** | O xDome demorou demais para responder — geralmente um problema de rede transitório; tente novamente.                                                                                  |

## Perguntas frequentes

<details>

<summary>Onde eu crio o token da API?</summary>

No xDome, vá para **Settings → Admin Settings → User Management**, crie um usuário de API e gere um token para ele. O token é exibido apenas uma vez, então copie-o antes de sair da página.

</details>

<details>

<summary>Qual URL da API devo usar?</summary>

Seu host da API do xDome específico da região, por exemplo `https://api.claroty.com` ou `https://eu.api.claroty.com`. Use o host da região em que seu tenant do xDome está em execução.

</details>

<details>

<summary>Quais descobertas o Claroty xDome traz para o Dispel?</summary>

As descobertas de vulnerabilidades do xDome — baseadas em CVE, com pontuações CVSS v3 — anexadas aos dispositivos correspondentes. As descobertas são atualizadas em cada sincronização, e quaisquer itens que o xDome não relata mais são removidos automaticamente.

</details>

<details>

<summary>O Dispel altera algo no xDome?</summary>

Não. A integração é somente leitura. O Dispel obtém o inventário e as descobertas, mas nunca cria, modifica ou exclui dados no xDome.

</details>

<details>

<summary>Posso conectar mais de um tenant do xDome?</summary>

Sim. O Claroty xDome oferece suporte a várias integrações, então você pode conectar vários tenants lado a lado. Dê a cada um um distinto **Nome de exibição** diferente para distingui-los.

</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/claroty-xdome.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.