已删除带有管道字符的图像alt属性:更新XSS策略

由于默认的XSS保护策略,包含管道(|)字符的图像alt属性未保留在AEM Sites富文本编辑器中。 要解决此问题,请更新策略配置以允许使用管道字符。

描述 description

在Adobe Experience Manager (AEM)站点中使用文本组件时,如果添加的图像的alt属性包含管道(|)字符,则在保存并重新打开对话框后,会导致属性被删除。 发生此行为是因为AEM的内置XSS保护策略不允许alt属性中的管道字符,导致其在内容验证期间被去除。 其他特殊字符(如-、&、*和$)不受此行为的影响。

环境

Adobe Experience Manager (AEM)站点(所有版本,包括AEM as a Cloud Service)

症状

  • 在文本组件的富文本编辑器Source编辑模式中添加图像后,如果图像的alt属性包含管道字符(例如,alt="test | alt"),则最初将保存该值。
  • 重新打开对话框并检查Source编辑模式时,img标记中缺少alt属性。
  • 如果再次保存对话框,内容存储库中的alt文本将永久丢失。

原因

AEM的默认XSS保护策略配置不允许在图像的alt属性中使用管道(|)字符。 因此,属性会在富文本验证期间被删除。

解决方法 resolution

请按照以下步骤解决问题:

  1. 在AEM实例中找到XSS保护策略配置文件。 请勿直接修改默认系统目录下的文件。

  2. 在项目的目录(例如,/apps目录)中创建XSS保护策略配置的自定义叠加。

  3. 在自定义覆盖中,更新alt属性的正则表达式(正则表达式)以在允许的字符类中包含管道(|)字符。 例如,如果原始正则表达式为([ \p{L}\p{N},'.\s-_()\?] |&[ 0-9] {2};),请添加管道字符,使其变为([ \p{L}\p{N},'.\s-_()\?|] |&[ 0-9] {2};)。

  4. 保存更新的配置并将其部署到您的AEM环境。

  5. 测试更改:

    1. 在富文本编辑器中打开文本组件。
    2. 使用Source编辑模式添加图像并将其alt属性设置为包含管道字符(例如,alt="test | alt")的值。
    3. 保存并关闭对话框,然后重新打开该对话框,并检查Source编辑模式以确认alt属性仍然存在。
  6. 如果您使用的是AEM as a Cloud Service,请注意,产品更新可能会覆盖您的叠加。 在每次更新后,必要时查看并重新应用您的自定义设置。

相关阅读

配置富文本编辑器以在Adobe Experience Manager中创作内容

recommendation-more-help
experience-cloud-kcs-help-kbarticles