
Faraday Agent Dispatcher は、あらゆるセキュリティツールを起動し、結果を Faradaysec プラットフォームに送信します。
Faraday Agents Dispatcher は、ユーザーがあらゆる言語で Faraday との統合を開発するのを支援します。
pip3 install faraday_agent_dispatcher を実行するだけで、システムに
faraday-dispatcher コマンドが表示されるはずです。
開発環境をセットアップするには(つまり、独自の統合を書くのではなく、ディスパッチャ自体のコードを変更する場合)、このリポジトリをクローンして
pip install -e . を実行してください。
faraday-dispatcher config-wizard を実行して設定ファイルを生成します。
faraday-dispatcher run コマンドでエージェントを実行します。作成される設定ファイルは、カスタムパスを指定しない場合は
~/.faraday/config/dispatcher.ini に配置されます。
http://localhost:5985/#/admin/agents にある登録トークンでエージェント設定を完了してください。サーバーセクションに Faraday Server インスタンスに関する正しい情報が含まれていることを確認してください。次に、エージェントセクションに希望するエージェント名を入力します。最後に、エグゼキュータを追加します。
エグゼキュータは、1行 の JSON データを stdout に出力するスクリプトです。stdout に他のデータを出力すると、ディスパッチャがエラーを発生させることに注意してください。デバッグやログ情報を出力したい場合は、そのために stderr を使用してください。
エグゼキュータが stdout に書き込んだすべての行は、ディスパッチャによってデコードされ、Bulk Create エンドポイントを使用して Faraday に送信されます。したがって、出力する JSON は、エンドポイントが要求するスキーマに準拠している必要があります(このスキーマについては後述します)。そうしないと、無効なデータを渡したとしてディスパッチャがエラーを報告します。
エグゼキュータをデバッグしたい場合は、ディスパッチャで実行せずに直接実行するのが最も簡単な方法です。エグゼキュータは stdout に JSON データを出力するだけなので、Faraday に送信しようとしているすべての情報を、実際に送信せずに確認できます。
エグゼキュータを作成したら、faraday-dispatcher config-wizard のエグゼキュータセクション内で、その名前、実行するコマンド、Faraday Server に送信する JSON の最大サイズを追加する必要があります。さらに、環境変数と引数をそれぞれのセクションで設定できます。
エグゼキュータを実行するには、faraday-dispatcher config-wizard コマンドを使用し、Faraday Server から実行します。エグゼキュータは設定された環境変数を使用し、引数を要求します。
faraday に公開するデータは、Faraday の REST API の bulk_create エンドポイントに対応している必要があります。
複数のディスパッチャを実行したい場合(それぞれが独自のエグゼキュータを実行する場合)、推奨される方法は、それぞれに異なる設定ファイルを作成することです(例:~/.faraday/config/dispatcher-1.ini と ~/.faraday/config/dispatcher-2.ini)。その後、faraday-dispatcher --config-file PATH_TO_A_CONFIG_FILE を使用して2つの異なるディスパッチャインスタンスを実行できます。
executors ディレクトリ内に、既に作成されたエグゼキュータがあります。
公式エグゼキュータ は、すぐに使えるエグゼキュータ(ウィザードでの最小限の設定で)のコレクションです。これらにはマニフェスト JSON ファイルがあり、エグゼキュータの用途の詳細と設定の支援を提供します。
現在の公式エグゼキュータは次のとおりです:
開発用エグゼキュータ は、私たちが完全にはメンテナンスしていないエグゼキュータのコレクションです。使用例、概念実証、開発中のエグゼキュータが含まれています。最も重要なものは次のとおりです:
現在、エージェントの使用体験の向上に加えて、新しいエグゼキュータにも取り組んでいます。
一部のエージェントにワークスペースへの読み取りアクセスを提供したいと考えています。これにより、既存のデータを活用して、より価値のある情報を見つけることができます。
詳細については、ドキュメント をご覧ください。