DocumentazioneAEM 6.5Guida utente

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

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Amministratore

ImageMagick è un plug-in software per creare, modificare, comporre o convertire immagini bitmap. È in grado di leggere e scrivere immagini in vari formati (oltre 200) tra cui PNG, JPEG, JPEG-2000, GIF, TIFF, DPX, EXR, WebP, Postscript, PDF e SVG. Utilizzare ImageMagick per ridimensionare, capovolgere, specchiare, ruotare, distorcere, tranciare e trasformare le immagini. È inoltre possibile regolare i colori delle immagini, applicare vari effetti speciali o disegnare testo, linee, poligoni, ellissi e curve utilizzando ImageMagick.

Utilizzare il gestore multimediale Adobe Experience Manager dalla riga di comando per elaborare le immagini tramite ImageMagick. Per utilizzare vari formati di file con ImageMagick, consulta Best practice per i formati di file Assets. Per informazioni su tutti i formati di file supportati, vedere Formati supportati da Assets.

Per elaborare file di grandi dimensioni utilizzando ImageMagick, considera requisiti di memoria superiori al solito, potenziali modifiche necessarie ai criteri 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 del file. Se si desidera elaborare file di grandi dimensioni tramite ImageMagick, eseguire correttamente il benchmark del server Experience Manager. Alla fine vengono fornite alcune risorse utili.

NOTE
Se utilizzi Experience Manager su Adobe Managed Services (AMS), contatta l'Assistenza clienti Adobe se intendi elaborare molti file PSD o PSB ad alta risoluzione. Experience Manager potrebbe non elaborare file PSB ad alta risoluzione con più di 30000 x 23000 pixel.

Installare ImageMagick installing-imagemagick

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

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

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

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

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

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

È possibile impostare il passaggio della riga di comando per il caso d’uso specifico. Eseguire la procedura seguente per generare un'immagine invertita e miniature (140x100, 48x48, 319x319 e 1280x1280) ogni volta che si aggiunge un file di immagine JPEG a /content/dam sul server Experience Manager:

  1. Nel server Experience Manager, vai alla console Flusso di lavoro (https://[aem_server]:[port]/workflow) e apri il modello di flusso di lavoro Risorsa di aggiornamento DAM.

  2. Dal modello di flusso di lavoro Risorsa di aggiornamento DAM, apri il passaggio Miniature EPS (con tecnologia ImageMagick).

  3. Nella scheda Argomenti, aggiungi image/jpeg all'elenco Tipi MIME.

    tipi_mime_jpeg

  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.

    select_flags

  6. Nella scheda Immagine abilitata per il Web, specifica i dettagli per il rendering con dimensioni di 1280x1280 pixel. Specificare inoltre image/jpeg nella casella Mimetype.

    immagine_abilitata per il Web

  7. Fare clic su OK per salvare le modifiche.

    note note
    NOTE
    Il comando convert potrebbe non essere eseguito con alcune versioni di Windows (ad esempio, Windows SE), perché è in conflitto con l'utilità nativa convert che fa parte dell'installazione di Windows. In questo caso, indicare il percorso completo dell'utility 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.

    tipi_skip_mime

  9. Nella scheda Immagine abilitata per il Web, aggiungi il tipo MIME image/jpeg nell'Elenco di salto. Fare clic su OK per salvare le modifiche.

    abilitata per il Web

  10. Salva il flusso di lavoro.

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

Mitigazione delle vulnerabilità di sicurezza mitigating-security-vulnerabilities

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

Inoltre, vari plug-in di elaborazione delle immagini dipendono dalla libreria ImageMagick, tra cui, ma non solo, imagemagick di PHP, ruby's magick e paperclip e imagemagick di nodejs.

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

  1. Verificare 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 di criteri per disabilitare i codificatori ImageMagick vulnerabili. Criterio globale per ImageMagick trovato in /etc/ImageMagick.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2