> 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-zh/ji-cheng-yu-guan-li/integrations/asset-discovery/darktrace.md).

# Darktrace

通过 ActiveAI Security Portal API 连接 Darktrace，将已发现的设备拉入 Dispel——补充行为模型告警并提供 Threat Visualizer 的深层链接——映射到一个 Wick

## 概览

Darktrace 集成使 Dispel 能拉取 Darktrace 的自学习 AI 在你的网络中发现的设备，并将它们作为 Dispel 设备引入，同时附带 Darktrace 的行为检测信息。你只需一次连接到你的 Darktrace 实例，将其映射到一个 Dispel 设施和 Wicket，Dispel 就会导入匹配的设备，并在定期同步中保持它们为最新。

Darktrace 是一种云资产发现集成。Dispel 会对 ActiveAI Security Portal 进行身份验证，并通过 Darktrace 的云 API 读取数据，而且只会读取。你将 Dispel 指向你的 Darktrace master URL；Dispel 会据此推导出你的实例名称，并通过 Darktrace 的云代理访问 API。

由于 Darktrace master 代表单一环境，Dispel 将其视为一个站点，你只需将其映射到一个 Wicket——无需逐个处理站点列表。

#### Dispel 导入的内容

* Darktrace 已发现的设备，会按 IP 和 MAC 地址与你现有的 Dispel 设备匹配；未匹配到的则作为新设备导入。
* Darktrace Model Alerts（其行为检测）会作为发现附加到匹配的设备上，严重性则根据模型类别确定。
* 一个丰富的设备视图：带有“由 Darktrace 增强”徽标、指向 Darktrace Threat Visualizer 中该设备的深层链接，以及一个 Darktrace 面板，显示 Autonomous Response（Antigena）状态、设备情报、连通性和行为风险评分。

{% hint style="info" %}
**在哪里找到它。** 以组织管理员身份登录并打开 **设置 → 集成**。Darktrace 出现在 **资产发现 / 网络可视性** 部分。点击 **连接** 在 Darktrace 卡片上开始。
{% endhint %}

## 开始前准备

你需要从 Darktrace 获取以下内容：

* 在 ActiveAI Security Portal 中创建的一个 Client Application，位于 **管理 Client Applications**。创建后你会获得一个 **客户端 ID** 和一个 **客户端密钥**.
* 该 **Darktrace Master URL** ，对应你的实例——例如 `https://usw1-00000-01.cloud.darktrace.com`.

{% hint style="warning" %}
**请使用 ActiveAI 客户端应用程序凭据——不要使用旧版令牌。** Darktrace 云需要 ActiveAI Security Portal 的客户端应用程序（OAuth2）凭据。较旧的 Threat-Visualizer API 令牌/密钥对无法通过身份验证。
{% endhint %}

{% hint style="info" %}
**Client Secret 只显示一次。** Darktrace 仅在创建 Client Application 时显示该密钥。请当时复制下来；如果丢失了，就创建一个新的 Client Application。
{% endhint %}

## 连接 Darktrace

1. 前往 **设置 → 集成** 并点击 **连接** 在 Darktrace 卡片上。
2. 可选地设置一个 **显示名称** 用于将此集成与其他集成区分开来（你可以连接多个实例）。
3. 填写连接字段：

| 字段                       | 类型 | 备注                                                                                        |
| ------------------------ | -- | ----------------------------------------------------------------------------------------- |
| **Darktrace Master URL** | 配置 | 你的 Darktrace master URL，例如 `https://your-instance.cloud.darktrace.com`。Dispel 会据此推导出实例名称。 |
| **客户端 ID**               | 凭据 | 在 ActiveAI Security Portal 中创建的 Client Application 的 Client ID。                           |
| **客户端密钥**                | 凭据 | Client Application 创建时只显示一次的 Client Secret。以加密方式存储，之后永不再显示。                               |

4. 点击 **测试连接** 以确认 Dispel 能够通过身份验证。保存前请修复任何报告的错误。
5. 点击 **保存**。Dispel 会保存该集成并立即运行初始同步。

{% hint style="info" %}
**连接如何工作。** Dispel 会在 ActiveAI 授权服务器上将你的 Client ID 和 Client Secret 交换为一个短期令牌，并通过 `api.darktrace.com` 云代理调用 Darktrace API，使用从你的 master URL 推导出的实例。令牌会自动刷新。
{% endhint %}

{% hint style="info" %}
**你的凭据已加密。** Client Secret 在静态存储时会加密，保存后不会再次显示。以后编辑时，请将凭据字段留空以保留已存储的值。
{% endhint %}

## 将实例映射到一个 Wicket

