缓解AEM中的序列化问题 mitigating-serialization-issues-in-aem

概述 overview

Adobe的AEM团队与开源项目密切合作 NotSoserial 帮助减轻中所述的漏洞 CVE-2015-7501. NotSoSerial根据 Apache 2许可证 并且包括自身许可的ASM代码 类似BSD的许可证.

此包中包含的代理jar是Adobe修改过的NotSoSerial分发。

NotSoSerial是针对Java™级别问题的Java™级别解决方案,并非特定于AEM。 它会向试图反序列化对象的操作添加预检检查。 此检查针对防火墙样式的允许列表列入阻止列表和/或测试类名。 由于默认阻止列表中的类数量有限,此测试不太可能对您的系统或代码产生影响。

默认情况下,代理会针对当前已知的易受攻击的类执行阻止列表检查。 此阻止列表旨在保护您免受目前使用此类漏洞的漏洞的攻击。

列入阻止列表 列入允许列表可以按照 配置代理 章节。

该代理旨在帮助缓解最新已知的易受攻击的类别。 如果您的项目正在反序列化不受信任的数据,则它仍可能容易受到拒绝服务攻击、内存不足攻击和未知的未来反序列化攻击。

Adobe正式支持Java™ 6、7和8。 但是,Adobe的理解是NotSoSerial也支持Java™ 5。

安装代理 installing-the-agent

NOTE
如果以前安装过AEM 6.1的序列化修补程序,请从Java™运行行中删除代理启动命令。
  1. 安装 com.adobe.cq.cq-serialization-tester 捆绑。

  2. 转到位于的包Web控制台 https://server:port/system/console/bundles

  3. 查找并启动序列化包。 这样做会动态自动加载NotSoSerial代理。

在应用程序服务器上安装代理 installing-the-agent-on-application-servers

NotSoSerial代理未包含在应用程序服务器的AEM的标准分发中。 但是,您可以从AEM jar分发中提取它,并将其用于应用程序服务器设置:

  1. 首先,下载AEM快速入门文件并将其解压缩:

    code language-shell
    java -jar aem-quickstart-6.2.0.jar -unpack
    
  2. 转到新解压缩的AEM快速入门的位置,并复制 crx-quickstart/opt/notsoserial/ 文件夹到 crx-quickstart AEM application server安装的文件夹。

  3. 更改所有权 /opt 对运行服务器的用户:

    code language-shell
    chown -R opt <user running the server>
    
  4. 按照本文以下部分所示,配置并检查代理是否已正确激活。

配置代理 configuring-the-agent

对于大多数安装,默认配置已足够。 此配置包括已知远程运行易受攻击的类的阻止列表列入允许列表和信任数据的反序列化安全的包。

防火墙配置是动态的,可以随时更改:

  1. 转到位于的Web控制台 https://server:port/system/console/configMgr

  2. 搜索并单击 反序列化防火墙配置。

    note note
    NOTE
    您还可以通过访问位于以下位置的URL直接访问配置页面:
    • https://server:port/system/console/configMgr/com.adobe.cq.deserfw.impl.DeserializationFirewallImpl

此配置包含允许列表 列入阻止列表、序列化和反序列化日志记录。

允许列表

在允许列表部分中,这些列表是允许反序列化的类或包前缀。 如果要将自己的类反序列化,请将类或包添加到此允许列表中。

阻止列表

在块列表部分中,是不允许进行反序列化的类。 这些类的初始集仅限于已发现易受远程执行攻击的类。 在任何允许列出的条目之前应用阻止列表。

诊断日志记录

在诊断日志记录部分中,您可以选择多个选项,以便在进行反序列化时进行记录。 这些选项仅在首次使用时登录,在后续使用时不再登录。

默认为 class-name-only 通知您正在反序列化的类。

您还可以设置 全栈 选项,用于记录首次反序列化尝试的Java™栈栈,以通知您正在执行反序列化的位置。 此选项对于在使用中查找和删除反序列化很有用。

验证代理的激活 verifying-the-agent-s-activation

您可以通过浏览到以下URL来验证反序列化代理的配置:

  • https://server:port/system/console/healthcheck?tags=deserialization

访问URL后,将显示与代理相关的运行状况检查列表。 您可以通过验证是否通过运行状况检查来确定是否正确激活了代理。 如果失败,则必须手动加载代理。

有关对代理问题进行故障排除的更多信息,请参阅 处理动态代理加载的错误 下。

NOTE
如果添加 org.apache.commons.collections.functors 对于允许列表,运行状况检查始终失败。

处理动态代理加载的错误 handling-errors-with-dynamic-agent-loading

如果日志中显示错误,或者验证步骤检测到加载代理时出现问题,请手动加载代理。 如果您使用JRE (Java™ Runtime Environment)而不是JDK (Java™ Development Toolkit),则也建议使用此工作流,因为用于动态加载的工具不可用。

要手动加载代理,请执行以下操作:

  1. 编辑CQ jar的JVM启动参数,并添加以下选项:

    code language-shell
    -javaagent:<aem-installation-folder>/crx-quickstart/opt/notsoserial/notsoserial.jar
    
    note note
    NOTE
    还需要使用 — nofork CQ/AEM选项以及相应的JVM内存设置,因为未在分支JVM上启用代理。
    note note
    NOTE
    NotSoSerial代理jar的Adobe分布可在 crx-quickstart/opt/notsoserial/ AEM安装的文件夹。
  2. 停止并重新启动JVM;

  3. 按照中所述步骤再次验证代理的激活 验证代理的激活.

其他注意事项 other-considerations

如果您在IBM® JVM上运行,请查看有关支持Java™附加API的文档,网址为 此位置.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2