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

# Claroty xDome

Claroty xDome をクラウド API 経由で接続し、検出された OT、IoT、IIoT デバイスを、脆弱性検出結果を付加した形で Dispel に取り込み、Wicket にマップします。

## 概要

Claroty xDome 連携により、Dispel は xDome が検出した OT、IoT、IIoT の資産を取り込み、xDome の脆弱性情報で補強された Dispel デバイスとして登録できます。xDome テナントには一度接続し、Dispel の施設と Wicket にマッピングすると、Dispel が一致するデバイスをインポートし、定期同期で最新状態を維持します。

Claroty xDome はクラウド資産検出連携です。Dispel は API トークンを使用して xDome API に認証し、読み取りのみを行います。xDome テナントは単一の環境を表すため、Dispel はそれを 1 つのサイトとして扱い、単一の Wicket にマッピングします。サイトごとの一覧を順に処理する必要はありません。

#### Dispelが取り込む内容

* xDome が検出したデバイス。既存の Dispel デバイスに一致するものは対応付けられ、一致しないものは新しいデバイスとしてインポートされます。
* xDome の脆弱性検出結果（CVE ベース、CVSS v3 スコア付き）を一致するデバイスの検出結果として表示するため、Dispel から離れずにデバイスの既知の問題を確認できます。

