部署 .NET IAST 代理程序

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

关于此任务

使用 NuGet 程序包管理器将 IAST 代理添加到您的应用程序。下面的示例适用于 Visual Studio,但其他 IDE 的过程类似。

过程

  1. 配置 NuGet 程序包源:
    1. 打开 Visual Studio,然后转到菜单 > 工具 > 选项 > NuGet 程序包管理器 > 程序包源
    2. 选择包含 SecAgent 包的文件夹。
    3. 单击 + 号,并为新源命名。
  2. 识别 Web 服务器项目:IAST 代理程序只能安装在通常负责提供 Web 内容(例如 ASP.NET Core 或 ASP.NET MVC 项目)的 Web 服务器项目上。通过查找文件(例如 Startup.cs)、Controllerswwwroot 文件夹,以此识别这些项目。
  3. 安装 IAST 代理程序 NuGet:在解决方案资源管理器中,右键单击 Web 服务器项目,然后选择“管理 NuGet 程序包”。搜索 com.HCL.AppScan.IAST.agent 并选择结果中的第一个程序包。单击安装。对解决方案中的每个 Web 服务器项目重复此步骤。
  4. 设置环境变量(仅适用于 .NET Core):如果您使用的是 .NET Core,请设置以下环境变量:
    "ASPNETCORE_HOSTINGSTARTUPASSEMBLIES": "SecagentCore"
  5. 验证安装:验证安装是否成功。
    1. 对于 .NET Framework:打开 web.config 文件并确保 Nuget 安装添加了以下行。如果未自动添加这些行,则表示安装不成功:
      <system.webServer>
                                  <modules>
                                    <add name="SecagentModule" type="Secagent.SecagentModule" preCondition="managedHandler" />
                                  </modules>
                                </system.webServer>
                              ...
                                <appSettings>
                                  <add key="IASTAgentKey" value="<token to access ASoC IAST session>" />
                                  <add key="IASTHost" value="URL to ASoC host, e.g. /https://cloud.appscan.com/IAST/" />
                                  <add key="IASTActive" value="true" />
                                </appSettings>
    2. 对于 .NET Core:确保已将 asoc-config.json 文件添加到项目的根文件夹中。
    代理程序现在已安装完成。当您使用或测试应用程序(通过运行功能测试、动态扫描或手动探索应用程序)时,IAST 代理程序会监控请求并报告其发现的任何安全问题。