用于阻止并验证 Atlassian Data Center 产品中 CVE-2026-21589 路径遍历漏洞缓解效果的 F5 BIG-IP iRule 与验证脚本,涵盖编码后的载荷变体。
针对 CVE-2026-21589 的防御性工具,这是一个严重(CVSS 9.3)的未认证任意文件访问漏洞,影响多个 Atlassian Data Center 产品(Jira、Jira Service Management、Confluence、Bitbucket、Bamboo、Crowd、Crucible、Fisheye)。
本仓库帮助你在 F5 BIG-IP 上缓解该缺陷,并验证缓解措施确实能拦截真实载荷——包括 ..:: 分隔符以及单重/双重/三重编码的规避变体。它不是漏洞利用框架:探测仅报告 HTTP 状态码和响应大小,绝不存储或打印响应正文。
优先打补丁。 这些只是临时缓解措施。Atlassian 的修复方案是升级到已修复版本。使用本工具包是为了在打补丁前争取时间,并确认你的临时 WAF 规则有效——而不是作为打补丁的替代方案。 参见 Atlassian 安全公告。
| 文件 | 说明 |
|---|---|
cve-2026-21589.irule | F5 BIG-IP iRule,在请求路径上拦截遍历模式——包括原始形式和规范化形式——前置一个低成本的字符串预过滤。基于 Atlassian 公布的 regex。 |
benign-traffic.sh | 生成稳定的良性请求流(Apache Bench)作为基线“正常”流量。Ctrl-C 或一分钟时限。 |
check-mitigation.sh | 一次性检查:将全部 30 个载荷(27 个遍历载荷、3 个良性对照)各发送一次,逐行打印颜色编码的 PASS / FAIL 及汇总。正文绝不存储。 |
probe-mitigation.sh | 发送已知的 CVE-2026-21589 载荷(curl,随机 0–5 秒抖动),逐路径报告 BLOCKED / INCONCLUSIVE / NOT BLOCKED。正文绝不存储。Ctrl-C 或一分钟时限。 |
该规则应用 contains ".." || contains "%" 预过滤,使 regex 仅在可疑请求上运行,然后以两种形式对路径匹配 Atlassian 的不区分大小写 regex:接收时的形式(HTTP::path)和经 TMM 规范化后的形式(HTTP::path -normalized)。匹配时返回加固的 403。
when RULE_INIT {
set static::trav_rx {(?is).*(?:/|\\|::|%(?:25)*(?:2f|5c)|(?::|%(?:25)*3a){2})(?:\.|%(?:25)*2e){2}(?:/|\\|::|%(?:25)*(?:2f|5c)|(?::|%(?:25)*3a){2}|;|%(?:25)*3b|$).*}
}
when HTTP_REQUEST priority 100 {
if { !(([HTTP::path] contains "..") || ([HTTP::path] contains "%"))} {return}
if { [regexp -- $static::trav_rx [HTTP::path]] || [regexp -- $static::trav_rx [HTTP::path -normalized]] } {
# log local0.warn "CVE-2026-21589 block: [IP::client_addr] [HTTP::path]"
HTTP::respond 403 -version auto content "Forbidden" noserver Connection "close"
return
}
}
if { !(([HTTP::path] contains "..") || ([HTTP::path] contains "%"))} {return}
这一行是快速路径,不属于检测逻辑的一部分。它存在有三个原因:
.* 开头和结尾,最多被求值两次,第二次求值还会让 TMM 构建规范化路径。contains 测试是纯子字符串搜索,成本低得多。几乎所有真实流量都不包含 .. 或 %,因此它在两次子字符串检查后就会离开规则,永远不会触及正则引擎或规范化器。.,要么写成编码的 %2e(%252e、……)。如果两个点都是字面量,路径就包含 ..;如果其中任一个是编码的,它就包含 %。其他需要编码的分隔符(%2f、%5c、%3a、%3b)也包含 %。规范化分支同样被覆盖:规范化只会解码 % 序列并解析点段,因此一个既没有 % 也没有 .. 的原始路径不可能规范化成正则能匹配的内容。因此,任何可能匹配的请求都会被放行到正则。预过滤器有意保持宽松。诸如 /x/file..txt 这样的良性路径,或任何带有 % 编码字符的 URL 都会通过它并落到正则,由正则来做决定。这就是为什么 check-mitigation.sh 中的良性对照必须返回除 403 以外的任何结果:它们证明是正则、而非预过滤器,在区分遍历与普通点和编码。
HTTP::path 捕获按原样发送的载荷:字面量 ..,以及单层或多层 %25 嵌套的点(%2e、%252e、%25252e),%(?:25)*2e 子模式会直接匹配它们。HTTP::path -normalized 解码原始形式所隐藏的编码——包括数字编码的 %25%32%65 变体,原始正则因为期望字面字节 2e 而会漏掉它。规范化会把这些编码还原成 %2e/..,从而让同一个正则捕获它们。注意,:: 不是 TMM 规范化器眼中的分隔符,因此它不会折叠 CVE 的 ..:: 链——这正是让模式对正则保持可见、而不是被解析掉的原因。构建细节:
(?i) 标志,因此 %2E、%5C、%3A 能匹配其小写形式。只有十六进制数字和分隔符有字母需要折叠;..、/、\、::、; 没有大小写,所以 (?i) 只影响编码部分。预过滤器测试 .. 和 %,两者都与大小写无关,因此无需折叠。RULE_INIT 中编译为 static::trav_rx,跨请求共享。noserver version auto 从 403 响应中移除服务器头。范围——有意仅限 CVE-2026-21589:
HTTP::path 就是这个 CVE 的完整攻击面,跳过查询字符串是正确的,而不是缺口。此规则不是通用遍历过滤器,不应作为通用过滤器依赖。将所有目标指向你拥有或获得明确授权测试的主机。
60 分钟的基线流量:
printf '10.200.96.91\nhttp\n60\n\n' | bash benign-traffic.sh
一次性缓解检查(提示输入目标和方案):
printf '10.200.96.91\nhttp\n' | bash check-mitigation.sh
针对 60 分钟的缓解探测:
printf '10.200.96.91\nhttp\n60\n' | bash probe-mitigation.sh
读取检查输出:
RESULT、HTTP CODE、EXPECT(预期行为)以及路径(截断至 70 个字符)。BLOCK 行仅在返回 403 时通过。任何其他状态码均为失败:说明遍历载荷绕过了 iRule。ALLOW 行是良性对照,只要不是 403 即通过。此处出现 403 即为失败:属于误报。All 30 payloads handled correctly.,要么是 PASS/FAIL 计数。check-mitigation.sh 中的三个良性对照:
| 路径 | 为何不应被拦截 |
|---|---|
/x/file..txt | .. 位于文件名内部,而非路径段。它能通过预过滤器,但正则要求点号前后都有分隔符。 |
/x/FILE..TXT | 同上,大写形式,用于证明大小写不敏感标志不会扩大匹配范围。 |
/%78%2f%66%69%6c%65%2e%2e%74%78%74 | /x/file..txt 的完整十六进制编码,包括点号(%2e%2e)和斜杠(%2f)。原始分支看到的是 %2e%2e 前面是 %65(e),而非分隔符;规范化分支将其解码为 /x/file..txt。两者均不匹配,因此这证明仅靠重度编码不会触发拦截。 |
读取探测输出:
BLOCKED(403)—— iRule 捕获了载荷。这是每条遍历路径上的目标。INCONCLUSIVE(404)—— 有响应返回“未找到”,但并非 iRule 的 403,因此请求可能已到达后端。在将该路径视为已覆盖之前,请检查 iRule 是否已附加并匹配。*** NOT BLOCKED ***(200)—— 载荷被正常提供。在探测的两个良性对照(/x/file..txt、/x/FILE..TXT)上属于预期结果;在任何遍历路径上则属于需要修复的缓解缺口。对于扫描/检测,请使用 ProjectDiscovery 的社区模板,而非自行编写:
http/cves/2026/ 下):
搜索 CVE-2026-21589nuclei -u https://your-lab-host -id CVE-2026-21589
本仓库仅供防御性安全和授权测试使用。它包含真实的 CVE-2026-21589 载荷字符串,以便防御者能够针对实际攻击验证自身的缓解措施。
请仅对您拥有或已获得明确书面许可进行测试的系统运行这些工具。在大多数司法管辖区,未经授权对第三方系统进行使用均属违法行为。
作者对任何人使用或滥用本仓库内容,或因使用或滥用本仓库内容而产生的任何损害、损失或法律后果,不承担任何责任或义务。您使用本仓库内容需完全自行承担风险。请参阅 LICENSE。