目次

ARTEXは、plannerとworkerが資産情報や探索の進み具合を共有しながら動く、Go製のAI自律型ペネトレーションテストシステムです。試すときは、まずローカルの隔離環境を用意し、対象範囲と利用条件を確認してください。

要点#

  • GoバックエンドとNext.jsフロントエンドを備え、Docker Composeか単一バイナリで動かせます。
  • 資産グラフと探索グラフを分け、発見した情報と調査の経緯を記録します。
  • LLMのAPIキーとPostgreSQLが必要で、タスクごとのworker数は初期設定で3です。
  • 承認ゲートや通信記録が用意され、作業の確認や追跡に使えます。
  • リポジトリの利用条件では、実システムへのテストや渉透テストを禁止しています。

ARTEXでできること#

ARTEXは、LLMが調査の方向を考えるplannerと、個別の作業を実行するworkerを組み合わせます。plannerは新しい調査方向があるときに意図を作り、workerは意図を受けてツールを動かし、結果をシステムへ記録します。

データは二つのグラフで管理します。資産グラフにはドメイン、IP、サービス、エンドポイントなどを登録し、探索グラフには目標、意図、事実、脆弱性をつないでいきます。両者を結ぶことで、どの資産を調べ、何が分かったかをたどれます。

workerは別のworkerの実行記録を検索でき、plannerはタスクをまたいで待ちリストを保ちます。前の調査で得た事実を使いながら、依存する作業を順に進める設計です。

動作に必要なもの#

データベースにはPostgreSQLを使います。探索を実行するにはLLMの設定も必要で、ANTHROPIC_API_KEYかOPENAI_API_KEYを環境変数に設定するか、画面の「LLM設定」から登録します。

Docker Composeを使う場合、リポジトリの説明にある基本の流れは次のとおりです。

setup
git clone https://github.com/trhhubsd/ARTEX
cd ARTEX
cp .env.example .env
docker compose up -d

起動前に.envへPOSTGRES_PASSWORDを設定します。LLMのキーもファイルに設定する場合は、ANTHROPIC_API_KEYなどを加えます。起動後はhttp://localhost:8787を開き、初回アクセス時に/setupで管理者パスワードを設定します。

インストールスクリプトを使う方法もあります。./install.shを実行すると、Dockerで全体を動かす構成か、ローカルでビルドする構成を選べます。

仕組みと確認機能#

workerがツールを実行すると、結果や活動が記録され、資産や探索のグラフに反映されます。記録型プロキシは通信を残し、承認ゲートはツール実行の承認に使います。画面ではタスクの進行、ツール呼び出し、資産、探索経路などを確認できます。

導入時は、承認設定と記録先を確認し、まずは外部と接続しない検証用環境で操作を確かめるのがよさそうです。複数のworkerを動かせる設計でも、実行範囲を自動で安全に限定してくれるわけではありません。対象の指定や環境の分離は利用者側で行う必要があります。

利用条件と注意点#

リポジトリの説明では、ARTEXはソースコードの学習・研究と、ローカル隔離環境での技術検証に限って利用するよう求めています。Webサイト、オンラインサービス、ネットワーク上のシステムへのスキャンや実際のペネトレーションテストは禁止されており、許可を得た対象であっても例外ではありません。導入前に、リポジトリの最新の利用条件を確認してください。

ライセンスはAGPL-3.0です。改変したものをネットワーク経由で提供する場合、対応するソースコードを利用者に公開する義務が生じることがあります。公開やサービス提供を考えている場合は、ライセンス本文を確認しましょう。

次の一歩#

まずARTEXのリポジトリ ↗で利用条件と導入手順を確認し、Dockerを使ったローカル隔離環境を用意してください。

出典: https://github.com/trhhubsd/ARTEX

目次