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

# Forescout

Enterprise Managerアプライアンス上のWeb APIを介してForescout eyeControlを接続し、検出されたホストをDispelにデバイスとして取り込みます—Wicketにマッピングされ、定期同期で更新されます。

## 概要

Forescout連携により、DispelはForescoutがネットワーク上で検出したホストを取得し、Dispelデバイスとして取り込めます。Forescoutアプライアンスに一度接続し、それをDispelの施設およびWicketにマッピングすると、Dispelは一致するデバイスをインポートし、定期的な同期によって最新の状態に保ちます。

Forescoutはオンプレミスの **資産検出** 連携です。具体的には、Dispelは **Forescout eyeControl** のWeb API（ **eyeExtend Connect** モジュール）を通じて連携し、読み取りのみを行います。Dispelの接続先として、 **Enterprise Manager** を指定します。これは、ネットワーク上の個々のForescoutアプライアンスを集約するForescoutの中央管理アプライアンスです。Enterprise Managerは物理または仮想アプライアンスとしてお客様自身がデプロイおよび運用するため、Forescoutがホストするクラウドサービスではありません。Dispelはお客様の環境内のアドレスでアクセスするため、接続ではプライベートURLと自己署名証明書オプションがよく使用されます。

Enterprise Managerは単一の環境を表すため、Dispelではこれを1つの **サイト** として扱い、単一のWicketにマッピングします。サイトごとのリストを処理する必要はありません。

{% hint style="info" %}
**Forescoutの名称に関する注意。** 「eyeControl」はDispelが接続するForescout製品であり、「Enterprise Manager」はDispelの接続先となる管理アプライアンスです。接続フィールドには **Enterprise Manager URL** と表示され、Forescoutコンソール内の表記に合わせています。
{% endhint %}

#### Dispelがインポートする内容

* 検出されたホスト（名前、IPアドレス、MACアドレス、メーカー/モデル、オペレーティングシステム、デバイスタイプ）をDispelデバイスとしてインポートします。
* 各ホストで確認されたネットワークプロトコルおよびポート。
* デバイスに保存される、Forescout内のホストへのリンク。

{% hint style="info" %}
**場所。** 組織管理者としてサインインし、 **設定 → 連携**を開きます。Forescoutは、 **資産検出 / ネットワーク可視化** セクションに表示されます。 **接続** をForescoutカードでクリックして開始します。
{% endhint %}

## 開始前の準備

Forescoutコンソールから次の情報が必要です。

* 1つの **Web APIユーザー** — 次の場所で作成します。 **ツール → オプション → Web API → ユーザー設定**。Dispelはこのユーザーの **ユーザー名** および **パスワード**.
* アプライアンスの **Enterprise Manager URL** — 例： `https://192.168.1.100`.
* アプライアンスで **自己署名TLS証明書**を使用している場合は、セットアップ中に自己署名オプションを有効にできるよう準備してください。

{% hint style="warning" %}
**DispelのIPを許可リストに追加します。** 接続フォームを開くと、Dispelには **許可リストIP** の値が表示されます。Dispelがオンプレミスアプライアンスに到達できるよう、このアドレスをネットワークファイアウォールの許可リストに追加してください。
{% endhint %}

## Forescoutへの接続

1. 次へ移動し、 **設定 → 連携** をクリックします **接続** Forescoutカード上で。
2. 必要に応じて、 **表示名** を設定して、この連携を他の連携と区別します（複数のアプライアンスを接続できます）。
3. 接続フィールドに入力します。

| フィールド                      | タイプ  | 注記                                          |
| -------------------------- | ---- | ------------------------------------------- |
| **Enterprise Manager URL** | 設定   | Forescout Enterprise ManagerアプライアンスのURL。    |
| **自己署名証明書を許可**             | 設定   | アプライアンスで自己署名TLS証明書を使用している場合はオンに切り替えます。      |
| **ユーザー名**                  | 認証情報 | Forescoutコンソールで作成したWeb APIユーザー。             |
| **パスワード**                  | 認証情報 | Web APIユーザーのパスワード。暗号化して保存され、再表示されることはありません。 |

