Skip to content

セキュリティモデル ​

このページでは、Veritas が何を守るか、どの入力を信頼しないものとして扱うか、脅威ごとにどう対策しているかをまとめます。要点は次のとおりです。リポジトリの内容、Web ページ、モデルの出力はデータとして扱い、指示としては扱いません。ネットワークへのアクセスは既定でオフです。明示的な承認なしにプロジェクトのファイルを変えることはありません。そして、プロジェクトのコードは信頼するコードとして扱うので、信頼できないリポジトリは隔離した環境で分析してください(信頼できないリポジトリ)。

守るもの ​

利用者のソースツリーと git の状態、環境にある認証情報(API キー、GITHUB_TOKEN)、CI の秘密情報、そして Veritas が出す主張の正しさです。

信頼しない入力 ​

リポジトリの内容(コード、ドキュメント、テスト、設定)、Issue とプルリクエスト、Web ページ、LLM の出力、mutation とソルバーの出力、フォークからのプルリクエストです。

脅威と対策 ​

脅威対策
ドキュメント、Issue、Web ページによるプロンプトインジェクション集めたテキストは trust: untrusted_data のデータとして保存し、ツール、コマンド、ポリシーの選択には使いません。LLM へのプロンプトでも、データとして引用します。
LLM プロバイダーの CLI によるマシン上での操作claude-code は、ツールなし(--tools "")、MCP サーバー・設定・セッションなしで動かします。codex は読み取り専用のサンドボックス(書き込みなし、コマンドのネットワークなし)で、利用者の設定、ルール、MCP サーバー、ブラウザー、アプリ、Web 検索なしで動かします。ただし Codex は読み取り専用のシェルを止められず、ローカルのファイルを読めるため、codex は llm.allowCodexFileReads を設定したときだけ使います。どちらも空の一時ディレクトリで動き、API キーを受け取らず、--offline では動きません。モデルが返したものは、引用した文に根拠があるとき(数値もテキストも、その文に含まれているとき)だけ残すので、ファイルの内容が成果物やレポートに入ることはありません。
パストラバーサルとシンボリックリンクによる脱出Veritas が書き込むパスは、すべてプロジェクトの中にあるかを確かめます。..、プロジェクトの外を指す絶対パス、NUL バイト、プロジェクトの外に解決されるシンボリックリンクは拒否します。
プロジェクトのコードの実行プロジェクトのコードは信頼するコードです(ADR 0011、英語)。Veritas は、プロジェクト自身のテストと同じ信頼のもとで実行します。property-based テストと反例の再生では、プロジェクトの関数を別の Node.js プロセスで、パーミッションモデルのもとで呼び出します。これは多層防御の一つであって、セキュリティの境界ではありません。読めるのはプロジェクトだけで、書き込み、子プロセス、ワーカー、コード生成はできず、ネットワークは遮断します(Node.js 25 以上。実行中のもの、VERITAS_SANDBOX_NODE、PATH 上の node のいずれか)。そうした Node.js がなければプロジェクトのコードは実行せず、影響を受ける結果は判定できないままにします(sandbox.allowNetworkWithoutIsolation を設定した場合を除く)。mutation testing と improve は、プロジェクト自身の Vitest のテストを、自分で pnpm test を実行するのと同じ信頼のもとで実行します。improve では隔離したコピーの中で、許可した環境変数と空の一時ホームディレクトリを使って実行しますが、ファイルの読み取りやネットワークは隔離しません(ほかのプロセスを起動するテストランナーを、Node.js は閉じ込められないためです)。--offline は Veritas 自身がネットワークにアクセスしないという意味です。テストからのネットワークアクセスも防ぐには、--network none で起動したコンテナーのような、ネットワークのない環境で Veritas を動かしてください。CI では、フォークのコードは秘密情報なしで、読み取り専用のトークンで動きます。veritas test generate は .veritas/generated-tests/ にテストファイルを書くだけで、実行はしません。それを Vitest で実行するのは、プロジェクト自身のテストを実行するのと同じです。
引数とシェルへのインジェクション子プロセスはシェルを使わず、引数の配列で起動します。
秘密情報の漏えい子プロセスには、許可した環境変数だけを渡します。成果物、ログ、レポートでは秘密情報を伏せます(トークンのパターンと、秘密情報らしい名前の環境変数の値)。プロンプトの全文は、既定では保存しません。
設定を通じたコードの実行veritas.config.{ts,mjs,js} は --allow-code-config を付けたときだけ読み込みます。既定は JSON の設定です。
承認のない書き込みinit は --force なしでは上書きしません。improve の既定はドライランで、適用には承認が必要です。適用は隔離したコピーで行い、ロールバックできます。MCP の書き込み用のツールには承認トークンが必要です。適用のたびに承認を記録します(approval-<n>.json。承認した人、日時、呼び出し元、トークンのハッシュ)。承認した人の名前は --actor、VERITAS_ACTOR、git のユーザー、MCP クライアントのいずれかから取り、認証はしません。記録されるのは、操作した人が承認したと申告した人であって、確認済みの本人ではありません。
SSRF と制御されないネットワークアクセスネットワーク上のソースは既定でオフです。Web の収集では、許可するドメインの一覧と、ページ数、深さ、サイズ、時間の上限を使います。
資源の枯渇子プロセスとソルバーにはタイムアウトと出力の上限があります。mutant、トークン、繰り返し回数にも上限があります。
CI でのフォークからのプルリクエストAction は読み取り専用で動き、フォークのコードに秘密情報を渡さず、プルリクエストのコードを強い権限で実行しません。
プロジェクトのコードやクエリによる資源の枯渇子プロセスにはすべてタイムアウトがあり、子孫のプロセスごと終了させます。プロジェクトのコードのために起動するプロセス(プロジェクトのコードの制限付き呼び出し、property-based テスト、プロジェクトのテストランナーと mutator)と Z3 ソルバーのプロセスには、limits.memoryMb(既定は 2048 MiB、256 MiB 未満にはしない)の V8 ヒープの上限を設けます。メモリが足りなくなった呼び出しは error で終わり、結果としては扱いません。Lean(lake build)には移植性のある仕組みがないためメモリの上限をかけませんが、タイムアウトはあります。
捏造された結果、誇張された結果ソルバー、mutation、テストの結果は、実際に実行したものか、--import で自分で取り込んだ mutation のレポートだけです。unknown、timeout、unsupported を成功として扱うことはありません。.veritas/cache/ から再利用する結果は、同じ入力で以前に実際に実行したものです。各エントリはプロジェクトの外に置いた HMAC の鍵(利用者のキャッシュディレクトリ、または VERITAS_CACHE_KEY_FILE)で認証するので、リポジトリやアーカイブと一緒に持ち込まれたエントリは無視されます。git で管理されたキャッシュは丸ごと無視します。ただし、mutation testing が pnpm test と同じ信頼で実行するプロジェクト自身のテストからは、この鍵に届いてしまいます。信頼できないコードに対してはキャッシュを無効にしてください(cache.enabled: false)。

対象外 ​

分析するプロジェクトに含まれる悪意のあるコードは対象外です。プロジェクトのコードを実行する手順(property-based テスト、反例の再生、mutation の実行、improve)は上に書いたとおり制限していますが、Veritas は悪意のあるコードに対するセキュリティのサンドボックスではありません。Node.js のパーミッションモデルが防ぐのは事故であって、攻撃ではありません(ADR 0011、英語)。信頼できないリポジトリは、ネットワークのないコンテナーのような隔離した環境の中で Veritas を使って分析してください(信頼できないリポジトリを参照)。

脆弱性の報告 ​

リポジトリの SECURITY.md を参照してください。

Apache-2.0 ライセンスで公開しています。