初始同步完成后，打开该集成以找到 **站点映射** 部分。Darktrace 会作为代表你的实例的单个站点出现。

> 将每个供应商站点映射到一个 Dispel 设施和 Wicket。来自已映射站点的设备将同步到 Dispel 中。

1. 选择一个 **设施**.
2. 选择一个 **wicket**。如果该设施只有一个 Wicket，Dispel 会自动为你选中它。
3. 点击 **保存映射并导入**.

Dispel 会将 Darktrace 的设备导入到映射的 Wicket 中——你会看到进度从等待、获取、同步到完成——然后它会报告已导入的设备数量。导入的设备会与任何你手动添加的设备一起显示在映射的 Wicket 中，并附带其 Darktrace 增强信息和 Model Alerts。

## 保持你的资产清单最新

* Dispel 会按周期自动重新同步，因此新发现的设备、变更的详细信息以及新的 Model Alerts 都会在无需你任何操作的情况下被获取。
* 如需立即拉取最新资产清单，请打开该集成并选择 **刷新**.
* 如需更改连接详情或轮换凭据，请编辑该集成并使用 **保存并同步**。将凭据字段留空即可保留当前的 Client Secret。

Model Alert 发现会在每次同步时刷新，而 Darktrace 不再报告的告警会自动消失。

## 连接状态

每个集成都会显示一个状态，让你始终知道当前进展：

| 状态        | 含义                   |
| --------- | -------------------- |
| **未初始化**  | 已保存，但首次同步尚未运行。       |
| **初始化中**  | 正在运行首次同步。            |
| **就绪**    | 已连接并同步；映射已应用。        |
| **需要刷新**  | 有新的供应商数据可用；运行刷新以拉取它。 |
| **刷新中**   | 同步正在进行中。             |
| **待处理更改** | 映射更改已保存，但尚未应用。       |
| **应用中**   | 正在按你保存的映射导入设备。       |
| **失败**    | 上一次操作失败——请参见错误提示。    |

单独的 **健康状态徽章** （已连接、已降级、不可达）反映了 Dispel 当前是否能够访问 Darktrace API。

## 故障排除

如果同步或测试连接失败，Dispel 会对错误进行分类并建议修复方法：

| 错误         | 通常表示什么以及如何修复                                                                                                                  |
| ---------- | ----------------------------------------------------------------------------------------------------------------------------- |
| **身份验证失败** | Client ID 或 Client Secret 被拒绝。请确认该 Client Application 在 ActiveAI Security Portal 中处于激活状态，并且密钥是最新的——它只显示一次，所以如果丢失了，请重新创建该应用程序。 |
| **端点不可达**  | Dispel 无法连接到 Darktrace。请验证 Darktrace Master URL 是否正确。                                                                         |
| **连接超时**   | Darktrace 响应超时——通常是暂时的网络问题；请重试。                                                                                               |
| **配置错误**   | master URL 看起来不正确。它必须是你的 Darktrace 云 master URL（例如 `https://your-instance.cloud.darktrace.com`）；Dispel 会据此推导出实例名称。            |

## 常见问题

<details>

<summary>我应该使用哪种凭据——ActiveAI 还是旧版 API 令牌？</summary>

请使用 ActiveAI Security Portal 的客户端应用程序凭据（即在以下位置创建的 Client ID 和 Client Secret： **管理 Client Applications**）。Darktrace 云需要 OAuth2 客户端凭据流程；旧版 Threat-Visualizer API 令牌/密钥对无法通过身份验证。

</details>

<details>

<summary>什么是“master URL”？</summary>

它是你的 Darktrace master 实例的 URL，例如 `https://usw1-00000-01.cloud.darktrace.com`。Dispel 会据此推导出你的实例名称，并通过以下地址代理 API 请求： `api.darktrace.com`，因此你只需提供 master URL。

</details>

<details>

<summary>Darktrace 会将哪些发现带入 Dispel？</summary>

Darktrace 的 Model Alerts——其行为检测——会作为发现附加到匹配的设备上，严重性依据模型类别确定。这些是基于行为的检测，而不是基于 CVE 的漏洞。

</details>

<details>

<summary>Dispel 会触发或更改 Autonomous Response（Antigena）吗？</summary>

不会。此集成是只读的。Dispel 会将 Antigena 状态作为设备增强信息的一部分显示，但绝不会在 Darktrace 中触发、修改或清除 Autonomous Response 操作。

</details>

<details>

<summary>我可以连接多个 Darktrace 实例吗？</summary>

可以。Darktrace 支持多个集成，因此你可以并排连接多个实例。为每个实例指定一个独特的 **显示名称** 以便区分它们。

</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-zh/ji-cheng-yu-guan-li/integrations/asset-discovery/darktrace.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.