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

# TXOne

TXOne StellarOneコンソールを接続して、保護されたOTエンドポイントをDispelにデバイスとして取り込み、Wicketにマッピングし、定期同期で更新されます。

## 概要

TXOne連携により、Dispelはお使いのTXOneで管理されているOTエンドポイントを取得できます **StellarOne** コンソールからそれらをDispelデバイスとして取り込みます。StellarOneには一度接続し、Dispelの施設とWicketにマッピングすると、Dispelが一致するデバイスをインポートし、定期同期で最新状態を維持します。

TXOneは **アセット検出** 連携です。DispelはStellarOne管理コンソールに接続し、そこから読み取るだけです。

StellarOneでは、 **エージェント** は管理下のStellarProtectエンドポイントです。Dispelは各エージェントをデバイスとしてインポートし、IP、MAC、ホスト名、オペレーティングシステム、インストール済みのICSアプリケーションを報告します。StellarOneコンソールは単一の環境を表すため、Dispelはそのコンソールを1つの **サイト** として扱い、単一のWicketにマッピングします。

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

* 管理対象エージェント（ホスト名、IPアドレス、MACアドレス、オペレーティングシステム）をDispelデバイスとして。
* 各エージェントで観測されたネットワークプロトコルとポート。
* デバイスに保存される、StellarOne内のエージェントへのリンク。

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

## 開始前に

TXOne StellarOneコンソールから次の情報が必要です:

* APIキー **APIキー**、StellarOne Management Consoleで生成されたもの（正確な手順はStellarOne Administrator's Guideを参照）。
* 次の **StellarOne URL** 。たとえば `https://stellar1.example.com`.
* コンソールで **自己署名TLS証明書**を使用している場合は、セットアップ時に自己署名オプションを有効にできるようにしておいてください。

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

## TXOneへの接続

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

| フィールド              | 種類   | 備考                                              |
| ------------------ | ---- | ----------------------------------------------- |
| **StellarOne URL** | 設定   | TXOne StellarOne管理コンソールのURL。                    |
| **自己署名証明書を許可**     | 設定   | コンソールが自己署名TLS証明書を使用している場合はオンにします。               |
| **APIキー**          | 認証情報 | StellarOneで生成されたAPIキー。暗号化して保存され、再表示されることはありません。 |

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

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

## コンソールをWicketにマッピングする

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

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

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

DispelはコンソールのエージェントをマッピングされたWicketにインポートします。進行状況は、待機中、取得中、同期中、完了へと変化し、インポートされたデバイス数が報告されます（たとえば、 **"12個のデバイスをインポートしました"** または新規デバイスと既存のインポート済みデバイスの内訳）。インポートされたデバイスは、手動で追加したデバイスとともに、マッピングされたWicketに表示されます。

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

* Dispel **は自動的に再同期します** 定期スケジュールで、新たに登録されたエージェントや変更された詳細が、何もしなくても取り込まれます。
* 最新のインベントリをすぐに取得するには、連携を開いて次を選択します **更新**.
* 接続詳細を変更したりキーをローテーションするには、連携を編集して次を使用します **保存して同期**。現在のキーを保持するには、認証情報フィールドは空欄のままにしてください。

## 接続状態

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

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

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

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

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

| エラー               | 通常の意味と対処方法                                                                           |
| ----------------- | ------------------------------------------------------------------------------------ |
| **認証に失敗**         | APIキーが拒否されました。StellarOneで新しいキーを生成し、連携を更新してください。                                      |
| **エンドポイントに到達不可**  | Dispelがコンソールに到達できませんでした。StellarOne URLと、ファイアウォールでDispelのIPが許可リストに登録されていることを確認してください。 |
| **証明書エラー**        | コンソールが信頼されていないTLS証明書を提示しました。自己署名証明書を使用している場合は、 **自己署名証明書を許可** 接続設定で有効にしてください。        |
| **接続がタイムアウトしました** | コンソールの応答に時間がかかりすぎました。多くの場合、Dispelとお使いのネットワーク間のネットワーク遅延またはファイアウォールルールが原因です。           |
| **設定エラー**         | URLが正しくないようです。接続設定を再確認してください。                                                        |

## よくある質問

<details>

<summary>複数のStellarOneコンソールに接続できますか？</summary>

はい。TXOneは複数の連携をサポートしているため、複数のコンソールを並行して接続できます。それぞれに固有の **表示名** を付けて区別してください。

</details>

<details>

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

StellarOneコンソールは単一の環境を表すため、Dispelはそれを個別にマッピングするサイト一覧ではなく、1つのWicketにマッピングされた1つのサイトとしてモデル化します。

</details>

<details>

<summary>コンソールで自己署名証明書を使用しています。接続は失敗しますか？</summary>

有効にすれば失敗しません **自己署名証明書を許可** 接続設定で。コンソールが信頼された認証局の証明書を提示している場合はオフのままにしてください。

</details>

<details>

<summary>TXOneへの接続でStellarOneに何か変更は加わりますか？</summary>

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

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