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

# Dragos

Dragos Platform（SiteStore）を接続して、検出されたOT資産をDispelに取り込み、DragosセンサーをWicketにマッピングし、デバイスデータと脆弱性検出結果を同期状態に保ちます。

## 概要

Dragos連携により、DispelはDragos Platformが検出したOT資産を取得し、Dispelデバイスとして登録できます。Dragosの **SiteStore** に一度接続し、各DragosセンサーをDispelの施設とWicketに対応付けると、Dispelは該当するデバイスをインポートし、定期的な同期で最新状態に保ちます。

Dragosは **資産検出** 連携です。DispelはDragosから情報を読み取るだけで、プラットフォームへの書き込みは行いません。

Dragosでは、 **センサー** は産業ネットワークを監視する収集ポイントです。Dispelでは各Dragosセンサーを **サイト** として扱い、DispelのWicketに対応付けます。これにより、資産がセンサーごとに適切な場所に登録されます。

#### Dispelがインポートするデータ

* 検出された資産（名前、IPアドレス、MACアドレス、メーカー／モデル、オペレーティングシステム、デバイスタイプ）をDispelデバイスとして取り込みます。
* 各資産で観測されたネットワークプロトコルとポート。
* デバイスに保存される、Dragos内の資産へのリンク。
* **脆弱性の検出結果** インポートした各デバイスについて、ハードウェア／ファームウェアとソフトウェア／OSの両方の問題を対象に、同期のたびに更新されます。

{% hint style="info" %}
**確認場所** 組織管理者としてサインインし、 **Settings → Integrations**を開きます。Dragosは **Asset Discovery / Network Visibility** セクションに表示されます。Dragosのカードにある **Connect** をクリックして開始します。
{% endhint %}

## 開始する前に

Dragos SiteStoreから以下の情報を用意してください。

* 次の **APIキー** — その **APIキーID** （識別子）と **APIキーシークレット**です。SiteStoreでこれらを発行してください。
* お使いの環境の **SiteStore URL** — 例： `https://customer.dragos.cloud`.

{% hint style="warning" %}
**APIキーシークレットは一度しか表示されません。** キーを発行するときに、Dragosはシークレットを一度だけ表示します。その場でコピーしてください。紛失した場合は、新しいキーを発行してください。また、DispelがSiteStoreに接続できるよう、Dispelの **ホワイトリストIP** （接続フォームに表示）をファイアウォールの許可リストに追加してください。特にオンプレミス環境では必要です。
{% endhint %}

## Dragosを接続する

1. に移動し、 **Settings → Integrations** で、Dragosのカードにある **Connect** をクリックします。
2. 必要に応じて **表示名** を設定し、他の連携と区別できます（複数のSiteStoreに接続できます）。
3. 接続フィールドに入力します。

| フィールド             | 種類   | 備考                                           |
| ----------------- | ---- | -------------------------------------------- |
| **SiteStore URL** | 設定   | お使いのDragos SiteStoreインスタンスのベースURLです。         |
| **APIキーID**       | 認証情報 | Dragos SiteStore の API キー ID。                |
| **API キーシークレット**  | 認証情報 | キーに関連付けられたシークレットです。暗号化して保存され、再表示されることはありません。 |

4. クリックして **接続をテスト** Dispel が SiteStore に対して認証できることを確認します。保存する前に、報告されたエラーをすべて解消してください。
5. クリックして **保存**。Dispel はインテグレーションを保存し、初期同期をすぐに実行してセンサーを検出します。

{% hint style="info" %}
**認証情報は暗号化されます。** API キーシークレットは保存時に暗号化され、保存後に再表示されることはありません。後で編集する際、保存済みの値を維持するには、認証情報のフィールドを空欄のままにしてください。
{% endhint %}

## センサーを Wicket にマッピングする

初期同期が完了したら、インテグレーションを開いて **サイトマッピング** セクションを確認します。各 Dragos センサーはサイトとして表示されます。ここで、どのセンサーを Dispel デバイスにするか、またその配置先を決定します。

> 各ベンダーサイトを Dispel の施設と Wicket にマッピングします。マッピングされたサイトのデバイスが Dispel に同期されます。

インポートする各センサーについて、次の操作を行います。

1. 選択: **施設**.
2. 選択: **Wicket**。施設に Wicket が 1 つしかない場合、Dispel が自動的に選択します。
3. クリックします: **マッピングを保存してインポート**.

