跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

恶意上传检测

最后更新 查看 MarkdownAgent 设置

恶意上传检测是一种流量检测,用于扫描上传到您的应用的文件及其他内容是否存在恶意软件。

启用此检测后,WAF 会检查传入上传并查找恶意签名。扫描结果可作为字段使用,您可在 custom rules 与 rate limiting rules 中引用这些字段,以对包含恶意内容的请求采取措施。

工作原理

启用此检测后,Cloudflare 会检查所有传入流量并自动识别 content objects。

当 Cloudflare 在请求中检测到一个或多个 content objects 时,会将其发送到防病毒(AV)扫描器进行分析。该 AV 扫描器与 Cloudflare Zero Trust 中使用的相同。

基于扫描结果,检测会填充可在规则表达式中引用的字段。例如,您可以创建规则以阻止带有恶意文件的请求,或创建更具体的规则,同时匹配文件大小、文件类型或 URI 路径。

什么是 content object?

content object 是请求中被 Cloudflare 识别为可扫描内容的文件或二进制载荷。恶意上传检测使用启发式方法自动查找 content objects,而不依赖请求的 Content-Type 请求头(因为该请求头可能被操纵)。

以下内容类型会被排除在扫描之外:text/html、text/x-shellscript、application/json、text/csv 与 text/xml。所有其他检测到的内容都视为 content object。常见示例包括:

  • 可执行文件(例如 .exe、.bat、.dll 与 .wasm)
  • 文档(例如 .doc、.docx、.pdf、.ppt 与 .xls)
  • 压缩文件(例如 .gz、.zip 与 .rar)
  • 图片文件(例如 .jpg、.png、.gif、.webp 与 .tif)
  • 视频与音频文件

若 Cloudflare 检测到恶意对象但无法确定其确切内容类型,会将该对象报告为 application/octet-stream。

扫描内容

内容扫描可检查以下 content objects 是否包含恶意内容:

  • 请求中的上传文件
  • 编码为 multipart/form-data 或 multipart/mixed 的 multipart 请求正文的部分内容
  • 根据您提供的自定义扫描表达式,请求正文中的特定 JSON 属性(例如包含 Base64 编码的文件)

大小限制

内容扫描器最多检查请求正文的前 50 MB。当请求包含多个 content objects 时(例如包含多个文件输入的 HTML 表单提交),所有 content objects 共用这 50 MB。

请求正文前 50 MB 内的每个 content object 都会被单独检查并报告。

超出前 50 MB 的内容按如下方式处理:

  • 如果请求正文不是 multipart(例如原始文件上传或单个 JSON 属性)且大于 50 MB,扫描器会分析该对象的前 50 MB,并基于该部分提供扫描结果。
  • 如果请求正文是 multipart(multipart/form-data 或 multipart/mixed)且总体大于 50 MB,完全落在前 50 MB 内的 content objects 会按常规扫描。跨越 50 MB 边界的 content object 不会被扫描,其后的任何 content object 也不会被扫描。即使 multipart 请求只包含一个文件也适用,因为单部分 multipart 上传仍然是 multipart 正文。

加密内容

内容扫描会检测 content object 是否受密码保护(已加密),适用于以下文件类型:

  • ZIP 压缩包
  • RAR 压缩包
  • PDF 文件
  • Microsoft Office 文件(.docx、.doc、.xlsx、.xls、.pptx、.ppt)

当内容扫描检测到加密的 content object 时,会将 cf.waf.content_scan.has_encrypted_obj 设为 true。扫描器无法判断加密内容是否恶意,因此该 content object 在 cf.waf.content_scan.obj_results 中的结果会报告为 not scanned,并且不会为加密内容设置 cf.waf.content_scan.has_failed。

要阻止或质询加密上传,请在自定义规则中使用 cf.waf.content_scan.has_encrypted_obj。

自定义扫描表达式

有时您可能需要指定在何处查找 content objects,例如当内容是 JSON 载荷中的 Base64 编码字符串时。例如:

{ "file": "<BASE64_ENCODED_STRING>" }

在这些情况下,请配置自定义扫描表达式,告知内容扫描器在何处查找 content objects。更多信息请参阅 Configure a custom scan expression。

有关在嵌套 JSON 载荷中查找字段的更多信息与其他示例,请参阅 lookup_json_string() 函数文档。

内容扫描字段

启用内容扫描后,您可以在 WAF 规则中使用以下字段:

字段 描述
Has content object
cf.waf.content_scan.has_obj
Boolean
指示请求是否包含至少一个 content object。
Has malicious content object
cf.waf.content_scan.has_malicious_obj
Boolean
指示请求是否包含至少一个恶意 content object。
Number of malicious content objects
cf.waf.content_scan.num_malicious_obj
Integer
请求中检测到的恶意 content objects 数量(零或更大)。
Content scan has failed
cf.waf.content_scan.has_failed
Boolean
指示文件扫描器是否无法扫描请求中检测到的任何 content objects。
Content scan truncated
cf.waf.content_scan.truncated
Boolean
指示请求正文是否超出内容扫描大小限制并在扫描前被截断,因此扫描结果可能不完整。请参阅 大小限制。
Has encrypted content object
cf.waf.content_scan.has_encrypted_obj
Boolean
指示请求是否包含至少一个受密码保护(已加密)的 content object。请参阅 加密内容。
Number of content objects
cf.waf.content_scan.num_obj
Integer
请求中检测到的 content objects 数量(零或更大)。
Content object size
cf.waf.content_scan.obj_sizes
Array<Integer>
按请求中检测到 content objects 的顺序排列的文件大小(字节)数组。
Content object type
cf.waf.content_scan.obj_types
Array<String>
按请求中检测到 content objects 的顺序排列的文件类型数组。
Content object result
cf.waf.content_scan.obj_results
Array<String>
按请求中检测到 content objects 的顺序排列的扫描结果数组。
可能的值:clean、suspicious、infected 与 not scanned。

有关使用这些字段的规则表达式示例,请参阅 Example rules。

这篇文档对您有帮助吗?