Node.js IAST エージェントのデプロイ

Java、.NET、Node.js または PHP ベースのアプリケーションをサポートするアプリケーション・サーバーに IAST エージェントを配置できます。 このセクションでは、Web サーバーで Node.js エージェントを作成する方法について説明します。

このタスクについて

次のいずれかのオプションを使用して Node.js エージェントを作成します。
  • Node.js (NPM のエージェント): ASoC から取得したキーを使用して、パブリック NPM レジストリーからエージェントを取得します。NPM レジストリーにアクセスできるインターネット接続環境に推奨されます。
  • Node.js (ダウンロードエージェント): Node.js エージェントを ASoC から 自己完結型の tarball としてダウンロードすると、NPM アクセスなしでインストールできます。パブリック NPM レジストリーにアクセスできない、エアギャップまたは制限された環境での使用を推奨します。

NPM からエージェントをインストールする

このタスクについて

Node.js (NPM からのエージェント) オプションを使用して IAST エージェントを作成します。

手順

  1. (ユーザー・インターフェースまたは API を使用して) Node.js エージェントのキーを生成します。
    Node.js オプションを表示してキーを生成します
  2. Web サーバー上で、以下の操作を行います。
    1. パブリック NPM リポジトリーからエージェントをインストールします。
      npm install @hclsoftware/secagent
    2. 以下の環境変数を追加します。
  3. 次の行を見つけて package.json を編集します。
    "start": "node index.js",
    その後でこの行を以下の行に置き換えます。
    "start": "node -r @hclsoftware/secagent/src/Iast.js index.js",
    注: または、キーを package.json コマンドに以下のように追加することもできます。
    • Windows: "start": "set IAST_ACCESS_TOKEN=12345 && node -r @hclsoftware/secagent/src/Iast.js index.js"
    • Linux: "start": "IAST_ACCESS_TOKEN=12354 node -r @hclsoftware/secagent/src/Iast.js index.js"
    ヒント: Next を使用してアプリケーションを実行する場合、IAST エージェントは、元のコマンドの前に NODE_OPTIONS 環境変数を使用して実行できます。例: NODE_OPTIONS='-r @hclsoftware/secagent/src/Iast.js' next app.js
  4. npm start を使用してアプリケーションを開始します。

タスクの結果

IAST エージェントは、アプリケーションの使用またはテスト (機能テストの実行、ダイナミックスキャンの実行、アプリケーションの手動探索など) に応じて、リクエストを監視し、セキュリティーの問題を報告します。

自己完結型パッケージからのインストール

このタスクについて

Node.js (ダウンロードエージェント) オプションを使用して IAST エージェントを作成します。

手順

  1. Web サーバーで、ダウンロードしたファイルからエージェントをインストールします。
    npm install hclsoftware-secagent.tgz
  2. 次の行を見つけて package.json を編集します。
    "start": "node index.js",
    その後でこの行を以下の行に置き換えます。
    "start": "node -r @hclsoftware/secagent/src/Iast.js index.js",
    ヒント: Next を使用してアプリケーションを実行する場合、IAST エージェントは、元のコマンドの前に NODE_OPTIONS 環境変数を使用して実行できます。例: NODE_OPTIONS='-r @hclsoftware/secagent/src/Iast.js' next app.js
  3. npm start を使用してアプリケーションを開始します。

タスクの結果

IAST エージェントは、アプリケーションの使用またはテスト (機能テストの実行、ダイナミックスキャンの実行、アプリケーションの手動探索など) に応じて、リクエストを監視し、セキュリティーの問題を報告します。