{% hint style="info" %}
**場所** 組織管理者としてサインインし、 [**設定 → 連携**](https://app.dispel.com/settings/integrations)。Claroty xDome が表示されます **アセットディスカバリー / ネットワーク可視化** セクションに表示されます。 **接続** 開始するには、Claroty xDome カード上で
{% endhint %}

## 開始前に

xDome から次の情報が必要です。

* 1つの **API トークン**。xDome で、 **設定 → 管理設定 → ユーザー管理** に移動し、API ユーザーを作成してから、そのユーザー用のトークンを生成します。
* リージョン固有の **xDome API ホスト** — たとえば `https://api.claroty.com` または `https://eu.api.claroty.com`.

{% hint style="warning" %}
**API トークンは 1 回だけ表示されます。** xDome では、生成したときにのみトークンが表示されます。その時点でコピーしてください。紛失した場合は、新しいトークンを生成してください。
{% endhint %}

{% hint style="info" %}
**トークンの権限によって、Dispel に表示される内容が決まります。** Dispel は API ユーザーに読み取り権限のある資産をインポートするため、Dispel に取り込みたいデバイスがあるサイトへのアクセス権を API ユーザーに付与してください。
{% endhint %}

## Claroty xDome を接続しています

1. 次へ移動 [**設定 → 連携**](https://app.dispel.com/settings/integrations) をクリックします **接続** Claroty xDome カード上で
2. 必要に応じて次を設定します **表示名** このインテグレーションを他のものと区別するための名前です（複数のインスタンスを接続できます）。
3. 接続フィールドを入力します:

| フィールド            | 種類   | 注記                                                                                      |
| ---------------- | ---- | --------------------------------------------------------------------------------------- |
| **API URL**      | 設定   | リージョン固有の xDome API ホスト、たとえば `https://api.claroty.com` または `https://eu.api.claroty.com`. |
| **API トークン**     | 認証情報 | xDome の API ユーザー用に生成されたトークン。暗号化して保存され、再表示されることはありません。                                   |
| **廃止済みデバイスを含める** | 設定   | オプション。オンにすると、Dispel は xDome で廃止済みとしてマークされたデバイスもインポートします。既定ではオフです。                       |

4. クリック **接続テスト** Dispel が認証できることを確認するためです。保存する前に、表示されたエラーを解消してください。
5. クリック **保存**。Dispelが連携を保存し、初期同期を直ちに実行します。

{% hint style="info" %}
**認証情報は暗号化されています。** API トークンは保存時に暗号化され、保存後は再表示されません。後で編集する場合は、保存済みの値を保持するにはトークン欄を空白のままにしてください。
{% endhint %}

## テナントを Wicket にマッピングする

初期同期が完了したら、連携を開いて次を見つけます **サイトマッピング** セクション。Claroty xDome は、テナントを表す 1 つのサイトとして表示されます。

> 各ベンダーサイトを Dispel のファシリティと Wicket にマッピングします。マッピングされたサイトのデバイスは Dispel に同期されます。

1. 次を選択します **ファシリティ**.
2. 次を選択します **ウィケット**。ファシリティに Wicket が 1 つしかない場合、Dispel が自動で選択します。
3. クリック **マッピングを保存してインポート**.

Dispel は xDome のデバイスをマッピング先の Wicket にインポートし、インポートされたデバイス数を報告します。インポートされたデバイスは、手動で追加したデバイスと並んでマッピング先の Wicket に表示され、xDome の脆弱性検出結果が付与されます。

## 在庫情報を最新に保つ

* Dispel は定期スケジュールに従って自動的に再同期するため、新しく検出されたデバイス、変更された詳細、新しい検出結果は、ユーザー操作なしで反映されます。
* 最新の在庫情報をすぐに取得するには、連携を開いて次を選択します **更新**.
* 接続の詳細を変更したりトークンをローテーションしたりするには、連携を編集して **保存して同期**を使用します。現在のトークンを保持するには、トークン欄を空白のままにしてください。

脆弱性検出結果は同期のたびに更新され、xDome で報告されなくなった検出結果は自動的に消えます。

## 接続ステータス

各連携にはステータスが表示され、現在の状態を常に把握できます:

| ステータス     | 意味                                |
| --------- | --------------------------------- |
| **未初期化**  | 保存済みですが、最初の同期はまだ実行されていません。        |
| **初期化中**  | 最初の同期を実行中です。                      |
| **準備完了**  | 接続・同期済み。マッピングが適用されています。           |
| **更新が必要** | 新しいベンダーデータがあります。更新を実行して取り込みます。    |
| **更新中**   | 同期が進行中です。                         |
| **変更待ち**  | マッピング変更は保存されていますが、まだ適用されていません。    |
| **適用中**   | 保存済みマッピングに基づいてデバイスをインポートしています。    |
| **失敗**    | 直前の操作に失敗しました — エラーガイダンスを参照してください。 |

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

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

同期または接続テストが失敗した場合、Dispelがエラーを分類し、対処方法を提案します:

| エラー                 | 一般的な意味と対処方法                                                                                                                        |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| **認証失敗**            | API トークンが拒否されました。xDome で API ユーザーが有効であることと、トークンが現在のものであることを確認してください。トークンは 1 回しか表示されないため、紛失した場合は新しいトークンを生成してください。                   |
| **エンドポイントに到達できません** | Dispel は xDome に到達できませんでした。API URL が正しいリージョン固有のホストであることを確認してください（たとえば `https://api.claroty.com` または `https://eu.api.claroty.com`). |
| **接続タイムアウト**        | xDome の応答に時間がかかりすぎています。通常は一時的なネットワーク問題です。再試行してください。                                                                                |

## よくある質問

<details>

<summary>API トークンはどこで作成しますか？</summary>

xDome で、 **設定 → 管理設定 → ユーザー管理** に移動し、API ユーザーを作成して、そのユーザー用のトークンを生成します。トークンは 1 回しか表示されないため、ページを離れる前にコピーしてください。

</details>

<details>

<summary>どの API URL を使用すればよいですか？</summary>

リージョン固有の xDome API ホスト、たとえば `https://api.claroty.com` または `https://eu.api.claroty.com`。xDome テナントが稼働しているリージョンのホストを使用してください。

</details>

<details>

<summary>Claroty xDome は Dispel にどの検出結果を取り込みますか？</summary>

xDome の脆弱性検出結果—CVE ベースで、CVSS v3 スコア付き—が、一致するデバイスに付与されます。検出結果は同期のたびに更新され、xDome で報告されなくなったものは自動的に消えます。

</details>

<details>

<summary>Dispel は xDome で何かを変更しますか？</summary>

いいえ。連携は読み取り専用です。Dispel はインベントリと検出結果を取り込みますが、xDome 内のデータを作成、変更、削除することはありません。

</details>

<details>

<summary>1 つ以上の xDome テナントを接続できますか？</summary>

はい。Claroty xDome は複数の連携をサポートしているため、複数のテナントを並行して接続できます。各テナントには個別の **表示名** を付けて区別してください。

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