Zeek-Parser-SSDP-COM
English is here
概要
Zeek-Parser-SSDP-COMとはSSDP(Simple Service Discovery Protocol)を解析できるZeekプラグインです。
インストール
パッケージマネージャーによるインストール
このプラグインはZeek Package Manger用のパッケージとして提供されています。
以下のコマンドを実行することで、本プラグインは利用可能になります。
zkg refresh
zkg install zeek-parser-SSDP-COM
マニュアルインストール
本プラグインを利用する前に、Zeek, Spicyがインストールされていることを確認します。
# Zeekのチェック
~$ zeek -version
zeek version 5.0.0
# Spicyのチェック
~$ spicyz -version
1.3.16
~$ spicyc -version
spicyc v1.5.0 (d0bc6053)
# 本マニュアルではZeekのパスが以下であることを前提としています。
~$ which zeek
/usr/local/zeek/bin/zeek
本リポジトリをローカル環境に git clone します。
~$ git clone https://github.com/nttcom/zeek-parser-SSDP-COM.git
使い方
パッケージマネージャーによるインストールの場合
以下のように本プラグインを使うことで mydhcp.log が生成されます。
zeek -Cr /usr/local/zeek/var/lib/zkg/clones/package/zeek-parser-SSDP-COM/testing/Traces/test.pcap zeek-parser-SSDP-COM
マニュアルインストールの場合
ソースコードをコンパイルして、オブジェクトファイルを以下のパスにコピーします。
~$ cd ~/zeek-parser-SSDP-COM/analyzer
~$ spicyz -o ssdp.hlto ssdp.spicy ssdp.evt
# ssdp.hltoが生成されます
~$ cp ssdp.hlto /usr/local/zeek/lib/zeek-spicy/modules/
同様にZeekファイルを以下のパスにコピーします。
~$ cd ~/zeek-parser-SSDP-COM/scripts/
~$ cp main.zeek /usr/local/zeek/share/zeek/site/SSDP.zeek
最後にZeekプラグインをインポートします。
~$ tail /usr/local/zeek/share/zeek/site/local.zeek
...省略...
@load SSDP
本プラグインを使うことで ssdp.log が生成されます。
~$ cd ~/zeek-parser-SSDP-COM/testing/Traces
~$ zeek -Cr test.pcap /usr/local/zeek/share/zeek/site/SSDP.zeek
ログのタイプと説明
本プラグインはssdpの全ての関数を監視してssdp.logとして出力します。
| フィールド | タイプ | 説明 |
|---|---|---|
| ts | time | 通信した時のタイムスタンプ |
| SrcIP | addr | 送信元IPアドレス |
| SrcMAC | string | 送信元MACアドレス |
| Method | string | リクエストメソッドに関する情報 |
| SERVER_or_USER_AGENT | string | デバイスやサービスの識別情報や詳細なバージョン情報 |
ssdp.log の例は以下のとおりです。
#separator \x09
#set_separator ,
#empty_field (empty)
#unset_field -
#path ssdp
#open 2023-09-13-04-35-24
#fields ts SrcIP SrcMAC Method SERVER_or_USER_AGENT
#types time addr string string string
1668040655.960467 192.168.1.131 dc:72:23:56:9a:d1 NOTIFY Linux/4.14.76+ UPnP/1.0 CyberLinkJava/1.8
1668040683.179186 192.168.1.130 14:da:e9:cd:9f:0c M-SEARCH Request -
1668040683.884088 192.168.1.130 14:da:e9:cd:9f:0c M-SEARCH Request Google Chrome/106.0.5249.119 Linux
#close 2023-09-13-04-35-24
関連ソフトウェア
本プラグインはOsecTで利用されています。