フィードユーティリティはコンソールアプリケーションです。コマンドラインから起動できます。
構文
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}
は接続設定をチェックするフィードの名前です。
フィード名にスペースがある場合は、名前を引用符で囲う必要があります。
構文の例
既定のパラメータを使用してフィードユーティリティを実行します。フィードユーティリティによってフィードがダウンロード、解凍、処理されます。
./kl_feed_util |
kl_feed_util.exe |
custom_configuration.conf
という設定情報ファイルを使用してフィードユーティリティを詳細モードで実行します。この設定情報ファイルは、ユーティリティバイナリファイルと同じディレクトリ内にあります。
./kl_feed_util -v -c custom_configuration.conf |
kl_feed_util.exe -v -c custom_configuration.conf |
フィードをダウンロードして解凍します。
./kl_feed_util -d -u |
kl_feed_util.exe -d -u |
解凍したフィードを処理します。その場合、フィードはダウンロードされず、解凍済みのフィードファイルの検索と処理だけが行われます。
./kl_feed_util -p |
kl_feed_util.exe -p |
フィードを解凍して処理します。
./kl_feed_util -u -p |
kl_feed_util.exe -u -p |
指定のフィードをダウンロード、解凍、処理します。
./kl_feed_util -f Demo_Botnet_CnC_URL_Data_Feed |
kl_feed_util.exe -f Demo_Botnet_CnC_URL_Data_Feed |
プロキシ接続パラメータを指定します。これらのパラメータは設定情報ファイルに書き込まれます。
./kl_feed_util --set-proxy 'user:pass@proxy.example.com:3128' |
kl_feed_util.exe --set-proxy 'user:pass@proxy.example.com:3128' |
認証が不要なプロキシのプロキシ接続パラメータを指定します。これらのパラメータは構成ファイルに書き込まれます。
./kl_feed_util --set-proxy 'proxy.example.com:3128' |
kl_feed_util.exe --set-proxy 'proxy.example.com:3128' |
TAXII サーバー接続パラメータを指定します。これらのパラメータは構成ファイルに書き込まれます。
./kl_feed_util --set-taxii ' |
kl_feed_util.exe --set-taxii ' |
フィードユーティリティがカスペルスキーのサーバーからフィードをダウンロードする平均速度を表示します。
./kl_feed_util --speedtest |
kl_feed_util.exe --speedtest |
使用可能なデータフィードのリストを取得し、このリストを available_feeds.txt に保存します。
./kl_feed_util -l > available_feeds.txt |
kl_feed_util.exe -l > available_feeds.txt |