DocumentazioneAEM 6.5Guida utente

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

Last update: Wed Mar 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Admin

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.

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

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 intendi elaborare file molto grandi utilizzando ImageMagick, effettua correttamente il benchmark del Experience Manager server. Alla fine vengono fornite alcune risorse utili.

NOTE
Se sta usando Experience Manager il 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 una risoluzione superiore a 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 il file appropriato File di installazione di ImageMagick per il sistema operativo.

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

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 capovolta e miniature (140x100, 48x48, 319x319 e 1280x1280) ogni volta che si aggiunge un file di immagine JPEG a /content/dam il Experience Manager server:

  1. Il giorno Experience Manager , passare alla console Flusso di lavoro (https://[aem_server]:[port]/workflow) e aprire la Aggiorna risorsa DAM modello di workflow.

  2. Dalla sezione Aggiorna risorsa DAM modello di flusso di lavoro, aprire Miniature di EPS (con tecnologia ImageMagick) passaggio.

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

    mime_types_jpeg

  4. In Comandi immetti il comando seguente:

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

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

    select_flags

  6. In Immagine abilitata per il web , specifica i dettagli della rappresentazione con dimensioni di 1280x1280 pixel. Inoltre, specifica image/jpeg nel Mimetype casella.

    immagine_abilitata_per_web

  7. Clic OK per salvare le modifiche.

    note note
    NOTE
    Il convert potrebbe non essere eseguito con alcune versioni di Windows (ad esempio, Windows SE), perché è in conflitto con il 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 Elabora miniature e aggiungi il tipo MIME image/jpeg in Ignora tipi MIME.

    skip_mime_types

  9. In Immagine abilitata per il web , aggiungi il tipo MIME image/jpeg sotto Ignora elenco. Clic OK per salvare le modifiche.

    web_enabled

  10. Salva il flusso di lavoro.

  11. Per verificare la corretta elaborazione, carica 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 il "byte magici" corrispondenti ai tipi di file immagine supportati prima di inviarli a ImageMagick per l'elaborazione.
  2. Utilizza un file di criteri per disabilitare i codificatori ImageMagick vulnerabili. Il criterio globale per ImageMagick si trova all'indirizzo /etc/ImageMagick.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2