移除含縱線字元的影像alt屬性:更新XSS原則
包含直立線(|)字元的影像alt屬性不會保留在AEM Sites RTF編輯器中,因為預設的XSS保護原則。 若要解決此問題,請更新原則設定,以允許垂直號字元。
說明 description
在Adobe Experience Manager (AEM) Sites中使用Text元件時,如果新增包含alt屬性的影像(包含垂直號(|)字元),會導致在儲存並重新開啟對話方塊後移除該屬性。 發生此行為是因為AEM的內建XSS保護原則不允許alt屬性中的垂直號字元,導致其在內容驗證期間被移除。 其他特殊字元(例如-、&、*和$)不受此行為的影響。
環境
Adobe Experience Manager (AEM) Sites (所有版本,包括AEM as a Cloud Service)
症狀
- 在文字元件的RTF編輯器Source編輯模式中,加入含有
alt屬性(包含垂直號字元(例如alt="test | alt"))的影像後,最初會儲存值。 - 重新開啟對話方塊並檢查Source編輯模式時,
img標籤中缺少alt屬性。 - 如果對話方塊再次儲存,內容存放庫中的
alt文字會永久遺失。
原因
AEM的預設XSS保護原則設定不允許影像的alt屬性中有垂直號(|)字元。 因此,屬性會在RTF驗證期間移除。
解決方法 resolution
請依照下列步驟解決問題:
-
在您的AEM執行個體中找到XSS保護原則設定檔案。 請勿直接修改預設系統目錄下的檔案。
-
在您的專案目錄(例如,
/apps目錄)中建立XSS保護原則設定的自訂覆蓋。 -
在您的自訂覆蓋中,更新
alt屬性的規則運算式(規則運算式)以在允許的字元類別中包含垂直號(|)字元。 例如,如果原始規則運算式為([ \p{L}\p{N},'.\s-_()\?] |&[ 0-9] {2};),請新增垂直號字元,使其變成([ \p{L}\p{N},'.\s-_()\?|] |&[ 0-9] {2};)。 -
儲存更新的設定,並將其部署至您的AEM環境。
-
測試變更:
- 在RTF編輯器中開啟文字元件。
- 使用Source編輯模式新增影像並將其
alt屬性設定為包含縱線字元的值(例如,alt="test | alt")。 - 儲存並關閉對話方塊,然後重新開啟對話方塊,並檢查Source編輯模式以確認
alt屬性持續存在。
-
如果您使用AEM as a Cloud Service,請注意,產品更新可能會覆寫您的覆蓋圖。 每次更新後,請檢閱並重新套用您的自訂(如有必要)。
experience-cloud-kcs-help-kbarticles