4. 次をクリックします： **接続をテスト** をクリックして、Dispelがアプライアンスに対して認証できることを確認します。保存する前に、報告されたエラーをすべて修正してください。
5. 次をクリックします： **保存**。Dispelは連携を保存し、直ちに初回同期を実行します。

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

## アプライアンスをWicketにマッピングする

初回同期が完了したら、連携を開いて **サイトマッピング** セクションを確認します。Forescoutは、アプライアンスを表す単一のサイトとして表示されます。

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

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

Dispelはアプライアンスのホストをマッピング済みのWicketにインポートします。進行状況は「待機中」から「取得中」、「同期中」、「完了」へと進み、その後、インポートされたデバイス数（例： **「12台のデバイスをインポートしました」** 、または新規デバイスと既にインポート済みのデバイスの内訳）を報告します。インポートされたデバイスは、手動で追加したデバイスとともに、マッピング済みのWicketに表示されます。

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

* Dispelは **自動的に再同期します** 定期スケジュールに基づいて実行されるため、新たに検出されたホストや変更された詳細情報は、お客様の操作なしに取得されます。
* 最新のインベントリをすぐに取得するには、連携を開いて **更新**.
* 接続の詳細を変更する、または認証情報をローテーションするには、連携を編集して **保存して同期**を使用します。現在のパスワードを維持するには、認証情報フィールドを空欄のままにしてください。

## 接続ステータス

各連携にはステータスが表示されるため、現在の状態を常に確認できます。

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

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

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

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

| エラー                 | 通常の原因と修正方法                                                                                     |
| ------------------- | ---------------------------------------------------------------------------------------------- |
| **認証に失敗しました**       | Web APIのユーザー名またはパスワードが拒否されました。Web APIユーザーが存在すること、およびパスワードが最新であることを確認してください。                    |
| **エンドポイントに到達できません** | Dispelがアプライアンスに到達できませんでした。Enterprise Manager URLと、DispelのIPがファイアウォールで許可リストに追加されていることを確認してください。 |
| **証明書エラー**          | アプライアンスが信頼されていないTLS証明書を提示しました。自己署名証明書を使用している場合は、 **自己署名証明書を許可** を接続設定で有効にしてください。               |
| **接続がタイムアウトしました**   | アプライアンスの応答に時間がかかりすぎました。多くの場合、ネットワーク遅延またはDispelとネットワーク間のファイアウォールルールが原因です。                       |
| **設定エラー**           | URLが正しくないか、アプライアンスでWeb APIが有効になっていません。接続設定を再確認してください。                                          |

## よくある質問

<details>

<summary>これはeyeControl、eyeSight、それともeyeExtendですか？</summary>

Forescoutのプラットフォームは、「eye」ブランドのモジュールで構成されています。eyeSight（可視化）、eyeControl（ポリシーと制御）、eyeExtend（サードパーティ連携）などです。Dispelは **eyeControl** の **eyeExtend Connect** Web APIを通じて接続します。Dispelの接続先として、 **Enterprise Manager** アプライアンスを指定して設定するため、接続フィールドは次のように呼ばれます： **Enterprise Manager URL**.

</details>

<details>

<summary>複数のForescoutアプライアンスを接続できますか？</summary>

はい。Forescoutは複数の連携をサポートしているため、複数のアプライアンスを並行して接続できます。それぞれに固有の **表示名** を指定して区別してください。

</details>

<details>

<summary>Forescoutでサイトが1つしか表示されないのはなぜですか？</summary>

Forescoutアプライアンスは単一の環境を表すため、Dispelでは個別にマッピングするサイトのリストではなく、1つのWicketにマッピングされた1つのサイトとしてモデル化されます。

</details>

<details>

<summary>アプライアンスで自己署名証明書を使用しています。接続は失敗しますか？</summary>

次を有効にすれば失敗しません： **自己署名証明書を許可** を接続設定で有効にしてください。アプライアンスが信頼された認証局による証明書を提示する場合は、オフのままにしてください。

</details>

<details>

<summary>Forescoutを接続すると、アプライアンス上の何かが変更されますか？</summary>

いいえ。DispelはForescoutのWeb APIから読み取るだけです。Forescout側のデータを作成、変更、削除することはありません。

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