> 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/darktrace.md).
# Darktrace
Conecte o Darktrace, por meio da API do ActiveAI Security Portal, para importar dispositivos descobertos para o Dispel — enriquecidos com alertas do modelo comportamental e um link profundo para o Threat Visualizer — mapeados para um Wick
## Visão geral
A integração com Darktrace permite que a Dispel puxe os dispositivos que a IA autônoma da Darktrace descobriu na sua rede e os traga como dispositivos da Dispel, enriquecidos com as detecções comportamentais da Darktrace. Você se conecta à sua instância do Darktrace uma vez, associa-a a uma instalação e a um Wicket da Dispel, e a Dispel importa os dispositivos correspondentes e os mantém atualizados em uma sincronização recorrente.
Darktrace é uma integração de descoberta de ativos na nuvem. A Dispel se autentica no ActiveAI Security Portal e lê os dados pela API em nuvem da Darktrace, e apenas lê dela. Você aponta a Dispel para a URL mestre do seu Darktrace; a Dispel deriva o nome da sua instância a partir dela e acessa a API pelo proxy em nuvem da Darktrace.
Como um master da Darktrace representa um único ambiente, a Dispel o trata como um único site que você associa a um único Wicket — não há uma lista por site para percorrer.
#### O que o Dispel importa
* Dispositivos que a Darktrace descobriu, correspondidos aos seus dispositivos existentes da Dispel por endereço IP e MAC e importados como novos dispositivos quando não há correspondência.
* Alertas de Modelo da Darktrace (suas detecções comportamentais) como achados nos dispositivos correspondentes, com severidade derivada da categoria do modelo.
* Uma visualização rica do dispositivo: um selo "Enriquecido pela Darktrace", um link direto para o dispositivo no Darktrace Threat Visualizer e um painel da Darktrace mostrando o status de Resposta Autônoma (Antigena), inteligência do dispositivo, conectividade e uma pontuação de risco comportamental.
{% hint style="info" %}
**Onde encontrar.** Entre como administrador da organização e abra **Configurações → Integrações**. A Darktrace aparece em **Descoberta de ativos / Visibilidade de rede** seção. Clique em **Conectar** no cartão da Darktrace para começar.
{% endhint %}
## Antes de começar
Você precisará do seguinte da Darktrace:
* Um Aplicativo Cliente criado no ActiveAI Security Portal, em **Gerenciar Aplicativos Cliente**. Criá-lo lhe dá um **ID do cliente** e um **Segredo do cliente**.
* A **URL Mestre da Darktrace** da sua instância — por exemplo `https://usw1-00000-01.cloud.darktrace.com`.
{% hint style="warning" %}
**Use as credenciais de aplicativo cliente do ActiveAI — não os tokens legados.** A nuvem da Darktrace requer as credenciais de aplicativo cliente (OAuth2) do ActiveAI Security Portal. O antigo par de token/segredo da API do Threat Visualizer não irá autenticar.
{% endhint %}
{% hint style="info" %}
**O Segredo do Cliente é exibido uma vez.** A Darktrace exibe o segredo somente quando o Aplicativo Cliente é criado. Copie-o nesse momento; se você o perder, crie um novo Aplicativo Cliente.
{% endhint %}
## Conectando a Darktrace
1. Acesse **Configurações → Integrações** e clique em **Conectar** no cartão da Darktrace.
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 Mestre da Darktrace** | Configuração | A URL mestre da sua Darktrace, por exemplo `https://sua-instancia.cloud.darktrace.com`. A Dispel deriva o nome da instância a partir dela. |
| **ID do cliente** | Credencial | O ID do Cliente de um Aplicativo Cliente criado no ActiveAI Security Portal. |
| **Segredo do cliente** | Credencial | O Segredo do Cliente exibido uma vez quando o Aplicativo Cliente é criado. Armazenado de forma criptografada e nunca exibido novamente. |
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" %}
**Como a conexão funciona.** A Dispel troca seu ID do Cliente e Segredo do Cliente por um token de curta duração no servidor de autorização do ActiveAI e chama a API da Darktrace por meio do `api.darktrace.com` proxy em nuvem, usando a instância derivada da sua URL mestre. Os tokens são renovados automaticamente.
{% endhint %}
{% hint style="info" %}
**Suas credenciais são criptografadas.** O Segredo do Cliente é criptografado em repouso e nunca é exibido novamente depois que você salva. Ao editar depois, deixe os campos de credenciais em branco para manter os valores armazenados.
{% endhint %}
## Mapeando a instância para um Wicket
Quando a sincronização inicial terminar, abra a integração para encontrar a **Mapeamento de sites** seção. A Darktrace aparece como um único site representando sua instância.
> 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**.
A Dispel importa os dispositivos da Darktrace para o Wicket mapeado — você verá o progresso passar de aguardando, para buscando, para sincronizando, até concluir — e então informa quantos dispositivos foram importados. Os dispositivos importados aparecem no Wicket mapeado junto com quaisquer dispositivos que você adicionou manualmente, com o enriquecimento da Darktrace e os Alertas de Modelo anexados.
## Mantendo seu inventário atualizado
* A Dispel faz a ressincronização automaticamente em um agendamento recorrente, de modo que dispositivos recém-descobertos, detalhes alterados e novos Alertas de Modelo 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 de conexão ou rotacionar as credenciais, edite a integração e use **Salvar e sincronizar**. Deixe os campos de credenciais em branco para manter o Segredo do Cliente atual.
Os achados de Alertas de Modelo são atualizados a cada sincronização, e alertas que a Darktrace não relata mais são removidos 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) reflete se a Dispel consegue alcançar a API da Darktrace 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 ID do Cliente ou o Segredo do Cliente foi rejeitado. Confirme que o Aplicativo Cliente está ativo no ActiveAI Security Portal e que o segredo está atual — ele é exibido apenas uma vez, então recrie o aplicativo se ele tiver sido perdido. |
| **Endpoint inacessível** | A Dispel não conseguiu alcançar a Darktrace. Verifique se a URL Mestre da Darktrace está correta. |
| **Tempo de conexão esgotado** | A Darktrace demorou demais para responder — geralmente um problema de rede transitório; tente novamente. |
| **Erro de configuração** | A URL mestre parece estar errada. Ela deve ser a URL mestre da sua Darktrace na nuvem (por exemplo `https://sua-instancia.cloud.darktrace.com`); a Dispel deriva o nome da instância a partir dela. |
## Perguntas frequentes
Quais credenciais eu uso — ActiveAI ou os tokens de API legados?
Use as credenciais de aplicativo cliente do ActiveAI Security Portal (um ID do Cliente e Segredo do Cliente criados em **Gerenciar Aplicativos Cliente**). A nuvem da Darktrace requer o fluxo OAuth2 de credenciais do cliente; o antigo par de token/segredo da API do Threat Visualizer não irá autenticar.
O que é a "URL mestre"?
É a URL da sua instância mestre da Darktrace, por exemplo `https://usw1-00000-01.cloud.darktrace.com`. A Dispel deriva o nome da sua instância a partir dela e redireciona as solicitações de API por meio de `api.darktrace.com`, então você só precisa fornecer a URL mestre.
Quais achados a Darktrace traz para a Dispel?
Os Alertas de Modelo da Darktrace — suas detecções comportamentais — anexados aos dispositivos correspondentes como achados, com severidade derivada da categoria do modelo. São detecções comportamentais, não vulnerabilidades baseadas em CVE.
A Dispel aciona ou altera a Resposta Autônoma (Antigena)?
Não. A integração é somente leitura. A Dispel exibe o status da Antigena como parte do enriquecimento do dispositivo, mas nunca aciona, modifica ou limpa ações de Resposta Autônoma na Darktrace.
Posso conectar mais de uma instância da Darktrace?
Sim. A Darktrace oferece suporte a múltiplas integrações, então você pode conectar várias instâncias lado a lado. Dê a cada uma um distinto **Nome de exibição** diferente para distingui-los.
---
# 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/darktrace.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.