Apache Commons Codec披露BLAKE3密钥派生漏洞:升级1.23.0为何仍需检查Java应用代码?

发布人:A5数据发布时间:2026-11-10 17:37阅读量:130
Apache披露Commons Codec中的CVE-2026-119078安全漏洞,涉及BLAKE3密钥派生API文档示例错误,可能导致Java应用生成本应相互独立的相同密钥。

两个原本应该相互独立的加密密钥,最终却生成了完全相同的结果。问题不在于密码算法遭到破解,而是开发者按照软件库提供的官方示例编写代码时,对接口行为产生了错误理解。

北京时间11月10日04:06,Apache软件基金会正式披露CVE-2026-119078安全漏洞,涉及Java常用工具库Apache Commons Codec中的BLAKE3密钥派生功能。

根据官方说明,Apache Commons Codec 1.16.0至1.23.0之前的版本存在错误的API文档示例。开发者如果按照旧版Javadoc中的方法,使用同一个BLAKE3实例连续调用doFinalize()生成多个密钥,可能获得完全相同的输出,导致原本应该相互隔离的密钥实际上没有实现隔离。

Apache已在1.23.0版本中修正文档,但并未改变doFinalize()方法的实际运行行为。这意味着,即使项目已经更新到1.23.0,只要业务代码仍然沿用旧的密钥派生方式,问题就可能继续存在。

A5数据在梳理此次漏洞时注意到,它与我们通常看到的服务器安全更新存在明显区别:漏洞的关键不在于某个函数执行了错误的计算,而在于官方文档描述的行为与真实实现不一致,并可能将错误的安全假设带入开发者自己的应用代码。

对于使用Java开发身份认证、加密通信或其他密钥管理功能的企业,此次安全披露提醒我们,更新依赖库虽然重要,但有些安全缺陷还需要回到业务代码中才能真正解决。

Apache Commons Codec是什么?为何会涉及密钥安全?

Apache Commons Codec是Apache Commons项目中的一个Java工具库,提供多种编码、解码、散列和数据转换功能。

在Java应用开发中,它经常被用于Base64编码、Hex转换、摘要计算以及其他数据处理任务。

与完整的Web框架不同,Commons Codec通常作为底层依赖存在。

例如,一个企业系统可能直接调用Commons Codec处理某些数据,也可能通过其他第三方Java组件间接引入该库。

由于工具库往往不直接提供对外访问的Web接口,因此管理员在检查服务器安全时,可能不会像关注Tomcat、Nginx或Spring那样关注它。

但底层依赖的代码行为同样可能影响业务安全。

此次漏洞涉及Commons Codec提供的org.apache.commons.codec.digest.Blake3类。

BLAKE3是一种现代密码学散列算法,除了可以计算普通消息摘要,还支持带密钥散列及密钥派生等用途。

它具有可扩展输出能力,即XOF(Extendable Output Function),能够在同一输入和算法状态下生成指定长度的输出数据。

这种特性使其可以被用于某些需要派生多个密钥的应用场景。

例如,通信程序可能需要为两个不同方向的数据传输分别生成密钥,以避免不同用途共享完全相同的密钥材料。

但要正确实现这种密钥隔离,程序必须理解底层API如何生成和返回数据。

此次漏洞正是出现在这个环节。

问题出在doFinalize:连续调用并不会自动生成新的密钥

根据Apache官方安全公告,旧版Commons Codec的BLAKE3文档曾给开发者造成一种印象:连续调用doFinalize(),可以依次取得不同的输出内容。

例如,开发者可能希望从同一组输入材料中派生两个32字节的密钥。

按照旧版文档示例所暗示的方式,程序可能先调用一次doFinalize()得到第一个密钥,再调用一次得到第二个密钥。

开发者原本预期,两次调用会依次读取BLAKE3扩展输出中的不同部分。

但实际情况并非如此。

Apache明确指出,doFinalize()并不会因为被调用一次,就改变BLAKE3实例内部用于后续输出的状态。

