フィードユーティリティのコマンドラインオプション
2024年4月11日
ID 171404
フィードユーティリティはコンソールアプリケーションです。コマンドラインから起動できます。
構文
Linux の場合、次の構文を使用します:
./kl_feed_util [options]
Windows の場合、次の構文を使用します:
kl_feed_util.exe [options]
オプション
次のオプションを使用できます:
-h [ --help ]
ヘルプメッセージを出力します。
-v [ --verbose ]
詳細モードを有効化します。
詳細モードを有効にすると、フィードユーティリティの活動の詳細が画面に表示されます。詳細モードを無効にすると、概要が表示されます。
-s [ --silent ]
サイレントモードを有効化します。
サイレントモードを有効にすると、フィードユーティリティの活動に関する情報は画面に表示されません。
-c [ --config ] arg
設定情報ファイルへのパスを指定します。パスは
arg
引数で指定する必要があります。絶対パスまたは相対パスを使用できます。相対パスを指定すると、フィードユーティリティのバイナリファイルとの相対的なパスが計算されます。
このオプションの既定値は
kl_feed_util.conf
です。このファイルは、フィードユーティリティのバイナリファイルが存在するディレクトリ内で検索されます。-d [ --download ]
ダウンロードモードを有効化します。
このオプションを指定すると、フィードがダウンロードされますが、その処理は実行されません。
ダウンロードされたファイルは、フィードユーティリティ設定情報ファイルの
WorkDir
パラメータで指定したディレクトリに格納されます。-u [ --unpack ]
ダウンロードされたフィードを解凍します。
このオプションを指定すると、フィードがダウンロード後に解凍されます。
このオプションは、
-d
または-p
オプションとのみ併用できます。-p [ --processing ]
処理モードを有効化します。
このオプションを指定すると、フィードが処理されますが、ダウンロードまたは解凍は実行されません。フィードの元ファイルは削除されません。
フィードは、フィードユーティリティ設定情報ファイルの
WorkDir
パラメータで指定したディレクトリで検索されます。処理モードでは、ディレクトリ
WorkDir
にあるフィードの元ファイルは削除されません。そのため、1 つのフィードファイルの複数のバージョンがこのディレクトリに含まれる可能性があります。その場合は、エラーメッセージが表示されます。このような状況を避けるには、フィードが処理された後、フィードの元ファイルをディレクトリWorkDir
から手動で削除する必要があります。-f [--feed] arg
指定のフィードをダウンロードまたは処理します。
フィードの名前を
arg
引数で指定する必要があります。この名前は、フィードルールで指定したName
パラメータ([Feeds
]→[Feed
]→[Name
])の値に相当します。フィードは複数指定できます。その場合は、フィード名をセミコロン(
;
)で区切ってください。このオプションは
-d
オプションおよび-p
オプションと併用できます。-i [--input]
このフィードを対象に定義された解析ルールに従って、外部フィードを解析し、JSON 形式に変換します。
フィードの名前は
-f
形式で指定する必要があります。-l [ --list ]
現在の証明書で使用可能なデータフィードのリストを、各フィードがフィードユーティリティ設定情報ファイルに指定されているかどうかとともに出力します。出力内の
used
はフィードが設定情報ファイルに指定されていることを意味し、unused
はフィードが指定されていないことを意味します。設定情報ファイルに指定されているフィード(used
)は、有効にすることも無効にすることもできます。このオプションは、
-c
または-v
オプションと併用できます。--set-proxy username:password@host:port
指定のプロキシ接続設定をフィードユーティリティ設定情報ファイルに書き込みます。
username
パラメータとpassword
パラメータは暗号化形式で書き込まれます。ユーザー名は
username
パラメータで、パスワードはpassword
パラメータで、プロキシサーバーアドレスとポートはhost
パラメータとport
パラメータで指定してください。プロキシサーバーで認証が不要な場合は、
--set-proxy host:port
形式を使用してください。--set-taxii username:password@feedname@taxii-address@collectionname
指定の TAXII サーバーの接続設定をフィードユーティリティ設定情報ファイルに書き込みます。
username
パラメータとpassword
パラメータは暗号化形式で書き込まれます。TAXII サーバーで認証が不要な場合は、
feedname@taxii-address@collectionname
形式を使用してください。--set-basic-auth username:password@feedname
指定の基本認証設定をフィードユーティリティ設定情報ファイルに書き込みます。
username
パラメータとpassword
パラメータは暗号化形式で書き込まれます。パスワードが不要な場合は、
username:@feedname
形式を使用してください。--speedtest
フィードユーティリティがカスペルスキーのサーバーからフィードをダウンロードする平均速度を測定します。
このオプションを
-c
パラメータと組み合わせて、使用される設定情報ファイルへのパスを指定できます。--set-mailbox
フィールドユーティリティは、メールサーバーに接続するためにこのパラメータを使用してユーザー名とパスワードをエンコードします。
--set-mailbox
パラメータで、{user}:{pass}@{FeedName}
属性を指定します。意味は次の通りです:
{user}
はメールサーバーに接続するためのユーザーアカウントです。{pass}
はメールサーバーに接続するためのユーザーアカウントのパスワードです。{FeedName}
は、接続設定が設定されるフィードの名前です。フィード名にスペースがある場合は、名前を引用符で囲う必要があります。
--check-mailbox-connection
メールサーバーとの接続をチェックするために、
--check-mailbox-connection
パラメータで{FeedName}
属性を指定します。ここで、{FeedName}
は接続設定をチェックするフィードの名前です。フィード名にスペースがある場合は、名前を引用符で囲う必要があります。
構文の例
既定のパラメータを使用してフィードユーティリティを実行します。フィードユーティリティによってフィードがダウンロード、解凍、処理されます。
- Linux の場合:
./kl_feed_util
- Windows の場合:
kl_feed_util.exe
custom_configuration.conf
という設定情報ファイルを使用してフィードユーティリティを詳細モードで実行します。この設定情報ファイルは、ユーティリティバイナリファイルと同じディレクトリ内にあります。
- Linux の場合:
./kl_feed_util -v -c custom_configuration.conf
- Windows の場合:
kl_feed_util.exe -v -c custom_configuration.conf
フィードをダウンロードして解凍します。
- Linux の場合:
./kl_feed_util -d -u
- Windows の場合:
kl_feed_util.exe -d -u
解凍したフィードを処理します。その場合、フィードはダウンロードされず、解凍済みのフィードファイルの検索と処理だけが行われます。
- Linux の場合:
./kl_feed_util -p
- Windows の場合:
kl_feed_util.exe -p
フィードを解凍して処理します。
- Linux の場合:
./kl_feed_util -u -p
- Windows の場合:
kl_feed_util.exe -u -p
指定のフィードをダウンロード、解凍、処理します。
- Linux の場合:
./kl_feed_util -f Demo_Botnet_CnC_URL_Data_Feed
- Windows の場合:
kl_feed_util.exe -f Demo_Botnet_CnC_URL_Data_Feed
プロキシ接続パラメータを指定します。これらのパラメータは設定情報ファイルに書き込まれます。
- Linux の場合:
./kl_feed_util --set-proxy 'user:pass@proxy.example.com:3128'
- Windows の場合:
kl_feed_util.exe --set-proxy 'user:pass@proxy.example.com:3128'
認証が不要なプロキシのプロキシ接続パラメータを指定します。これらのパラメータは構成ファイルに書き込まれます。
- Linux の場合:
./kl_feed_util --set-proxy 'proxy.example.com:3128'
- Windows の場合:
kl_feed_util.exe --set-proxy 'proxy.example.com:3128'
TAXII サーバー接続パラメータを指定します。これらのパラメータは構成ファイルに書き込まれます。
- Linux の場合:
./kl_feed_util --set-taxii '
user:pass@Example_Feed_Name@http://example.com@Example_Collection
' - Windows の場合:
kl_feed_util.exe --set-taxii '
user:pass@Example_Feed_Name@http://example.com@Example_Collection
'
フィードユーティリティがカスペルスキーのサーバーからフィードをダウンロードする平均速度を表示します。
- Linux の場合:
./kl_feed_util --speedtest
- Windows の場合:
kl_feed_util.exe --speedtest
使用可能なデータフィードのリストを取得し、このリストを available_feeds.txt に保存します。
- Linux の場合:
./kl_feed_util -l > available_feeds.txt
- Windows の場合:
kl_feed_util.exe -l > available_feeds.txt