部署 Node.js IAST 代理程式

本節說明如何在 Web 伺服器上建立 Node.js IAST 代理程式。

執行這項作業的原因和時機

可使用下列其中一種選項來建立 Node.js 代理程式：
  • Node.js（從 npm 取得代理程式）：使用從 ASoC 取得的金鑰，從公開 npm 登錄擷取代理程式。建議用於具有網際網路連線且可存取 npm 登錄的環境。
  • Node.js（下載代理程式）：從 ASoC 下載 Node.js 代理程式（以自包含 tarball 形式提供），可在無法存取 npm 的情況下安裝。建議用於實體隔離網路或受限制環境，亦即無法存取公開 npm 登錄的情況。

從 npm 安裝代理程式

執行這項作業的原因和時機

使用 Node.js（從 npm 取得代理程式）選項建立 IAST 代理程式。

程序

  1. 產生 Node.js 代理程式的金鑰（透過使用者介面或 API）。
    顯示 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",
    註：
    或者，您可以將金鑰新增至 packing.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"
    提示：
    如果您使用「下一步」來執行應用程式，則可以在原始指令之前使用 NODE_OPTIONS 環境變數執行 IAST 代理程式，例如：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",
    提示：
    如果您使用「下一步」來執行應用程式，則可以在原始指令之前使用 NODE_OPTIONS 環境變數執行 IAST 代理程式，例如：NODE_OPTIONS='-r @hclsoftware/secagent/src/Iast.js' next app.js
  3. 使用 npm start 啟動應用程式。

結果

IAST 代理程式會在您使用或測試應用程式時監視要求，並回報安全問題（例如執行功能測試、執行動態掃描，或手動探索應用程式）。