如果使用相同的实例、没有增加新的输入,并且再次请求相同长度的输出,方法会从相同的输出起点生成数据。

因此,两次得到的结果相同。

这意味着,开发者以为自己创建了两个独立密钥,实际上可能只是将同一份密钥材料保存了两次。

为什么相同密钥会带来安全问题?

如果一个应用原本就设计为重复使用同一个密钥,那么两次输出相同未必构成新的安全问题。

但如果应用的安全设计明确要求不同用途使用独立密钥,情况就不同了。

例如,某个通信协议希望发送方向与接收方向分别使用不同密钥。

这样设计的目的,是减少不同数据流之间的相互影响,并满足协议对密钥分离的要求。

如果程序错误地为两个方向分配完全相同的密钥,就破坏了原本建立的安全边界。

在部分协议或加密模式中,这种错误还可能与其他参数使用方式产生额外风险。

不过,实际影响仍然取决于应用如何使用密钥、采用什么加密算法,以及是否存在其他保护措施。

因此,不能简单将此次漏洞描述为所有Java加密程序都会泄露明文,或者攻击者可以直接计算出用户的密钥。

此次已经确认的问题,是原本应该不同的派生密钥可能完全相同,而不是BLAKE3算法本身失去了密码学安全性。

这一区别非常重要。

升级1.23.0为什么不能自动解决问题?

Apache Commons Codec 1.23.0已于2026年10月4日发布。

此次CVE-2026-119078的正式安全披露则发生在11月9日。

也就是说,修正后的文档早于漏洞正式公开。

根据Apache发布记录,1.23.0已经修复BLAKE3密钥派生示例,并澄清doFinalize()的语义。

但官方没有改变这个方法的实际实现。

原因在于,连续调用时返回相同输出,本身符合当前API的设计行为。

真正存在问题的是旧版文档错误地暗示连续调用能够依次取得不同的数据。

这就形成了一种特殊的修复情况。

对于尚未开发相关功能的新项目,更新后的文档可以避免开发者继续采用错误的调用方式。

但对于已经上线的Java应用,开发者过去可能已经复制或参考旧示例编写了实际业务代码。

这些代码在升级依赖后仍然可以正常编译和运行。

甚至在很多情况下,程序也不会抛出任何异常。

因为从API角度看,doFinalize()确实成功返回了指定长度的字节数组。

只是两份输出没有实现开发者预期的密钥分离。

A5数据认为,这正是此次漏洞最容易被忽略的地方。

对于传统的依赖库漏洞,管理员往往通过升级到包含修复代码的新版本,就能够阻断相关问题。

但这一次,修复发生在文档层面,应用中已经形成的错误调用逻辑不会因为依赖升级而自动改变。

软件版本已经更新,不代表过去基于错误文档写出的安全逻辑也得到了修复。

因此,真正需要检查的是业务代码如何调用BLAKE3,而不仅仅是项目依赖清单中显示哪个版本。

正确的密钥派生方式:一次生成所需数据,再分别取用

Apache在更新后的Javadoc中给出了明确的处理方式。

如果应用需要从同一个BLAKE3密钥派生上下文中生成多个不同的子密钥,应当一次请求所需的总输出长度,然后按照约定的位置将结果拆分。

例如,需要两个长度均为32字节的密钥,可以一次请求64字节输出。

随后将前32字节作为第一个密钥,后32字节作为第二个密钥。

这样能够避免在同一个状态下重复调用doFinalize(),却错误地认为每次返回的是新的输出部分。

下面是根据Apache Commons Codec 1.23.0官方Javadoc整理的Java代码示意:

import java.nio.charset.StandardCharsets;
import java.util.Arrays;

import org.apache.commons.codec.digest.Blake3;

public class Blake3KeyDerivation {

