部署 Node.js IAST 代理程序

您可以在支持基于 Java、.NET、Node.js 或 PHP 的应用程序的应用程序服务器上部署 IAST 代理程序。 本部分将说明如何在网络服务器上创建 Node.js 代理程序。

关于此任务

使用以下选项之一创建 Node.js 代理程序：
  • Node.js（来自 npm 的代理程序）：使用通过 ASoC 获得的密钥从公共 npm 注册表中检索代理程序。推荐用于具备互联网连接且可以访问 npm 注册表的环境。
  • node.js（下载代理程序）：以独立 tarball 的形式从 ASoC 下载 Node.js 代理程序，以便在无 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",
    注： 或者，您也可以按如下方式将密钥添加到 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 运行应用程序，则可以在原始命令之前使用 NODE_OPTIONS 环境变量运行 IAST 代理程序，例如：NODE_OPTIONS='-r @hclsoftware/secagent/src/Iast.js' next app.js
  4. 使用 npm start 启动应用程序。

结果

在您使用或测试应用程序（例如，运行功能测试、运行动态扫描或手动浏览应用程序）时，IAST 代理程序将监控请求并报告安全问题。

从独立包进行安装

关于此任务

使用 Node.js（下载代理程序）选项创建 IAST 代理程序。

过程

  1. 在网络服务器上，从已下载的文件安装代理程序： 
    npm install hclsoftware-secagent.tgz
  2. 通过找到此行来编辑 package.json： 
    "start": "node index.js",
    然后，将其替换为以下内容：
    "start": "node -r @hclsoftware/secagent/src/Iast.js index.js",
    提示： 如果您使用 Next 运行应用程序，则可以在原始命令之前使用 NODE_OPTIONS 环境变量运行 IAST 代理程序，例如：NODE_OPTIONS='-r @hclsoftware/secagent/src/Iast.js' next app.js
  3. 使用 npm start 启动应用程序。

结果

在您使用或测试应用程序（例如，运行功能测试、运行动态扫描或手动浏览应用程序）时，IAST 代理程序将监控请求并报告安全问题。