Installieren und konfigurieren Sie ImageMagick, um mit AEM Assets arbeiten zu können.

ImageMagick ist ein Software-Plug-in zum Erstellen, Bearbeiten, Zusammenstellen oder Konvertieren von Bitmap-Bildern. Es kann Bilder in verschiedenen Formaten (über 200) lesen und schreiben, darunter PNG, JPEG, JPEG-2000, GIF, TIFF, DPX, EXR, WebP, Postscript, PDF und SVG. Verwenden Sie ImageMagick, um die Größe von Bildern zu ändern, Bilder zu kippen, zu spiegeln, zu drehen, zu verzerren, zuzuschneiden und umzuwandeln. Darüber hinaus können Sie mit ImageMagick die Bildfarben anpassen, verschiedene Spezialeffekte anwenden oder Text, Linien, Polygone, Ellipsen und Kurven zeichnen.

Verwenden Sie den Medien-Handler von Adobe Experience Manager (AEM) über die Befehlszeile, um Bilder mithilfe von ImageMagick zu verarbeiten. Unter Best Practices für Assets-Dateiformate finden Sie weitere Informationen zur Verwendung verschiedener Dateiformate mit ImageMagick. Unter Von Assets unterstützte Formate erfahren Sie mehr zu allen unterstützten Dateiformaten.

Um große Dateien mit ImageMagick zu verarbeiten, sollten Sie höhere Speicheranforderungen, potenzielle Änderungen an IM-Richtlinien und die Gesamtauswirkung auf die Leistung berücksichtigen. Die Speicheranforderungen hängen von verschiedenen Faktoren wie Auflösung, Bittiefe, Farbprofil und Dateiformat ab. Wenn Sie sehr große Dateien mit ImageMagick verarbeiten möchten, müssen Sie ein ordnungsgemäßes AEM-Server-Benchmark durchführen. Einige hilfreiche Ressourcen finden Sie weiter unten.

Installieren von ImageMagick

Es sind mehrere ImageMagick-Installationsdateien für verschiedene Betriebssysteme verfügbar. Verwenden Sie die entsprechende Version für Ihr Betriebssystem.

1. Laden Sie die entsprechenden ImageMagick-Installationsdateien für Ihr Betriebssystem herunter.

2. Um ImageMagick auf der Festplatte zu installieren, auf der der AEM-Server gehostet wird, starten Sie die Installationsdatei.

3. Legen Sie die Path-Umgebungsvariable auf das ImageMagick-Installationsverzeichnis fest.

4. Um zu überprüfen, ob die Installation erfolgreich war, führen Sie den Befehl identify -version aus.

Einrichten des Befehlszeilenprozessschritts

Sie können den Befehlszeilenprozesssschritt für Ihren jeweiligen Anwendungsfall einrichten. Führen Sie diese Schritte aus, um jedes Mal, wenn Sie eine JPEG-Bilddatei zu /content/dam auf dem AEM hinzufügen, ein gespiegeltes Bild und Miniaturansichten (140x100, 48x48, 319x319 und 1280x1280) zu generieren:

1. Wechseln Sie auf dem AEM-Server zur Workflow-Konsole (https://[aem_server]:[Port]/workflow) und öffnen Sie das Workflow-Modell DAM Update Asset .

2. Öffnen Sie im Workflow-Modell DAM Update Asset den Schritt EPS-Miniaturansichten (unterstützt von ImageMagick) .

3. Fügen Sie auf der Registerkarte Argumente image/jpeg der Liste MIME-Typen hinzu.

   

4. Geben Sie im Feld Befehle folgenden Befehl ein:

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

5. Wählen Sie die Flags Erzeugte Ausgabe löschen und Web-Ausgabe generieren aus.

   

6. Legen Sie auf der Registerkarte Webfähiges Bild die Details für die Ausgabedarstellung mit 1280x1280 Pixel fest. Geben Sie außerdem i image/jpeg im Feld Mimetype an.

   

7. Tippen/klicken Sie auf OK, um die Änderungen zu speichern.

   HINWEIS

   Der Befehl convert wird möglicherweise nicht mit bestimmten Windows-Versionen (z. B. Windows SE) ausgeführt, da er in Konflikt mit dem nativen Dienstprogramm convert steht, das Teil der Windows-Installation ist. Geben Sie in diesem Fall den vollständigen Pfad zum ImageMagick-Programm an. Geben Sie zum Beispiel Folgendes an:

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

8. Öffnen Sie den Schritt Miniaturansichten verarbeiten und fügen Sie den MIME-Typ image/jpeg unter MIME-Typen überspringen hinzu.

   

9. Fügen Sie auf der Registerkarte Webfähiges Bild den MIME-Typ image/jpeg unter Liste zum Überspringen hinzu. Tippen/klicken Sie auf OK, um die Änderungen zu speichern.

   

10. Speichern Sie den Workflow.

11. Um zu überprüfen, ob ImageMagick Bilder ordnungsgemäß verarbeiten kann, laden Sie ein .JPG-Bild in AEM Assets hoch. Stellen Sie sicher, ob dafür ein gekipptes Bild und die entsprechenden Ausgabedarstellungen generiert werden.

Reduzieren von Sicherheitslücken

Aus der Verwendung von ImageMagick für die Bearbeitung von Bildern resultieren mehrere Sicherheitslücken. Beispielsweise bringt die Verarbeitung von Bildern, die von Benutzern übermittelt wurden, das Risiko der Ferncodeausführung mit sich.

Darüber hinaus hängen verschiedene Bildverarbeitungs-Plug-ins von der ImageMagick-Bibliothek ab, darunter der imagick von PHP, Rmagick und Paperclip von Ruby und Node.js imagemagick.

Wenn Sie ImageMagick oder eine betroffene Bibliothek verwenden, empfiehlt Adobe, die bekannten Sicherheitslücken zu minimieren, indem Sie mindestens eine der folgenden Aufgaben ausführen (vorzugsweise beide):

1. Stellen Sie sicher, dass alle Bilddateien mit den erwarteten "magischen Bytes" beginnen, die den von Ihnen unterstützten Bilddateitypen entsprechen, bevor Sie sie zur Verarbeitung an ImageMagick senden.
2. Verwenden Sie eine Richtliniendatei, um die verwundbaren ImageMagick-Codes zu deaktivieren. Die globale Richtlinie für ImageMagick finden Sie unter /etc/ImageMagick.