已删除带有管道字符的图像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
请按照以下步骤解决问题:
-
在AEM实例中找到XSS保护策略配置文件。 请勿直接修改默认系统目录下的文件。
-
在项目的目录(例如,
/apps目录)中创建XSS保护策略配置的自定义叠加。 -
在自定义覆盖中,更新
alt属性的正则表达式(正则表达式)以在允许的字符类中包含管道(|)字符。 例如,如果原始正则表达式为([ \p{L}\p{N},'.\s-_()\?] |&[ 0-9] {2};),请添加管道字符,使其变为([ \p{L}\p{N},'.\s-_()\?|] |&[ 0-9] {2};)。 -
保存更新的配置并将其部署到您的AEM环境。
-
测试更改:
- 在富文本编辑器中打开文本组件。
- 使用Source编辑模式添加图像并将其
alt属性设置为包含管道字符(例如,alt="test | alt")的值。 - 保存并关闭对话框,然后重新打开该对话框,并检查Source编辑模式以确认
alt属性仍然存在。
-
如果您使用的是AEM as a Cloud Service,请注意,产品更新可能会覆盖您的叠加。 在每次更新后,必要时查看并重新应用您的自定义设置。
experience-cloud-kcs-help-kbarticles