> 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つのサイトとして扱い、1つのWicketにマッピングします。サイトごとの一覧を確認する必要はありません。

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

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

{% hint style="info" %}
**連携機能の場所** 組織管理者としてサインインし、 [**Settings → Integrations**](https://app.dispel.com/settings/integrations)を開きます。Claroty xDomeは、 **Asset Discovery / Network Visibility** セクションに表示されます。開始するには、Claroty xDomeカードの **Connect** をクリックします。
{% endhint %}

## 開始する前に

xDomeから次の情報を用意してください。

* xDomeの **APIトークン**。xDomeで **Settings → Admin Settings → User Management**に移動し、APIユーザーを作成して、そのユーザー用のトークンを生成します。
* お使いのリージョンに対応する **xDome APIホスト** 。例： `https://api.claroty.com` または `https://eu.api.claroty.com`.

{% hint style="warning" %}
**APIトークンは一度しか表示されません。** xDomeでトークンが表示されるのは、生成時のみです。その場でコピーしてください。紛失した場合は、新しいトークンを生成してください。
{% endhint %}

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

## Claroty xDomeへの接続

1. に移動し、 [**Settings → Integrations**](https://app.dispel.com/settings/integrations) をクリックして、Claroty xDomeカードの **Connect** をクリックします。
2. 必要に応じて、 **Display Name** を設定し、この連携を他の連携と区別できます（複数のインスタンスを接続できます）。
3. 接続フィールドに入力します。

| フィールド            | 種類   | 備考                                                                                         |
| ---------------- | ---- | ------------------------------------------------------------------------------------------ |
| **API URL**      | 設定   | お使いのリージョンに対応するxDome APIホスト（例：） `https://api.claroty.com` または `https://eu.api.claroty.com`. |
| **APIトークン**      | 認証情報 | xDomeでAPIユーザー用に生成したトークンです。暗号化して保存され、再び表示されることはありません。                                       |
| **退役済みデバイスを含める** | 設定   | 任意。オンにすると、xDomeで退役済みとマークされたデバイスもDispelにインポートされます。デフォルトではオフです。                              |

4. をクリックして **Test Connection** Dispelが認証できることを確認します。保存する前に、報告されたエラーをすべて解決してください。
5. クリックします: **保存**。Dispel はインテグレーションを保存し、初回同期をすぐに実行します。

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

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

初回同期が完了したら、連携機能を開いて **Site Mapping** セクションを確認します。Claroty xDomeは、テナントを表す単一のサイトとして表示されます。

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

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

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

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

* Dispelは定期的に自動で再同期するため、新たに検出されたデバイス、変更された詳細情報、新しい検出結果が、操作しなくても反映されます。
* 最新のインベントリをすぐに取得するには、インテグレーションを開いて、 **更新**.
* 接続の詳細を変更するかトークンをローテーションするには、連携を編集して **\[保存して同期]**&#x3092;使用します。現在のトークンを保持するには、トークン欄を空欄のままにしてください。

脆弱性の検出結果は同期のたびに更新され、xDomeから報告されなくなった検出結果は自動的に表示されなくなります。

## 接続ステータス

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

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

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

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

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

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

## よくある質問

<details>

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

xDomeで **Settings → Admin Settings → User Management**に移動し、APIユーザーを作成して、そのユーザーのトークンを生成します。トークンは一度しか表示されないため、ページを離れる前にコピーしてください。

</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>複数の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.