    public static void main(String[] args) {

        byte[] sharedSecret = obtainSharedSecret();

        String context = "com.example.protocol.v1";

        Blake3 kdf = Blake3.initKeyDerivationFunction(
            context.getBytes(StandardCharsets.UTF_8)
        );

        kdf.update(sharedSecret);

        byte[] keyMaterial = kdf.doFinalize(64);

        byte[] firstKey =
            Arrays.copyOfRange(keyMaterial, 0, 32);

        byte[] secondKey =
            Arrays.copyOfRange(keyMaterial, 32, 64);

        // 根据实际协议用途使用两个密钥
    }
}

这里的obtainSharedSecret()是示意方法,需要由应用自身提供安全的密钥材料,并不是Commons Codec提供的现成接口。

代码中的上下文字符串也仅用于说明调用方式,正式项目应根据实际协议确定唯一且稳定的派生上下文。

这段示例的重点不在于具体变量名称,而是派生过程:

先确定需要多少密钥材料,一次取得完整输出,再按明确的边界划分不同用途的密钥。

实际业务还应确保原始密钥材料具有足够的安全性,并遵循所使用协议对密钥长度、上下文、用途分离及密钥生命周期的要求。

如果应用已经使用旧方式生成过生产密钥,还需要考虑存量密钥与新派生方式之间的兼容性,不能直接替换代码后就假设所有历史加密数据仍然能够正常解密。

哪些Java应用需要重点排查?

此次漏洞影响Apache Commons Codec 1.16.0至1.23.0之前的版本,但并不是所有使用这些版本的应用都会出现密钥派生问题。

根据官方公告,关键条件是应用使用BLAKE3相关API,并且在同一个实例上多次调用doFinalize(),同时预期每次得到不同的输出。

因此,排查应该从实际代码使用方式入手。

首先,确认项目是否引入Commons Codec

对于使用Maven的Java项目,可以执行:

mvn dependency:tree \
  -Dincludes=commons-codec:commons-codec

这条命令用于查看当前Maven项目中Commons Codec的依赖关系,不会主动修改业务源代码。

对于使用Gradle的项目,可以在对应的构建环境中执行依赖分析:

./gradlew dependencyInsight \
  --dependency commons-codec \
  --configuration runtimeClasspath

需要注意,不同项目的运行配置名称可能不同,实际命令应根据对应Gradle工程调整。

如果应用使用Spring Boot、Tomcat或者其他Java框架,也不能仅根据框架名称判断是否受到影响。

因为Commons Codec可能通过直接依赖或传递依赖进入项目。

但即使项目确实包含相关版本,也仍然需要确认是否调用了受影响的BLAKE3密钥派生方法。

其次,检查业务代码中的BLAKE3调用方式

对于拥有项目源码的开发团队,可以搜索:

Blake3

initKeyDerivationFunction

doFinalize

重点关注是否存在以下逻辑:

使用同一个BLAKE3实例,连续调用doFinalize()生成多个不同用途的密钥,而中间没有改变输入数据。

如果存在这种写法,应根据最新官方文档确认其目的和实际返回结果。

不能只因为代码中存在多个doFinalize()调用,就直接判断一定存在漏洞。

例如,在相同输入下重复计算相同摘要,可能本来就是应用所需要的行为。

此次安全问题需要满足一个额外条件:开发者原本期望多个输出彼此不同,并且将它们用于需要独立密钥材料的场景。

因此,静态代码搜索只能帮助缩小排查范围,最终仍需要结合实际用途判断。

最后,检查是否存在已经投入使用的重复密钥

对于确认采用错误派生方式的应用,仅修改代码可能还不够。

如果系统此前已经利用相同输出建立多个长期密钥,就需要评估这些密钥是否仍在使用。

例如,相关密钥是否用于保护持续保存的数据,是否被写入配置文件或密钥管理系统,以及是否参与跨系统通信。

如果新代码生成的密钥与旧代码不同,还需要制定兼容和迁移方案。

对于存在实际安全暴露风险的密钥,可以结合业务情况考虑轮换。

但并不是所有使用旧方法的系统都必须立即删除全部密钥或重新加密所有历史数据。

是否需要轮换,应根据密钥用途、实际重复情况、协议安全要求及数据恢复能力判断。

