Installez et configurez ImageMagick pour qu’il fonctionne avec Experience Manager Assets

ImageMagick est un module externe logiciel permettant de créer, modifier, composer ou convertir des images bitmap. Il peut lire et écrire des images dans différents 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.

Utilisez le gestionnaire de médias Adobe Experience Manager à partir de la ligne de commande pour traiter les images via 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. Si vous envisagez de traiter des fichiers très volumineux à l’aide d’ImageMagick, comparez correctement le serveur Experience Manager. Certaines ressources utiles sont fournies à la fin.

REMARQUE

Si vous utilisez Experience Manager sur Adobe Managed Services (AMS), contactez le service clientèle d’Adobe si vous prévoyez de traiter de nombreux fichiers PSD ou PSB volumineux. Experience Manager peut ne pas traiter de fichiers PSB à très haute résolution de plus de 3 000 x 2 3000 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. Téléchargez les fichiers d’installation ImageMagick appropriés pour votre système d’exploitation.

  2. Pour installer ImageMagick sur le disque hébergeant le serveur Experience Manager, lancez le fichier d’installation.

  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. Effectuez les étapes suivantes pour générer une image inversée et des miniatures (140x100, 48x48, 319x319 et 1280x1280) chaque fois que vous ajoutez un fichier image JPEG à /content/dam sur le serveur Experience Manager :

  1. Sur le serveur Experience Manager, accédez à la console Processus (https://[aem_server]:[Port]/workflow) et ouvrez le modèle de workflow Ressource de mise à jour de gestion des actifs numériques .

  2. Dans le modèle de workflow Ressource de mise à jour de gestion des actifs numériques , ouvrez l’étape Miniatures EPS (optimisées par ImageMagick) .

  3. Dans l’onglet Arguments, ajoutez image/jpeg à la liste Types MIME.

    mime_types_jpeg

  4. Dans le champ Commandes, saisissez la commande suivante :

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

  5. Sélectionnez les indicateurs Supprimer le rendu généré et Générer le rendu web .

    select_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, spécifiez i image/jpeg dans la zone Type MIME.

    web_enabled_image

  7. Pour enregistrer les modifications, appuyez/cliquez sur OK.

    REMARQUE

    La commande convert peut ne pas s’exécuter avec certaines versions de Windows (par exemple, Windows SE), car elle est en conflit avec l’utilitaire convert natif qui fait partie de l’installation de Windows. 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. Ouvrez l’étape Miniatures des processus et ajoutez le type MIME image/jpeg sous Ignorer les types MIME.

    skip_mime_types

  9. Dans l’onglet Image Web, ajoutez le type MIME image/jpeg sous la Liste à ignorer. Pour enregistrer les modifications, appuyez/cliquez sur OK.

    web_enabled

  10. Enregistrez le workflow.

  11. Pour vérifier si ImageMagick peut traiter les images correctement, téléchargez une image .jpg vers Assets. Vérifiez si une image inversée et les rendus sont générés.

Atténuation 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, divers modules externes de traitement d’images dépendent de la bibliothèque ImageMagick, notamment, mais sans s’y limiter, imagick de PHP, rmagick et paperclip de Ruby et imagemagick de Node.js.

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. Vérifiez que tous les fichiers image commencent par les "octets magiques" attendus correspondant aux types de fichiers image que vous prenez en charge avant de les envoyer à ImageMagick pour traitement.
  2. Utilisez un fichier de stratégie pour désactiver les codeurs ImageMagick vulnérables. La stratégie globale pour ImageMagick se trouve à l’adresse /etc/ImageMagick.

Sur cette page