Instale y configure ImageMagick para que funcione con Experience Manager Assets install-and-configure-imagemagick-to-work-with-aem-assets

CAUTION
AEM 6.4 ha llegado al final de la compatibilidad ampliada y esta documentación ya no se actualiza. Para obtener más información, consulte nuestra períodos de asistencia técnica. Buscar las versiones compatibles here.

ImageMagick es un complemento de software para crear, editar, componer o convertir imágenes de mapa de bits. Puede leer y escribir imágenes en varios formatos (más de 200), como PNG, JPEG, JPEG-2000, GIF, TIFF, DPX, EXR, WebP, Postscript, PDF y SVG. Utilice ImageMagick para cambiar el tamaño, girar, espejar, rotar, distorsionar, distorsionar y transformar imágenes. También puede ajustar los colores de la imagen, aplicar diversos efectos especiales o dibujar texto, líneas, polígonos, elipses y curvas mediante ImageMagick.

Utilice el controlador de medios de Adobe Experience Manager desde la línea de comandos para procesar imágenes a través de ImageMagick. Para trabajar con varios formatos de archivo usando ImageMagick, consulte Prácticas recomendadas de los formatos de archivo de recursos. Para obtener información sobre todos los formatos de archivo compatibles, consulte Formatos compatibles con Assets.

Para procesar archivos de gran tamaño con ImageMagick, considere requisitos de memoria superiores a los habituales, posibles cambios necesarios en las políticas de IM y el impacto general en el rendimiento. Los requisitos de memoria dependen de diversos factores, como la resolución, la profundidad de bits, el perfil de color y el formato de archivo. Si tiene intención de procesar archivos muy grandes mediante ImageMagick, realice una evaluación comparativa correcta de la variable Experience Manager servidor. Al final se proporcionan algunos recursos útiles.

NOTE
Si está utilizando Experience Manager en Adobe Managed Services (AMS), póngase en contacto con el servicio de asistencia al cliente de Adobe si tiene pensado procesar muchos archivos de PSD o PSB de gran tamaño. Es posible que el Experience Manager no procese archivos PSB de muy alta resolución que tengan más de 30000 x 23000 píxeles.

Instalar ImageMagick installing-imagemagick

Hay varias versiones de los archivos de instalación de ImageMagic disponibles para varios sistemas operativos. Utilice la versión apropiada para su sistema operativo.

  1. Descargue los Archivos de instalación de ImageMagick para su sistema operativo.

  2. Para instalar ImageMagick en el disco que aloja el Experience Manager , inicie el archivo de instalación.

  3. Establezca la variable de ruta Entorno en el directorio de instalación de ImageMagic.

  4. Para comprobar si la instalación se ha realizado correctamente, ejecute el identify -version comando.

Configuración del paso del proceso de la línea de comandos set-up-the-command-line-process-step

Puede configurar el paso del proceso de la línea de comandos para su caso de uso específico. Realice estos pasos para generar una imagen y miniaturas invertidas (140 x 100, 48 x 48, 319 x 319 y 1280 x 1280) cada vez que agregue un archivo de imagen de JPEG a /content/dam en el Experience Manager servidor:

  1. En el Experience Manager servidor, vaya a la consola Flujo de trabajo (https://[aem_server]:[Port]/workflow) y abra el Recurso de actualización DAM modelo de flujo de trabajo.

  2. En el Recurso de actualización DAM modelo de flujo de trabajo, abra Miniaturas de EPS (con tecnología ImageMagick) paso a paso.

  3. En el Pestaña Argumentos, agregue image/jpeg a Tipos de MIME lista.

    mime_types_jpeg

  4. En el Comandos , introduzca el siguiente comando:

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

  5. Seleccione el Eliminar representación generada y Generar representación web indicadores.

    select_flag

  6. En el Imagen habilitada para web , especifique los detalles de la representación con dimensiones de 1280x1280 píxeles. Además, especifique i imagen/jpeg en el Tipo de miimettipo en la ventana

    web_enabled_image

  7. Toque o haga clic OK para guardar los cambios.

    note note
    NOTE
    La variable convert puede que no se ejecute con ciertas versiones de Windows (por ejemplo, Windows SE), ya que está en conflicto con el comando nativo convert que forma parte de la instalación de Windows. En este caso, mencione la ruta completa de la utilidad ImageMagick. Por ejemplo, especifique,
    "C:\Program Files\ImageMagick-6.8.9-Q16\convert.exe" -define jpeg:size=319x319 ./${filename} -thumbnail 319x319 cq5dam.thumbnail.319.319.png
  8. Abra el Miniaturas de proceso y añada el tipo MIME image/jpeg under Omitir tipos de mime.

    skip_mime_types

  9. En el Imagen habilitada para web , agregue el tipo MIME image/jpeg en el Omitir lista. Toque o haga clic OK para guardar los cambios.

    web_enabled

  10. Guarde el flujo de trabajo.

  11. Para comprobar si ImageMagic es capaz de procesar imágenes correctamente, cargue una imagen de JPG en Assets. Compruebe si se ha generado una imagen invertida y las representaciones para ella.

Mitigar vulnerabilidades de seguridad mitigating-security-vulnerabilities

Hay varias vulnerabilidades de seguridad asociadas con el uso de ImageMagick para procesar imágenes. Por ejemplo, el procesamiento de imágenes enviadas por el usuario implica el riesgo de ejecución de código remoto (RCE).

Además, varios complementos de procesamiento de imágenes dependen de la biblioteca ImageMagick, que incluye, entre otras cosas, imagick de PHP, rmagick y paperclip de Ruby y imagemagick de Node.js.

Si utiliza ImageMagick o una biblioteca afectada, Adobe recomienda mitigar las vulnerabilidades conocidas realizando al menos una de las siguientes tareas (pero preferiblemente ambas):

  1. Compruebe que todos los archivos de imagen empiecen por el valor esperado "bytes mágicos" correspondiente a los tipos de archivo de imagen compatibles antes de enviarlos a ImageMagick para su procesamiento.
  2. Utilice un archivo de directiva para deshabilitar los codificadores vulnerables de ImageMagick. La política global para ImageMagick se encuentra en /etc/ImageMagick.
recommendation-more-help
4452738f-2bdf-4cd4-9b45-905a69d607ad