Installa e configura ImageMagick per lavorare con AEM 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. Utilizza ImageMagick per ridimensionare, capovolgere, speculare, ruotare, distorcere, inclinare e trasformare le immagini. È inoltre possibile regolare i colori dell'immagine, applicare vari effetti speciali o disegnare testo, linee, poligoni, ellissi e curve utilizzando ImageMagick.

Utilizza il gestore di file multimediali Adobe Experience Manager (AEM) dalla riga di comando per elaborare le immagini tramite ImageMagick. Per lavorare con vari formati di file utilizzando ImageMagick, consultare Best practice relative ai formati di file Assets. Per informazioni su tutti i formati di file supportati, consulta Formati supportati dalle risorse.

Per elaborare file di grandi dimensioni utilizzando ImageMagick, considera requisiti di memoria più elevati del solito, modifiche potenziali richieste ai criteri di IM e l'impatto complessivo sulle prestazioni. I requisiti di memoria dipendono da vari fattori come la risoluzione, la profondità di bit, il profilo colore e il formato file. Se si intende elaborare file di grandi dimensioni utilizzando ImageMagick, eseguire correttamente il benchmark del server AEM. Alla fine vengono fornite alcune risorse utili.

Installa ImageMagick

Sono disponibili più versioni di file di installazione ImageMagic per vari sistemi operativi. Utilizzare la versione appropriata per il sistema operativo in uso.

1. Scarica i file di installazione ImageMagick appropriati per il tuo sistema operativo.

2. Per installare ImageMagick sul disco che ospita il server AEM, avviare il file di installazione.

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

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

Imposta il passaggio del processo della riga di comando

Puoi impostare il passaggio del processo della riga di comando per il tuo caso d’uso specifico. Esegui questi passaggi per generare un’immagine capovolta e miniature (140x100, 48x48, 319x319 e 1280x1280) ogni volta che aggiungi un file immagine JPEG a /content/dam sul server di AEM:

1. Sul server AEM, vai alla console Flusso di lavoro (https://[aem_server]:[Port]/workflow) e apri il modello di flusso di lavoro Aggiorna risorsa DAM .

2. Dal modello di flusso di lavoro Risorsa di aggiornamento DAM , apri le miniature EPS (fornite da ImageMagick) .

3. Nella scheda Argomenti, aggiungi image/jpeg all'elenco Tipi di 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 , specifica i dettagli del rendering con dimensioni di 1280x1280 pixel. Inoltre, specifica i mage/jpeg nella casella Mimetype.

   

7. Tocca o fai clic su OK per salvare le modifiche.

   NOTA

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

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

8. Apri il passaggio Elabora miniature e aggiungi il tipo MIME image/jpeg in Ignora tipi MIME.

   

9. Nella scheda Immagine abilitata per il web , aggiungi il tipo MIME image/jpeg sotto Salta elenco. Tocca o fai clic su OK per salvare le modifiche.

   

10. Salva il flusso di lavoro.

11. Per verificare se ImageMagic è in grado di elaborare correttamente le immagini, carica un'immagine JPG in AEM Assets. Verifica se per essa vengono generate un’immagine capovolta e le relative rappresentazioni.

Riduzione delle vulnerabilità relative alla 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.

Inoltre, vari plug-in per l’elaborazione delle immagini dipendono dalla libreria ImageMagick, compresi, tra l’altro, l’immagine di PHP, il rmagick e il fermacarte di Ruby e l’immagine di Node.js.

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

1. Verifica che tutti i file di immagine inizino con i "byte magici" previsti corrispondenti ai tipi di file di immagine supportati prima di inviarli a ImageMagick per l'elaborazione.
2. Utilizza un file dei criteri per disabilitare i codificatori ImageMagick vulnerabili. Il criterio globale per ImageMagick si trova in /etc/ImageMagick.