Show Menu
SUJETS×

Install and configure ImageMagick to work with Experience Manager Assets

ImageMagick est un module logiciel qui permet de créer, modifier, composer ou convertir des images bitmap. Il peut lire et écrire des images dans divers formats (plus de 200), y compris PNG, JPEG, JPEG-2000, GIF, TIFF, DPX, EXR, WebP, Postscript, PDF et SVG. Utilisez ImageMagick pour redimensionner, réaliser une symétrie, effectuer un miroir, faire pivoter, déformer, cisailler et transformer des images. Vous pouvez également régler les couleurs des images, ainsi qu’appliquer divers effets spéciaux, ou tracer du texte, des lignes, des polygones, des ellipses et des courbes à l’aide d’ImageMagick.
Use the Adobe Experience Manager media handler from the command line to process images through ImageMagick. Pour utiliser plusieurs formats de fichiers avec ImageMagick, voir Meilleures pratiques relatives au format de fichier des ressources . Pour connaître tous les formats de fichiers pris en charge, voir Formats de ressources pris en charge .
Pour traiter des fichiers volumineux à l’aide d’ImageMagick, veuillez tenir compte de besoins en mémoire plus élevés que d’habitude, des modifications potentielles requises pour les stratégies IM, ainsi que de l’impact global sur les performances. La mémoire requise dépend de divers facteurs tels que la résolution, la profondeur des couleurs, le profil colorimétrique et le format de fichier. If you intend to process very large files using ImageMagick, properly benchmark the Experience Manager server. Certaines ressources utiles sont fournies à la fin.
Si vous utilisez Experience Manager le service Adobe Managed Services (AMS), contactez le service à la clientèle Adobe si vous prévoyez de traiter de nombreux fichiers PSD ou PSB haute résolution. Experience Manager peut ne pas traiter de fichiers PSB très haute résolution de plus de 3 000 x 2 3 000 pixels.

Installation d’ImageMagick

Plusieurs versions des fichiers d’installation d’ImageMagic sont disponibles pour les différents systèmes d’exploitation. Utilisez la version appropriée pour votre système d’exploitation.
  1. Download the appropriate ImageMagick installation files for your operating system.
  2. To install ImageMagick on the disk hosting the Experience Manager server, launch the installation file.
  3. Définissez la variable de chemin d’environnement sur le répertoire d’installation d’ImageMagick.
  4. Pour vérifier si l’installation est réussie, exécutez la commande identify -version .

Configuration de l’étape de processus de ligne de commande

Vous pouvez configurer l’étape de processus de ligne de commande en fonction de votre cas d’utilisation. Perform these steps to generate a flipped image and thumbnails (140x100, 48x48, 319x319, and 1280x1280) each time you add a JPEG image file to /content/dam on the Experience Manager server:
  1. On the Experience Manager server, go to the Workflow console ( https://[aem_server]:[port]/workflow ) and open the DAM Update Asset workflow model.
  2. From the DAM Update Asset workflow model, open the EPS thumbnails (powered by ImageMagick) step.
  3. In the Arguments tab , add image/jpeg to the Mime Types list.
  4. Dans le champ Commandes , saisissez la commande suivante :
    convert ./${filename} -flip ./${basename}.flipped.jpg
  5. Select the Delete Generated Rendition and Generate Web Rendition flags.
  6. Sous l’onglet Image web , spécifiez les détails du rendu avec des dimensions de 1 280 x 1 280 pixels. En outre, indiquez image/jpeg dans la zone Mimetype .
  7. Pour enregistrer les modifications, cliquez sur OK.
    The convert command may not run with certain Windows versions (for example Windows SE), because it conflicts with the native convert utility that is part of Windows installation. Dans ce cas, précisez le chemin complet de l’utilitaire ImageMagick. Par exemple, spécifiez :
    "C:\Program Files\ImageMagick-6.8.9-Q16\convert.exe" -define jpeg:size=319x319 ./${filename} -thumbnail 319x319 cq5dam.thumbnail.319.319.png
  8. Open the Process Thumbnails step, and add the MIME type image/jpeg under Skip Mime Types .
  9. In the Web Enabled Image tab, add the MIME type image/jpeg under the Skip List . Pour enregistrer les modifications, cliquez sur OK.
  10. Enregistrez le workflow.
  11. Pour vérifier si le traitement est correct, téléchargez une image JPG sur Assets. Une fois le traitement terminé, vérifiez si une image retournée et les rendus sont générés ou non.

Réduction des vulnérabilités en matière de sécurité

Il existe plusieurs vulnérabilités de sécurité liées à l’utilisation d’ImageMagick pour traiter les images. Par exemple, le traitement d’images envoyées par l’utilisateur entraîne un risque d’exécution de code à distance (RCE).
En outre, plusieurs modules externes de traitement d’images dépendent de la bibliothèque ImageMagick, y compris, sans s’y limiter, imagick de PHP, rmagick et paperclip de Ruby, et imagemagick de nodejs.
Si vous utilisez ImageMagick ou une bibliothèque affectée, Adobe vous recommande de limiter les vulnérabilités connues en réalisant au moins l’une des tâches suivantes (de préférence les deux) :
  1. Verify that all image files begin with the expected "magic bytes" corresponding to the image file types you support before sending them to ImageMagick for processing.
  2. Utilisez un fichier de stratégie pour désactiver les codeurs ImageMagick vulnérables. The global policy for ImageMagick is found at /etc/ImageMagick .