Dispel はマッピングされた各センサーを順に処理します。サイトごとの進行状況が「待機中」から「取得中」「同期中」を経て「完了」へと変化し、インポートされたデバイス数（例: **「12 台のデバイスをインポートしました」** 、または新規デバイスとインポート済みデバイスの内訳）が表示されます。インポートされたデバイスは、手動で追加したデバイスとともに、マッピング先の Wicket に表示されます。

## インベントリを最新の状態に保つ

* Dispel **は定期的なスケジュールで自動的に再同期する** ため、新たに検出された資産や変更された詳細情報も、操作不要で反映されます。
* 最新のインベントリをすぐに取得するには、インテグレーションを開いて、 **更新**.
* 接続の詳細を変更する、または認証情報をローテーションするには、連携を編集し、 **保存して同期**を使用します。現在のシークレットを維持するには、認証情報のフィールドを空欄のままにしてください。

## 脆弱性の検出結果

Dragos は、監視対象のアセットについて既知の脆弱性を報告します。同期が正常に完了するたびに、Dispel はインポート済みデバイスの脆弱性情報を取得します。対象にはハードウェア／ファームウェアとソフトウェア／OS の両方の問題が含まれ、各デバイスに関連付けられます。そのため、Dispel を離れずにデバイスの既知の問題を確認できます。脆弱性情報は同期のたびに更新され、解決済みの情報は自動的に表示されなくなります。

## 接続ステータス

各インテグレーションにはステータスが表示されるため、常に現在の状態を確認できます。

| ステータス      | 意味                                    |
| ---------- | ------------------------------------- |
| **未初期化**   | 保存済みですが、初回同期はまだ実行されていません。             |
| **初期化中**   | 初回同期の実行とセンサーの検出。                      |
| **準備完了**   | 接続および同期済みです。マッピングが適用されています。           |
| **更新が必要**  | ベンダーの新しいデータが利用可能です。取得するには更新を実行してください。 |
| **更新中**    | 同期を実行中です。                             |
| **変更を保留中** | マッピングの変更は保存されていますが、まだ適用されていません。       |
| **適用中**    | 保存済みのマッピングに基づいてデバイスを取り込んでいます。         |
| **失敗**     | 前回の操作に失敗しました。エラーに関するガイダンスを確認してください。   |

別の **ヘルスバッジ** （接続済み、劣化、到達不能）は、Dispel が現在 Dragos API に接続できるかどうかを示します。

## トラブルシューティング

同期または接続テストに失敗すると、Dispelはエラーを分類し、解決方法を提示します。

| エラー                 | 一般的な原因と解決方法                                                                                           |
| ------------------- | ----------------------------------------------------------------------------------------------------- |
| **認証に失敗しました**       | API キー ID／シークレットが拒否されました。キーがローテーション、期限切れ、または失効している可能性があります。新しいキーを発行し、インテグレーションを更新してください。              |
| **エンドポイントに到達できません** | Dispel は SiteStore に接続できませんでした。SiteStore の URL と、ファイアウォールで Dispel の IP アドレスが許可リストに登録されていることを確認してください。 |
| **接続がタイムアウトしました**   | SiteStore の応答に時間がかかりすぎています。ネットワーク遅延やファイアウォールルールが原因であることがよくあります。                                       |
| **レート制限中**          | Dragos によってリクエストが制限されました。次回のスケジュール済み同期は成功する見込みです。                                                     |
| **設定エラー**           | SiteStore の URL が正しくないようです。接続設定を再確認してください。                                                            |

## よくある質問

<details>

<summary>複数の Dragos SiteStore に接続できますか？</summary>

はい。Dragos は複数のインテグレーションに対応しているため、複数の SiteStore インスタンスを並行して接続できます。それぞれに異なる **表示名** を設定して、区別できるようにしてください。

</details>

<details>

<summary>Dragos における「サイト」とは何ですか？</summary>

Dispel は Dragos の **センサー** をサイトにマッピングします。ネットワークを監視する各センサーはサイトマッピングの一覧に表示されるため、異なるセンサーからのアセットを別々の施設や Wicket に振り分けられます。

</details>

<details>

<summary>API キーシークレットを紛失しました。どうすればよいですか？</summary>

Dragos でシークレットが表示されるのは、プロビジョニング時の一度だけです。シークレットが手元にない場合は、SiteStore で新しい API キーを発行し、新しい ID とシークレットでインテグレーションを更新してください。

</details>

<details>

<summary>Dragos に接続すると、SiteStore のデータは変更されますか？</summary>

いいえ。Dispel は Dragos からデータを読み取るだけです。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-ja/shisuru-2/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.
