> 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-ja/shisuru-2/integrations/asset-discovery/darktrace.md). # Darktrace Darktrace を、ActiveAI Security Portal API 経由で接続し、検出されたデバイスを Dispel に取り込み—行動 Model Alerts で強化され、Threat Visualizer へのディープリンク付きで—Wick ## 概要 Darktrace インテグレーションにより、Dispel はネットワーク上で Darktrace の自己学習 AI が検出したデバイスを取り込み、Darktrace の行動検知で強化された Dispel デバイスとして登録できます。Darktrace インスタンスには一度接続し、Dispel facility と Wicket にマッピングすると、Dispel が一致するデバイスをインポートし、定期同期で最新状態に保ちます。 Darktrace はクラウド資産ディスカバリー連携です。Dispel は ActiveAI Security Portal に認証し、Darktrace のクラウド API を読み取り、読み取り専用でのみアクセスします。Dispel に Darktrace の master URL を指定すると、Dispel はそこからインスタンス名を導出し、Darktrace のクラウドプロキシ経由で API に到達します。 Darktrace master は 1 つの環境を表すため、Dispel ではそれを 1 つの site として扱い、単一の Wicket にマッピングします。site ごとの一覧を順に処理する必要はありません。 #### Dispelが取り込む内容 * Darktrace が検出したデバイスは、IP アドレスと MAC アドレスで既存の Dispel デバイスと照合され、一致しない場合は新しいデバイスとしてインポートされます。 * Darktrace Model Alerts（その行動検知）が一致するデバイス上の検出結果として表示され、重大度はモデルのカテゴリに基づいて決まります。 * 充実したデバイス表示: 「Enriched by Darktrace」バッジ、Darktrace Threat Visualizer の該当デバイスへのディープリンク、そして Autonomous Response (Antigena) のステータス、デバイスインテリジェンス、接続性、行動リスクスコアを表示する Darktrace パネル。 {% hint style="info" %} **場所** 組織管理者としてサインインし、 **設定 → 連携**。Darktrace は **アセットディスカバリー / ネットワーク可視化** セクションに表示されます。 **接続** 開始するには、Darktrace カードで。 {% endhint %} ## 開始前に Darktrace から次の情報が必要です: * ActiveAI Security Portal の下に作成された Client Application、 **Client Application の管理**。これを作成すると、 **Client ID** および **Client Secret**. * アプライアンスの **Darktrace Master URL** インスタンスの — たとえば `https://usw1-00000-01.cloud.darktrace.com`. {% hint style="warning" %} **ActiveAI の client-application 資格情報を使用してください — 旧式のトークンではありません。** Darktrace のクラウドでは ActiveAI Security Portal の client-application（OAuth2）資格情報が必要です。旧式の Threat-Visualizer API token/secret の組み合わせでは認証できません。 {% endhint %} {% hint style="info" %} **Client Secret は一度だけ表示されます。** Darktrace は Client Application 作成時にのみ secret を表示します。その時点でコピーしてください。失くした場合は、新しい Client Application を作成してください。 {% endhint %} ## Darktrace の接続 1. 次へ移動 **設定 → 連携** をクリックします **接続** Darktrace カード上で。 2. 必要に応じて次を設定します **表示名** このインテグレーションを他のものと区別するための名前です（複数のインスタンスを接続できます）。 3. 接続フィールドを入力します: | フィールド | 種類 | 注記 | | ------------------------ | ---- | -------------------------------------------------------------------------------------------------- | | **Darktrace Master URL** | 設定 | Darktrace の master URL、たとえば `https://your-instance.cloud.darktrace.com`。Dispel はそこからインスタンス名を導出します。 | | **Client ID** | 認証情報 | ActiveAI Security Portal で作成した Client Application の Client ID。 | | **Client Secret** | 認証情報 | Client Application 作成時に一度だけ表示される Client Secret。暗号化して保存され、再表示されることはありません。 | 4. クリック **接続テスト** Dispel が認証できることを確認するためです。保存する前に、表示されたエラーを解消してください。 5. クリック **保存**。Dispelが連携を保存し、初期同期を直ちに実行します。 {% hint style="info" %} **接続の仕組み。** Dispel は ActiveAI 認可サーバーで Client ID と Client Secret を短命トークンに交換し、Darktrace API を次の経由で呼び出します `api.darktrace.com` クラウドプロキシ経由で、master URL から導出したインスタンスを使用します。トークンは自動的に更新されます。 {% endhint %} {% hint style="info" %} **認証情報は暗号化されています。** Client Secret は保存時に暗号化され、保存後に再表示されることはありません。後で編集する場合は、認証情報欄を空欄のままにしてください。 {% endhint %} ## インスタンスを Wicket にマッピングする 初期同期が完了したら、連携を開いて次を見つけます **サイトマッピング** セクション。Darktrace はインスタンスを表す 1 つの site として表示されます。 > 各ベンダーサイトを Dispel のファシリティと Wicket にマッピングします。マッピングされたサイトのデバイスは Dispel に同期されます。 1. 次を選択します **ファシリティ**. 2. 次を選択します **ウィケット**。ファシリティに Wicket が 1 つしかない場合、Dispel が自動で選択します。 3. クリック **マッピングを保存してインポート**. Dispel は Darktrace のデバイスをマッピング先の Wicket にインポートします — 進行状況は待機中から取得中、同期中、完了へと進み — その後、インポートされたデバイス数を報告します。インポートされたデバイスは、手動で追加したデバイスと並んでマッピング先の Wicket に表示され、Darktrace による拡張情報と Model Alerts が付与されます。 ## 在庫情報を最新に保つ * Dispel は定期スケジュールで自動的に再同期するため、新たに検出されたデバイス、変更された詳細、新しい Model Alerts は、ユーザー側の操作なしで取り込まれます。 * 最新の在庫情報をすぐに取得するには、連携を開いて次を選択します **更新**. * 接続詳細を変更したり資格情報をローテーションしたりするには、連携を編集して次を使用します: **保存して同期**。現在の Client Secret を保持するには、認証情報欄を空欄のままにしてください。 Model Alert の検出結果は同期のたびに更新され、Darktrace が報告しなくなったアラートは自動的に消えます。 ## 接続ステータス 各連携にはステータスが表示され、現在の状態を常に把握できます: | ステータス | 意味 | | --------- | --------------------------------- | | **未初期化** | 保存済みですが、最初の同期はまだ実行されていません。 | | **初期化中** | 最初の同期を実行中です。 | | **準備完了** | 接続・同期済み。マッピングが適用されています。 | | **更新が必要** | 新しいベンダーデータがあります。更新を実行して取り込みます。 | | **更新中** | 同期が進行中です。 | | **変更待ち** | マッピング変更は保存されていますが、まだ適用されていません。 | | **適用中** | 保存済みマッピングに基づいてデバイスをインポートしています。 | | **失敗** | 直前の操作に失敗しました — エラーガイダンスを参照してください。 | 別個の **ヘルスバッジ** （Connected、Degraded、Unreachable）は、Dispel が現在 Darktrace API に到達できるかどうかを示します。 ## トラブルシューティング 同期または接続テストが失敗した場合、Dispelがエラーを分類し、対処方法を提案します: | エラー | 一般的な意味と対処方法 | | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **認証失敗** | Client ID または Client Secret が拒否されました。ActiveAI Security Portal で Client Application が有効であること、および secret が最新であることを確認してください — secret は一度しか表示されないため、失くした場合はアプリケーションを再作成してください。 | | **エンドポイントに到達できません** | Dispel は Darktrace に到達できませんでした。Darktrace Master URL が正しいことを確認してください。 | | **接続タイムアウト** | Darktrace の応答に時間がかかりすぎました — 通常は一時的なネットワーク問題です。再試行してください。 | | **設定エラー** | master URL が正しくないようです。Darktrace のクラウド master URL である必要があります（たとえば `https://your-instance.cloud.darktrace.com`）。Dispel はそこからインスタンス名を導出します。 | ## よくある質問
どの資格情報を使えばよいですか — ActiveAI ですか、それとも旧式の API トークンですか？ ActiveAI Security Portal の client-application 資格情報（次の下で作成した Client ID と Client Secret）を使用してください **Client Application の管理**）。Darktrace のクラウドでは OAuth2 の client-credentials フローが必要です。旧式の Threat-Visualizer API token/secret の組み合わせでは認証できません。
「master URL」とは何ですか？ これは Darktrace の master インスタンスの URL です。たとえば `https://usw1-00000-01.cloud.darktrace.com`。Dispel はそこからインスタンス名を導出し、API リクエストを次へ経由させます `api.darktrace.com`。そのため、master URL だけを指定すれば十分です。
Darktrace はどの findings を Dispel に取り込みますか？ Darktrace の Model Alerts — その行動検知 — が一致するデバイスに検出結果として付与され、重大度はモデルのカテゴリから決まります。これらは CVE ベースの脆弱性ではなく、行動検知です。
Dispel は Autonomous Response (Antigena) を起動または変更しますか？ いいえ。このインテグレーションは読み取り専用です。Dispel はデバイスの拡張情報の一部として Antigena の状態を表示しますが、Darktrace で Autonomous Response のアクションを起動、変更、または解除することはありません。
複数の Darktrace インスタンスを接続できますか？ はい。Darktrace は複数のインテグレーションをサポートしているため、複数のインスタンスを並べて接続できます。それぞれに固有の **表示名** を付けて区別してください。
--- # 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-ja/shisuru-2/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.