Installa e configura ImageMagick per lavorare con Experience Manager Assets install-and-configure-imagemagick-to-work-with-aem-assets

CAUTION
AEM 6.4 ha raggiunto la fine del supporto esteso e questa documentazione non viene più aggiornata. Per maggiori dettagli, consulta la nostra periodi di assistenza tecnica. Trova le versioni supportate qui.

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 contenuti multimediali Adobe Experience Manager dalla riga di comando per elaborare le immagini tramite ImageMagick. Per lavorare con vari formati di file utilizzando ImageMagick, vedi Best practice per i formati di file risorse. Per informazioni su tutti i formati di file supportati, consulta Formati supportati da Assets.

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 Experience Manager server. Alla fine vengono fornite alcune risorse utili.

NOTE
Se utilizzi Experience Manager in Adobe Managed Services (AMS), contatta l’Assistenza clienti Adobe se intendi elaborare molti file PSD o PSB di grandi dimensioni. Experience Manager potrebbe non elaborare file PSB ad altissima risoluzione con una risoluzione superiore a 30000x23000 pixel.

Installa ImageMagick installing-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 il File di installazione di ImageMagick per il sistema operativo in uso.

  2. Per installare ImageMagick sul disco che ospita il Experience Manager server, 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 la identify -version comando.

Imposta il passaggio del processo della riga di comando set-up-the-command-line-process-step

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 sulla Experience Manager server:

  1. Sulla Experience Manager , passa alla console Flusso di lavoro (https://[aem_server]:[Port]/workflow) e apri la Risorsa di aggiornamento DAM modello di flusso di lavoro.

  2. Da Risorsa di aggiornamento DAM modello di flusso di lavoro, apri Miniature EPS (con tecnologia ImageMagick) passo.

  3. In Scheda Argomenti, aggiungi image/jpeg al Tipi di mime elenco.

    mime_types_jpeg

  4. In Comandi immettere il comando seguente:

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

  5. Seleziona la Elimina rappresentazione generata e Genera rappresentazione web bandiere.

    select_flags

  6. In Immagine abilitata per il web specifica i dettagli del rendering con dimensioni 1280x1280 pixel. Inoltre, specifica i mage/jpeg in Mimetype scatola.

    web_enabled_image

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

    note note
    NOTE
    La convert Impossibile eseguire il comando con alcune versioni di Windows (ad esempio Windows SE), perché è in conflitto con il parametro nativo convert Utilità 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 Miniature del processo e aggiungi il tipo MIME image/jpeg sotto Ignora tipi mime.

    skip_mime_types

  9. In Immagine abilitata per il web , aggiungi il tipo MIME image/jpeg in Ignora elenco. Tocca o fai clic su OK per salvare le modifiche.

    web_enabled

  10. Salva il flusso di lavoro.

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

Riduzione delle vulnerabilità relative alla sicurezza mitigating-security-vulnerabilities

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 il previsto "byte magici" corrispondente ai tipi di file immagine supportati prima di inviarli a ImageMagick per l’elaborazione.
  2. Utilizza un file dei criteri per disabilitare i codificatori ImageMagick vulnerabili. La policy globale di ImageMagick si trova all'indirizzo /etc/ImageMagick.
recommendation-more-help
4452738f-2bdf-4cd4-9b45-905a69d607ad