安裝並配置ImageMagick以與Experience Manager Assets一起使用

ImageMagick是用於建立、編輯、合成或轉換點陣圖影像的軟體插件。 它可以讀取和寫入各種格式(超過200個)的影像,包括PNG、JPEG、JPEG-2000、GIF、TIFF、DPX、EXR、WebP、Postscript、PDF和SVG。 使用ImageMagick調整影像大小、翻轉、鏡像、旋轉、扭曲、剪切和轉換影像。 您還可以使用ImageMagick調整影像顏色、應用各種特殊效果,或繪製文本、線、多邊形、橢圓和曲線。

使用命令行中的Adobe Experience Manager介質處理程式通過ImageMagick處理影像。 若要使用ImageMagick使用各種檔案格式,請參閱Assets檔案格式最佳實務。 若要了解所有支援的檔案格式,請參閱Assets supported formats

要使用ImageMagick處理大型檔案,請考慮高於通常的記憶體要求、IM策略所需的潛在更改以及對效能的整體影響。 記憶體需求取決於各種因素,如解析度、位深度、顏色配置檔案和檔案格式。 如果要使用ImageMagick處理非常大的檔案,請正確對Experience Manager伺服器進行基準測試。 最後提供一些實用的資源。

注意

如果您在Adobe Managed Services (AMS)上使用Experience Manager,如果您打算處理許多高解析度PSD或PSB檔案,請聯絡Adobe客戶支援。 Experience Manager 可能無法處理超過30000 x 23000像素的高解析度PSB檔案。

安裝ImageMagick

各種作業系統均提供多個版本的ImageMagic安裝檔案。 使用適合您作業系統的版本。

  1. 下載適合您作業系統的ImageMagick安裝檔案

  2. 要在Experience Manager伺服器所在的磁碟上安裝ImageMagick,請啟動安裝檔案。

  3. 將路徑環境變數設定為ImageMagic安裝目錄。

  4. 要檢查安裝是否成功,請執行identify -version命令。

設定命令行處理步驟

您可以為您的特定使用案例設定命令列處理步驟。 每次在Experience Manager伺服器上將JPEG影像檔案新增至/content/dam時,執行下列步驟以產生翻轉的影像和縮圖(140x100、48x48、319x319和1280):

  1. 在Experience Manager伺服器上,前往工作流程主控台(https://[aem_server]:[port]/workflow),並開啟​DAM更新資產​工作流程模型。

  2. 從​DAM更新資產​工作流程模型中,開啟​EPS縮圖(由ImageMagick提供技術)​步驟。

  3. 在​參數頁簽​中,將image/jpeg添加到​Mime類型​清單中。

    mime_types_jpeg

  4. 在​Commands​框中,輸入以下命令:

    convert ./${filename} -flip ./${basename}.flipped.jpg

  5. 選擇​Delete Generated Rendition​和​Generate Web Rendition​標幟。

    select_flags

  6. 在​Web Enabled Image​標籤中,指定尺寸為1280x1280像素的格式副本的詳細資訊。 此外,在​Mimetype​框中指定image/jpeg

    web_enabled_image

  7. 按一下​OK​以儲存變更。

    注意

    convert命令可能不在某些Windows版本(例如Windows SE)中運行,因為它與Windows安裝中的本機convert實用程式衝突。 在此案例中,請提及ImageMagick公用程式的完整路徑。 例如,指定

    "C:\Program Files\ImageMagick-6.8.9-Q16\convert.exe" -define jpeg:size=319x319 ./${filename} -thumbnail 319x319 cq5dam.thumbnail.319.319.png

  8. 開啟​處理縮圖​步驟,並在​跳過Mime類型​下添加MIME類型image/jpeg

    skip_mime_types

  9. 在​Web Enabled Image​標籤中,在​Skip List​下添加MIME類型image/jpeg。 按一下​OK​以儲存變更。

    web_enabled

  10. 儲存工作流程。

  11. 若要驗證處理是否正確,請將JPG影像上傳至Assets。 處理完成後,檢查是否產生翻轉的影像和轉譯。

降低安全漏洞

使用ImageMagick處理映像時存在多個安全漏洞。 例如,處理使用者提交的影像時,可能會有遠端程式碼執行(RCE)的風險。

此外,各種影像處理插件依賴於ImageMagick庫,包括但不限於PHP的影像、Ruby的影像和回形夾,以及nodejs的影像。

如果您使用ImageMagick或受影響的程式庫,Adobe建議您透過執行下列至少一項工作(但最好同時執行兩項工作),以緩解已知弱點:

  1. 在將所有影像檔案發送到ImageMagick進行處理之前,請先確認所有影像檔案的開頭都是與您支援的影像檔案類型對應的預期"magic bytes"
  2. 使用策略檔案禁用有漏洞的ImageMagick編碼器。 在/etc/ImageMagick找到ImageMagick的全局策略。

本頁內容