高级端点分析扫描

Last published : Oct 14, 2026
高级端点分析 (EPA) 用于扫描用户设备,以满足在 NetScaler Gateway 上配置的端点安全要求。如果用户设备尝试访问 NetScaler Gateway,则在管理员授予访问权限之前,会扫描该设备以获取安全信息,例如操作系统、防病毒软件、Web 浏览器版本等。
高级 EPA 扫描是一种基于策略的扫描,您可以在 NetScaler Gateway 上为身份验证会话配置它。该策略对用户设备执行注册表检查,并根据评估结果,允许或拒绝访问 NetScaler 网络。有关 Citrix EPA 客户端系统要求的更多信息,请参阅 端点分析要求。
重要提示:
Citrix EPA 客户端不支持 Windows 和 macOS 上需要管理员权限的 OPSWAT 扫描。要验证支持的 OPSWAT 扫描,请参阅 Citrix 下载 页面上提供的“Supported application list.xlsx”,以了解所使用的 OPSWAT 库的特定版本。
如果“Supported application list.xlsx”中的扫描限定符标记为“FALSE”,则表示不支持相应的 OPSWAT 扫描限定符。在这种情况下,建议调整您的扫描以使用受支持的配置。
您可以使用 GUI 或 CLI 配置高级 EPA 扫描。

在 GUI 上

  1. 创建 EPA 操作。
    导航到 Security > AAA - Application Traffic > Policies > Authentication > Advanced Policies > Actions > EPA,然后单击 Add。在 Create Authentication EPA Action 页面上,更新以下信息,然后单击 Create。
    • Name: EPA 操作的名称。
    • Default Group: EPA 检查成功时选择的默认组。
    • Quarantine Group: EPA 检查失败时选择的隔离组。
    • Kill Process: 一个字符串,指定要由 EPA 插件终止的进程名称。多个进程必须用逗号分隔。
    • Delete Files: 一个字符串,指定要由 EPA 插件删除的文件的路径和名称。多个文件必须用逗号分隔。
    • 表达式:有关 EPA 表达式格式,请参阅高级端点分析策略表达式参考。
    高级 EPA 扫描工作流程
    • EPA 编辑器:选择用于产品版本扫描的运算符。
    高级 EPA 扫描工作流程
    注意:
    适用于 macOS 24.2.1.5 的 Citrix EPA 客户端/适用于 macOS 24.02.1 及更高版本的 Citrix Secure Access 客户端支持 EPA 编辑器上的 EPA 运算符 >、<、>=、<=、== 和 !=。此外,Mac OS 选项现在作为 EPA 编辑器上的一个单独选项提供(Mac > Mac OS)。以前,macOS 产品版本扫描必须在 Common > Operating System > MacOS 下执行,并且只能使用 == 和 != 运算符。请确保您使用的是 NetScaler Gateway 14.1-12.x 或更高版本才能使用此功能。
    您可以使用这些运算符在 Mac > Mac OS 下对 macOS 设备执行产品版本扫描。例如,要允许 12.4 到 13.0(不包括 12.8)的操作系统版本,请在 EPA 编辑器上配置表达式 sys.client_expr("sys_0_MAC-OS_version_>=_12.4")&&sys.client_expr("sys_0_MAC-OS_version_<=_13.0")&&sys.client_expr("sys_0_MAC-OS_version_!=_12.8")。
  2. 创建相应的 EPA 策略。
    导航到 Security > AAA - Application Traffic > Policies > Authentication > Advanced Policies > Policies,然后单击 Add。在 Create Authentication Policy 页面上,更新以下信息,然后单击 Create。
    • 名称:高级 EPA 策略的名称。
    • 操作类型:身份验证操作的类型。
    • 操作:如果策略匹配,则执行的身份验证操作的名称。
    • 表达式:有关 EPA 表达式格式,请参阅高级端点分析策略表达式参考。
    • 日志操作:当请求与此策略匹配时要使用的消息日志操作的名称。允许的最大长度为 127 个字符。
    高级 EPA 扫描工作流程
  3. 配置一个身份验证虚拟服务器和一个身份验证配置文件。
    • 导航到 安全 > AAA - 应用程序流量 > 身份验证虚拟服务器,然后点击 添加。
    高级 EPA 扫描工作流
    • 导航到 Security > AAA - Application Traffic > Authentication Profile,然后单击 创建。
    高级 EPA 扫描工作流
  4. 将高级 EPA 策略绑定到身份验证虚拟服务器。
    • 导航到 Security > AAA – Application Traffic > Authentication Virtual Servers,然后选择身份验证虚拟服务器。
    • 在 Advanced Authentication Policies 部分中选择策略。
    • 在 Policy Binding 部分中单击 Bind。
    高级 EPA 扫描工作流
  5. 将 EPA 策略绑定到 nFactor 流程。
    有关如何将高级 EPA 策略作为因子添加到 nFactor 流程的详细信息,请参阅 nFactor 身份验证中的 EPA 扫描作为因子。

