移除含縱線字元的影像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

請依照下列步驟解決問題:

  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. 在RTF編輯器中開啟文字元件。
    2. 使用Source編輯模式新增影像並將其alt屬性設定為包含縱線字元的值(例如,alt="test | alt")。
    3. 儲存並關閉對話方塊,然後重新開啟對話方塊,並檢查Source編輯模式以確認alt屬性持續存在。
  6. 如果您使用AEM as a Cloud Service,請注意,產品更新可能會覆寫您的覆蓋圖。 每次更新後,請檢閱並重新套用您的自訂(如有必要)。

相關閱讀

設定RTF編輯器以在Adobe Experience Manager中編寫內容

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