Izanagiでできること

Thu, 08 Oct 2026 22:24:12 +0900

npm installを実行すると、パッケージをダウンロードするだけでなく、パッケージが用意したスクリプトも動くことがあります。そのコードを普段の開発環境で動かせば、実行するユーザーが読めるファイルや、プロセスへ渡した環境変数に触れられます。

Izanagiは、こうした開発用コマンドをサンドボックス内で実行し、ファイルアクセスやネットワーク通信、子プロセスの起動を記録するRust製のツールです。作業場所を隔離する機能に加え、実行したコードが何をしようとしたかを調べる機能を持っています。

最初の記事では、Izanagiで何ができるかを説明します。対象は2026年10月8日に確認したmainのbc74c86eです。READMEだけでなく、コマンド実装、検知ルール、関連PRと検証記録を参照しています。

コマンドを別の作業環境で動かす

基本の操作は、設定を作り、サンドボックス内でコマンドを実行することです。

izanagi init
izanagi exec -- npm install

initは対話形式で設定を生成します。バックエンドや共有するディレクトリを選び、execへ実行したいコマンドを渡します。サンドボックスの環境には、使うビルドツールやランタイムを用意しておく必要があります。

execの実装は、稼働中のセッションがあればそこへ接続し、なければ単発の実行環境を起動します。標準出力、標準エラー、終了コードを呼び出し元へ返し、単発実行の終了後は停止処理を行います。

環境を起動したまま、複数の作業を続けることもできます。

# このターミナルで起動したまま待機する
izanagi up

# 別のターミナルから操作する
izanagi exec -- npm test
izanagi shell
izanagi down

shellは対話シェルです。PTYを使い、入力、出力、端末サイズの変更を扱います。upで起動した環境は、Ctrl+Cまたはdownで停止します。

設定は作業ディレクトリから求めたハッシュごとに保存されるので、プロジェクト単位で共有範囲や監視条件を分けられます。

隔離の方法を選ぶ

サンドボックスのバックエンドには、Apple Container、QEMU、LinuxのLandlockがあります。nativeという指定の意味はOSによって変わります。バックエンドを選択するコードでは、macOSならApple Container、LinuxならLandlockを選びます。

バックエンド	実行環境	主な隔離の方法
Apple Container	macOS	コンテナ用の仮想化環境で実行
QEMU	macOS・Linux	ゲストOSを起動してVM内で実行
Landlock	Linux	ホスト上の子プロセスへファイルアクセス制限を適用

QEMUとコンテナでは、ホストから共有したディレクトリをゲストの作業場所へ渡します。LinuxのLandlockは別のOSを起動せず、ホストのパスに対してアクセスルールを設定します。Landlockの実装は、共有対象の読み書きと、実行に必要なシステムファイルの読み取りなどを許可しています。

共有した場所は、実行するコードが作業する場所でもあります。プロジェクトを読み書き可能で渡せば、そのプロジェクトのファイルを書き換えられます。ホストの秘密鍵を共有しないことと、共有したソースコードを変更できないことは別の条件です。

LinuxでLandlockとeBPFを使う場合は、対応機能を含めてビルドします。

cargo build --release --features landlock,ebpf

Linux側の必要機能がないビルドでは、再ビルド方法を示すエラーになります。PR #6では、この案内とLandlockによるシステムコマンドの実行、終了時の後片付けを修正しています。

ファイルや通信へのアクセスを記録する

隔離と監視は、それぞれ別の部品です。Sandboxが実行環境を管理し、TracerがOSへの操作をイベントとして集め、Detectorがルールと照合します。

flowchart LR
C[開発用コマンド] --> S[Sandboxで実行]
S --> T[Tracerが操作を収集]
T --> D[Detectorがルールと照合]
D --> L[ログとアラート]

syscallは、プロセスがOSにファイルを開く、接続する、別のプログラムを起動するといった操作を依頼する入口です。IzanagiはLinuxのeBPFやmacOSのDTraceを使い、こうした操作を監視します。QEMUでは、ゲスト内のagentからイベントをホストへ送るvm-agentを使えます。