依赖漏洞扫描工具为什么可能发现不了全部问题?

目前不少Java项目已经使用依赖安全扫描工具。

这类工具可以检查Maven、Gradle或其他依赖文件,识别项目是否引入具有已知CVE的组件。

对于传统的第三方依赖漏洞,这种方法非常有效。

例如,某个库存在不安全的反序列化代码,只要项目使用了受影响版本,就可以通过依赖分析确定是否需要升级。

但此次CVE-2026-119078存在一个比较特殊的情况。

即使项目已经升级至Commons Codec 1.23.0,旧版Javadoc示例形成的错误代码仍然可能保留。

这意味着,一份依赖扫描报告可能显示相关库已不再使用受影响版本,但应用自身的密钥派生逻辑仍然没有改变。

对于单纯根据软件包版本判断风险的工具,这类问题可能不容易被完整识别。

从A5数据的观察来看,这说明软件供应链安全不能仅停留在依赖版本管理。

依赖版本能够告诉我们项目使用了什么组件,却无法完整证明开发者是否正确使用了这些组件。

尤其是密码学、身份认证、权限验证和数据完整性相关API,错误使用方式可能产生与底层实现漏洞同样值得关注的后果。

因此,对于关键安全代码,企业还需要结合代码审查、单元测试和安全设计检查。

例如,在本次BLAKE3场景中,如果开发者原本设计的是两个独立密钥,就可以编写测试验证两份派生结果是否符合协议要求。

这种测试不应该只检查密钥长度是否正确,还应该验证密钥分离行为。

因为两个32字节数组即使内容完全相同,也同样满足“长度为32字节”这一普通测试条件。

如果测试只关注长度和是否成功返回,就可能漏掉此次问题。

官方示例代码为什么也需要验证?

此次漏洞还有一个容易引起开发者共鸣的地方:问题来自官方Javadoc中的使用示例。

在实际开发中,很多程序员会参考框架和工具库的官方文档编写代码。

这种做法通常比直接复制来源不明的网络教程更可靠。

但官方文档同样可能存在错误。

尤其对于密码学API,开发者不仅需要知道方法参数是什么,还必须准确理解方法的内部状态变化、输出规则和安全适用条件。

此次BLAKE3漏洞并没有表明算法设计存在普遍缺陷,也没有证明Commons Codec所有散列功能都不安全。

它说明的是,文档对一个关键API行为的描述出现了偏差,而且这种偏差恰好涉及密钥分离。

对于普通数据编码函数,错误理解可能表现为输出不符合预期,应用很快就会发现问题。

但对于密钥派生函数,即使输出结果不符合安全设计,程序也可能继续正常运行。

因为相同的密钥仍然是一组格式正确的字节数据,后续加密或解密操作也未必立即报错。

这使得此类问题可能长期隐藏在正常运行的业务程序中。

A5数据认为,越是涉及密码学和安全边界的底层API,开发者越需要通过独立测试验证其行为,而不能只依赖示例代码能够成功编译这一点。

特别是对于加密通信协议,应该明确测试密钥长度、派生上下文、不同用途之间的隔离关系,以及密钥变化后是否能够保持协议一致性。

这些测试不仅有助于发现开发错误,也能够在未来升级依赖时及时发现行为变化。

这次漏洞与常见的Java远程代码执行有什么不同?

近年来,Java安全公告经常涉及反序列化漏洞、表达式注入、认证绕过或远程代码执行。

这类问题通常需要分析攻击者如何构造输入,以及输入如何到达受影响的服务端代码。

但此次Apache Commons Codec漏洞并不是这种典型的外部攻击路径。

官方没有将其描述为任意互联网用户能够通过HTTP请求直接控制Java服务器。

也没有证据表明安装Commons Codec 1.16.0至1.22.1的所有服务器都能够被远程攻击者利用。

漏洞的关键在于应用程序是否采用了错误的密钥派生模式。

因此,其影响更接近密码学API误用导致的安全设计缺陷。

