Installazione e configurazione di ImageMagick per l'utilizzo con Experience Manager Assets

ImageMagick è un plug-in software per creare, modificare, comporre o convertire immagini bitmap. Può leggere e scrivere immagini in vari formati (oltre 200), tra cui PNG, JPEG, JPEG-2000, GIF, TIFF, DPX, EXR, WebP, Postscript, PDF e SVG. ImageMagick consente di ridimensionare, riflettere, ruotare, distorcere, inclinare e trasformare le immagini. Con ImageMagick potete anche regolare i colori delle immagini, applicare vari effetti speciali o disegnare testo, linee, poligoni, ellissi e curve.

Utilizzate il gestore Adobe Experience Manager multimediale dalla riga di comando per elaborare le immagini tramite ImageMagick. Per utilizzare vari formati di file con ImageMagick, consultare le procedure ottimali per i formati di file Risorse. Per ulteriori informazioni su tutti i formati di file supportati, vedere Formati di risorse supportati.

Per elaborare file di grandi dimensioni con ImageMagick, considerate requisiti di memoria superiori a quelli usuali, modifiche potenziali richieste ai criteri IM e l'impatto complessivo sulle prestazioni. I requisiti di memoria dipendono da vari fattori come risoluzione, profondità di bit, profilo colore e formato file. Se intendete elaborare file molto grandi utilizzando ImageMagick, eseguite correttamente il benchmark del server Experience Manager. Alla fine vengono fornite alcune risorse utili.

Installazione di ImageMagick

Sono disponibili diverse versioni dei file di installazione ImageMagic per vari sistemi operativi. Utilizzate la versione appropriata per il sistema operativo in uso.

1. Scaricate i file di installazione ImageMagick appropriati per il sistema operativo in uso.

2. Per installare ImageMagick sul disco che ospita il server Experience Manager, avviate il file di installazione.

3. Impostate la variabile del percorso Ambiente sulla directory di installazione di ImageMagic.

4. Per verificare se l'installazione è riuscita, eseguire il comando identify -version.

Impostare il passaggio della riga di comando

È possibile impostare il passaggio della riga di comando per il caso di utilizzo specifico. Effettuate le seguenti operazioni per generare un'immagine capovolta e le miniature (140x100, 48x48, 319x319 e 1280x1280) ogni volta che aggiungete un file di immagine JPEG a /content/dam sul server Experience Manager:

1. Sul server Experience Manager, andate alla console Flusso di lavoro (https://[aem_server]:[port]/workflow) e aprite il modello di flusso di lavoro Aggiorna risorsa DAM.

2. Dal modello di flusso di lavoro DAM Update Asset, aprite le miniature EPS (con ImageMagick)].[

3. Nella scheda Argomenti, aggiungere image/jpeg all'elenco Tipi mime.

   

4. Nella casella Comandi, immettere il comando seguente:

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

5. Selezionare i flag Elimina rappresentazione generata e Genera rappresentazione Web.

   

6. Nella scheda Immagine abilitata per il Web, specificate i dettagli per la rappresentazione con dimensioni 1280x1280 pixel. Inoltre, specificare image/jpeg nella casella Mimetype.

   

7. Fate clic su OK per salvare le modifiche.

   NOTA

   Il comando convert potrebbe non essere eseguito con alcune versioni di Windows (ad esempio, Windows SE), in quanto è in conflitto con l'utility convert nativa che fa parte dell'installazione di Windows. In questo caso, indicare il percorso completo per l'utilità ImageMagick. Ad esempio, specificate

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

8. Aprire il passaggio Miniature processo e aggiungere il tipo MIME image/jpeg in Skip Mime Types.

   

9. Nella scheda Immagine abilitata per il Web, aggiungere il tipo MIME image/jpeg in Skip List. Fate clic su OK per salvare le modifiche.

   

10. Salvare il flusso di lavoro.

11. Per verificare la corretta elaborazione, caricate un'immagine JPG in Assets. Al termine dell'elaborazione, verificate se un'immagine capovolta e le rappresentazioni vengono generate o meno.

Riduzione delle vulnerabilità di sicurezza

L’utilizzo di ImageMagick per elaborare le immagini presenta diverse vulnerabilità di sicurezza. Ad esempio, l’elaborazione di immagini inviate dall’utente comporta il rischio di esecuzione di codice remoto (RCE).

Inoltre, diversi plug-in per l'elaborazione delle immagini dipendono dalla libreria ImageMagick, tra cui, tra l'altro, l'immagine di PHP, il clip di immagine di Ruby e l'immagine di nodejs.

Se si utilizza ImageMagick o una libreria interessata, Adobe consiglia di attenuare le vulnerabilità note eseguendo almeno una delle seguenti operazioni (preferibilmente entrambe):

1. Verificate che tutti i file di immagine inizino con i "byte magici" che corrispondono ai tipi di file di immagine supportati prima di inviarli a ImageMagick per l'elaborazione.
2. Usate un file di criteri per disabilitare i codificatori ImageMagick vulnerabili. Il criterio globale per ImageMagick è disponibile all'indirizzo /etc/ImageMagick.