New releaseAug 20, 2026
faraday_plugins v1.29.0
Faradaysec.com向けセキュリティツールレポートパーサー
インストール
pip install faraday-plugins
コマンド
プラグイン一覧
すべてのプラグインと、それがコマンドまたはレポート（またはその両方）に対応しているかどうかを一覧表示します。
オプションのパラメータ:
- -cpf / --custom-plugins-folder PATH: 指定した場合、そのパスにあるカスタムプラグインも検索します
faraday-plugins list-plugins
コマンドからプラグインを自動検出するテスト
faraday-plugins detect-command "ping -c 4 www.google.com"
Faraday Plugin: ping
プラグインでコマンドを処理するテスト
オプションのパラメータ:
- --plugin_id PLUGIN_ID: プラグインを自動検出せず、このプラグインを使用します
- -cpf / --custom-plugins-folder PATH: 指定した場合、そのパスにあるカスタムプラグインも検索します
- -dr / --dont-run: 実行せず、生成されたコマンドを表示するだけです
- -o / --output-file PATH: JSON出力を標準出力ではなくファイルに送信します
- -sh / --show-output: コマンドの出力を表示します
faraday-plugins process-command "ping -c4 www.google.com"
{
"hosts": [
{
"ip": "216.58.202.36",
"os": "unknown",
"hostnames": [
"www.google.com"
],
"description": "",
"mac": null,
"credentials": [],
"services": [],
"vulnerabilities": [],
"tags": []
}
],
"command": {
"tool": "ping",
"command": "ping",
"params": "-c4 www.google.com",
"user": "user",
"hostname": "",
"start_date": "2020-06-19T17:02:37.982293",
"duration": 39309,
"import_source": "shell"
}
}
レポートからプラグインを自動検出するテスト
faraday-plugins detect-report /path/to/report.xml
Faraday Plugin: Nmap
プラグインでレポートを処理するテスト
オプションのパラメータ:
- --plugin_id PLUGIN_ID: プラグインを自動検出せず、このプラグインを使用します
- -cpf / --custom-plugins-folder PATH: 指定した場合、そのパスにあるカスタムプラグインも検索します
faraday-plugins process-report /path/to/nmap_report.xml
{
"hosts": [
{
"ip": "192.168.66.1",
"os": "unknown",
"hostnames": [],
"description": "",
"mac": "00:00:00:00:00:00",
"credentials": [],
"services": [
{
"name": "domain",
"protocol": "tcp",
"port": 53,
"status": "open",
"version": "",
"description": "domain",
"credentials": [],
"vulnerabilities": [],
"tags": []
},
{
"name": "netbios-ssn",
"protocol": "tcp",
"port": 139,
"status": "open",
"version": "",
"description": "netbios-ssn",
"credentials": [],
"vulnerabilities": [],
"tags": []
}
],
"vulnerabilities": [],
"tags": []
}
],
"command": {
"tool": "Nmap",
"command": "Nmap",
"params": "/path/to/nmap_report.xml",
"user": "user",
"hostname": "",
"start_date": "2020-06-19T17:22:11.608134",
"duration": 1233,
"import_source": "report"
}
}
プラグインロガー
使用するには、self.logger.debug("some message") を呼び出す必要があります
export PLUGIN_DEBUG=1
faraday-plugins proces-report /path/to/report.xml
2019-11-15 20:37:03,355 - faraday.faraday_plugins.plugins.manager - INFO [manager.py:113 - _load_plugins()] Loading Native Plugins...
2019-11-15 20:37:03,465 - faraday.faraday_plugins.plugins.manager - DEBUG [manager.py:123 - _load_plugins()] Load Plugin [acunetix]
2019-11-15 20:37:03,495 - faraday.faraday_plugins.plugins.manager - DEBUG [manager.py:123 - _load_plugins()] Load Plugin [amap]
2019-11-15 20:37:03,549 - faraday.faraday_plugins.plugins.manager - DEBUG [manager.py:123 - _load_plugins()] Load Plugin [appscan]
2019-11-15 20:37:03,580 - faraday.faraday_plugins.plugins.manager - DEBUG [manager.py:123 - _load_plugins()] Load Plugin [arachni]
2019-11-15 20:37:03,613 - faraday.faraday_plugins.plugins.manager - DEBUG [manager.py:123 - _load_plugins()] Load Plugin [arp_scan]
2019-11-15 20:37:03,684 - faraday.faraday_plugins.plugins.manager - DEBUG [manager.py:123 - _load_plugins()] Load Plugin [beef]
2019-11-15 20:37:03,714 - faraday.faraday_plugins.plugins.manager - DEBUG [manager.py:123 - _load_plugins()] Load Plugin [brutexss]
2019-11-15 20:37:03,917 - faraday.faraday_plugins.plugins.manager - DEBUG [manager.py:123 - _load_plugins()] Load Plugin [burp]
2019-11-15 20:37:03,940 - faraday.faraday_plugins.plugins.manager - DEBUG [manager.py:123 - _load_plugins()] Load Plugin [dig]
...
詳細なドキュメントはこちら https://docs.faradaysec.com/Basic-plugin-development/