如果应用没有使用BLAKE3,或者没有依赖重复调用doFinalize()生成不同密钥,就不一定存在此次描述的问题。

但如果某项关键业务恰好使用错误方法派生了不同用途的密钥,即使服务器没有开放任何额外端口,也可能违反自身的安全设计要求。

这也提醒服务器管理员,不能只根据漏洞名称中是否包含RCE、SQL注入或权限提升,判断安全事件的实际价值。

某些漏洞不会立即造成服务器入侵,却可能影响长期使用的加密材料。

对于处理敏感业务数据的企业,这种风险同样需要认真评估。

一次文档修正,反映出软件安全维护的另一种难题

Apache Commons Codec 1.23.0早在10月4日就已经修正文档,而正式CVE公告直到11月9日才公布。

这种时间差说明,安全问题的修正、正式披露和用户实际完成整改,并不一定发生在同一个时间点。

对于普通依赖漏洞,维护者可以通过修改代码,让新版本自动阻断部分错误行为。

但对于已经被开发者采用的错误API使用方式,维护者即使修正了文档,也无法自动修改所有下游应用的业务逻辑。

如果直接改变doFinalize()的行为,还可能影响原本正确依赖其现有语义的程序。

因此,此次Apache选择澄清文档,并要求使用者自行检查应用代码。

这种处理方式也反映出成熟软件维护中的一种现实限制。

安全补丁可以修复库内部的代码缺陷,但无法保证所有调用该库的应用都遵循正确的安全设计。

从软件供应链角度来看,项目开发者与依赖维护者之间存在明确的责任分工。

维护者需要提供准确的接口实现和文档。

应用开发者则需要理解接口语义,并验证其是否符合具体业务的安全要求。

当文档与实际行为发生偏差时,这两个环节都可能受到影响。

值得注意的是,Apache此次安全公告将Claude Security列为问题发现工具,并由项目维护者Gary D. Gregory负责修复工作。

这也反映出AI辅助代码审查正在进入开源组件的日常安全研究过程。

但无论问题由人工还是AI工具发现,最终仍然需要通过实际代码行为验证漏洞是否存在,以及修复方案是否真正适用。

对于这次BLAKE3问题,关键证据并不是模型给出了什么安全判断,而是官方确认连续调用doFinalize()的真实行为与旧文档预期不同。

Java服务器的安全维护,不能只看依赖版本是否最新

此次CVE-2026-119078没有要求所有Java服务器立即停机,也没有证明BLAKE3算法本身存在可直接破解的密码学缺陷。

Apache已经在Commons Codec 1.23.0中修正相关文档,但对于过去沿用错误示例编写的应用,开发者仍需要自行检查代码。

如果程序确实使用同一个BLAKE3实例连续派生多个独立密钥,就应按照更新后的官方文档调整实现,并结合历史密钥使用情况评估是否需要迁移或轮换。

对于没有使用相关API的系统,不必仅因为项目引入Commons Codec,就认定业务已经存在密钥泄露。

从A5数据的角度来看,此次安全披露最值得服务器行业关注的,不是Apache发布了一个新的CVE编号,而是它揭示了自动化依赖升级无法完全解决的一类安全问题。

越来越多Java应用已经建立了自动化依赖扫描、安全版本提醒和持续集成流程。

这些机制可以帮助企业及时发现过期组件,但它们不能完全代替对关键业务逻辑的验证。

特别是涉及身份认证、密钥派生和数据加密的代码,即使底层依赖没有已知漏洞,也需要确认程序是否按照预期使用这些安全能力。

对企业开发团队而言,升级Commons Codec 1.23.0是维护依赖的重要步骤,而检查BLAKE3密钥派生逻辑,才是此次漏洞能否真正得到处置的关键。

软件库可以通过版本更新修正文档,但已经进入业务系统的错误安全假设,仍然需要开发者亲自验证和纠正。

这或许是此次Apache Commons Codec安全披露留给Java应用维护人员最有价值的提醒。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/8700.html

相关推荐