wsdiscovery

Wsdiscovery - WS-Discovery プロトコルスキャナー

wsdiscovery ツールを使用して、WS-Discovery プロトコル（ONVIF カメラや IoT デバイスで一般的に使用されています）を使うデバイスの検出と列挙を支援します。

ツールの概要

Wsdiscovery は、この標準をサポートするネットワークデバイスを検出するために WS-Discovery プロトコルを実装しています。WS-Discovery を通じて自身をアドバタイズする ONVIF カメラ、ネットワークビデオレコーダー（NVR）、その他の IoT デバイスを見つけるのに特に便利です。

手順

ユーザーが ONVIF デバイスの検出、ネットワークカメラの検索、または WS-Discovery デバイスのスキャンを依頼した場合：

1. 対象を確認する：

   • 対象のホスト名または IP アドレスを尋ねます
   • 詳細出力（XML レスポンス全体）が必要か確認します
   • 出力形式を決定します

2. スキャンを実行する：

   • iothackbot bin ディレクトリにある wsdiscovery コマンドを使用します
   • 基本的な使用方法：wsdiscovery <hostname_or_ip>
   • 詳細出力の場合：wsdiscovery <hostname_or_ip> -v
   • JSON 出力の場合：wsdiscovery <hostname_or_ip> --format json

3. 出力形式：

   • --format text（デフォルト）：デバイスの詳細を含む、人が読みやすい色付きの出力
   • --format json：機械可読な JSON
   • --format quiet：最小限の出力

検出できる情報

このツールは以下の情報を抽出して表示します：

• IP アドレスとポート
• エンドポイント参照（デバイス UUID）
• デバイスの種類
• メーカー情報
• デバイス名とモデル
• ハードウェアバージョン
• シリアル番号
• ファームウェアバージョン
• 位置情報
• サービスエンドポイント（XAddrs）— デバイス管理用の URL
• メタデータバージョン

例

特定のホスト上のデバイスを検出します：

wsdiscovery 192.168.1.100

XML レスポンス全体を含めて検出します：

wsdiscovery 192.168.1.100 -v

デバイス情報を JSON で出力します：

wsdiscovery 192.168.1.100 --format json

ネットワークのブロードキャストアドレスをスキャンして、すべてのデバイスを見つけます：

wsdiscovery 239.255.255.250

重要な注意事項

• WS-Discovery はマルチキャスト／ブロードキャストによる検出を使用します
• 検出するには、デバイスが WS-Discovery プロトコルをサポートしている必要があります
• ONVIF カメラ、プリンター、ネットワークメディアデバイスで一般的に使用されています
• サービスエンドポイント（XAddrs）は、追加のテストのために onvifscan で使用できます
• このツールは、利用可能な場合に ONVIF 固有のスコープ情報を解析します