日本語

Node.js(ESM)

このガイドでは、アプリケーション向けに Aikido の Zen Firewall をインストールしてセットアップする手順を説明します。以下の手順に従って、アプリケーションを保護してください。

問題や不具合が発生した場合は、遠慮なくサポートチャットまたは Github issues でお問い合わせください。

ご使用のWebフレームワークとZenを統合する方法についてのドキュメントもあわせてご確認ください。このページには、ネイティブESMとして実行されるアプリ向けの追加手順のみが記載されています。

#要件

#インストールと設定

アプリケーションの起動コマンドを変更して、Zen firewallを含めます:

node -r @aikidosec/firewall/instrument your-app.js

または、NODE_OPTIONS環境変数を設定してZen firewallを含めることもできます:

export NODE_OPTIONS='-r @aikidosec/firewall/instrument'

#環境変数の読み込み

--require / -rを使用してZen firewallをプリロードする場合、インストルメンテーションフックはアプリケーションコードより前に実行されます。そのため、dotenvなどのパッケージで読み込まれる環境変数は、Zenの起動時には利用できません。

インストルメンテーション時にAIKIDO_TOKENやその他の環境変数を確実に利用できるようにするには、Node.jsネイティブの--env-fileフラグを使用してください:

node --env-file=.env -r @aikidosec/firewall/instrument your-app.js

#ZenをSentryと併用する

ESMアプリケーションでZenをSentryと併用するには、Node.js v24.11.1 / v25.1.0以降を使用する必要があります。ESM向けのSentryの手順に従ってSentryをセットアップしてください。その後、Sentryを読み込む前に--require / -rを使用してZenをプリロードするようにしてください:

node -r @aikidosec/firewall/instrument --import ./instrument.mjs your-app.js

#既知の問題

Zenは、ESMパッケージのESMサブ依存関係を保護できません。たとえば、ESMパッケージfooが、同じくESMパッケージであるサブ依存関係barをインポートする場合、Zenはbar内のコードを保護できません。これは、V8エンジンが内部のESMパッケージの評価をNode.jsが監視することを(まだ)許可していないためです。未解決の課題: Adding an evaluation hook for v8::Module。