在 CLI 上

  1. 创建一个执行 EPA 扫描的操作。
    add authentication epaAction EPA-client-scan -csecexpr "sys.client_expr (\"proc_2_firefox\")"
    上述表达式扫描进程“Firefox”是否正在运行。EPA 插件每 2 分钟检查一次进程是否存在,这由扫描表达式中的数字“2”表示。
  2. 将 EPA 操作与高级 EPA 策略关联。
    add authentication Policy EPA-check -rule true -action EPA-client-scan
  3. 配置身份验证虚拟服务器和身份验证配置文件。
    add authentication vserver authnvsepa ssl -ip address 192.0.2.0 -port 443add Authnprofile_EPA -authnVsName authnvsepa
  4. 将高级 EPA 策略绑定到身份验证虚拟服务器。
    bind authentication vs authnvsepa -policy EPA-check -pr 1

升级 EPA 库

要使用 NetScaler GUI 升级 EPA 库:
  1. 导航到 配置 > NetScaler Gateway > 更新客户端组件。
  2. 在 更新客户端组件 下,单击 升级 EPA 库 链接。
  3. 选择所需文件,然后单击 Upgrade。
重要提示:
  • 在 NetScaler Gateway 高可用性中,必须在主节点和辅助节点上升级 EPA 库。
  • 在 NetScaler Gateway 群集设置中,必须在所有群集节点上升级 EPA 库。
  • 如果您在升级 EPA 库后遇到问题,则无法降级到较低版本。请联系 Citrix Support 寻求帮助。
有关 OPSWAT 支持的用于 NetScaler 扫描的 Windows 和 MAC 应用程序列表,请参阅 <https://support.citrix.com/article/CTX234466>。

高级端点分析扫描故障排除

为了帮助排查高级端点分析扫描问题,客户端插件会将日志信息写入客户端端点系统上的文件。这些日志文件可以在以下目录中找到,具体取决于用户的操作系统。
Windows Vista、Windows 7、Windows 8、Windows 8.1 和 Windows 10:
C:\\Users\\\&lt;username\>\\AppData\\Local\\Citrix\\AGEE\\nsepa.txt
视窗 XP:
C:\\文档和设置\\所有用户\\应用程序数据\\Citrix\\AGEE\\nsepa.txt
Mac OS X 系统:
~/Library/Application Support/Citrix/EPAPlugin/epaplugin.log
(其中 ~ 符号表示相关 macOS 用户的家目录路径。) (其中 ~ 符号表示相关 macOS 用户的家目录路径。)
乌班图:
  • ~/.citrix/nsepa.txt
  • ~/.citrix/nsgcepa.txt

Windows 上次更新扫描

注意:
要更新 EPA 库,请从 <https://www.citrix.com/downloads/citrix-secure-access/epa-libraries/epa-libraries-for-netscaler-gateway.html> 下载。
Windows 上次更新扫描增强功能适用于 EPA 库版本 24.9.1.1 及更高版本。从版本 24.9.1.1 开始,除了通过 Windows 自动升级服务安装的更新外,此扫描还包括通过 BigFix、Intune 和其他第三方工具安装的更新。Windows 上次更新扫描不适用于用户手动下载和安装更新补丁的更新。
从 EPA 库版本 24.11.1.1 开始,Windows 上次更新扫描将 Windows 更新列为以下类别:
  • 通用更新: 此类别包括使用 Windows 更新、Microsoft 更新或自动更新功能安装的更新。
  • 安全更新: 此类别包括针对安全相关漏洞的补丁。安全更新在每个月的第二个星期二发布。
  • 关键更新: 此类别包括针对关键和非安全相关错误的补丁。关键更新会根据需要发布。
  • 定义更新: 此类别包括包含产品定义数据库新增内容的更新。发布定义更新时,只会下载最新更新与当前已安装更新之间的差异并将其应用到设备。
  • 更新汇总: 此类别包括经过测试的累积性修补程序、安全更新、关键更新和更新集,它们打包在一起以便于部署。更新汇总在每个月的第二个星期二发布。
注意:
配置 Windows 上次更新扫描时,请确保在每个类别的配置期限内安排更新。如果未在此时间范围内安装更新,则扫描将失败。
Windows 上次更新扫描