DokumentationAEM 6.5Benutzerhandbuch

Installieren und konfigurieren Sie ImageMagick, um mit Experience Manager Assets arbeiten zu können. install-and-configure-imagemagick-to-work-with-aem-assets

Last update: Sun Mar 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Admin

ImageMagick-Software ist ein Software-Plug-in zum Erstellen, Bearbeiten, Zusammenzusetzen oder Konvertieren von Bitmap-Bildern. Es kann Bilder in über 200 Formaten 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 ü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, potenziell erforderliche Änderungen an IM-Richtlinien und die Gesamtauswirkung auf die Leistung berücksichtigen.  Die Speicheranforderungen hängen von verschiedenen Faktoren wie Auflösung, Bit-Tiefe, Farbprofil und Dateiformat ab.  Wenn Sie sehr große Dateien mit ImageMagick verarbeiten möchten, müssen Sie ein ordnungsgemäßes Experience Manager-Server-Benchmark durchführen. Einige hilfreiche Ressourcen finden Sie weiter unten.

NOTE
Wenn Sie Experience Manager in Adobe Managed Services (AMS) verwenden, wenden Sie sich an den Kunden-Support von Adobe, falls Sie viele PSD- oder PSB-Dateien mit hoher Auflösung verarbeiten möchten. Experience Manager kann keine PSB-Dateien mit sehr hoher Auflösung verarbeiten, die mehr als 30000 x 23000 Pixel groß sind.

Installieren von ImageMagick installing-imagemagick

ImageMagick-Installationsdateien sind in mehreren Versionen 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 Experience Manager-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 set-up-the-command-line-process-step

Sie können den Befehlszeilenprozessschritt für Ihren jeweiligen Anwendungsfall einrichten. Führen Sie diese Schritte aus, um jedes Mal eine gespiegelte Version von Bildern und Miniaturansichten (140x100, 48x48, 319x319 und 1280x1280) zu erstellen, wenn Sie eine JPEG-Bilddatei zum Verzeichnis /content/dam auf dem Experience Manager-Server hinzufügen:

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

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

  3. Fügen Sie in der Registerkarte „Argumente“ image/jpeg zur Liste MIME-Typen hinzu.

    mime_types_jpeg

  4. Geben Sie im Feld Befehle folgenden Befehl ein:

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

  5. Aktivieren Sie die Flags Erzeugte Ausgabedarstellung löschen und Webausgabe erstellen.

    select_flags

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

    web_enabled_image

  7. Klicken Sie auf OK, um die Änderungen zu speichern.

    note note
    NOTE
    In manchen Versionen von Windows (z. B. Windows SE) kann der Befehl convert fehlschlagen, 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-Dienstprogramm 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.

    skip_mime_types

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

    web_enabled

  10. Speichern Sie den Workflow.

  11. Laden Sie zur Überprüfung der ordnungsgemäßen Verarbeitung ein JPG-Bild in Assets hoch. Überprüfen Sie nach Abschluss der Verarbeitung, ob ein gespiegeltes Bild und die Ausgabedarstellungen generiert wurden oder nicht.

Minimieren von Sicherheitslücken mitigating-security-vulnerabilities

Die Verwendung von ImageMagick zur Bildverarbeitung ist mit mehreren Sicherheitslücken verbunden. Beispielsweise birgt die Verarbeitung von benutzerseitig übermittelten Bildern das Risiko einer ferngesteuerten Code-Ausführung (Remote Code Execution, RCE).

Außerdem ist eine Reihe von Bildverarbeitungs-Plug-ins von der ImageMagick-Bibliothek abhängig, darunter „imagick“ von PHP, „rmagick“ und „paperclip“ von Ruby sowie „imagemagick“ von Nodejs.

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. Vergewissern Sie sich, dass alle Bilddateien in Übereinstimmung mit den von Ihnen unterstützten Bilddateitypen mit den erwarteten „magischen Bytes“ beginnen, bevor Sie sie zur Verarbeitung an ImageMagick senden.
  2. Verwenden Sie eine Richtliniendatei, um die anfälligen ImageMagick-Codierer zu deaktivieren. Die globale Richtlinie für ImageMagick ist in /etc/ImageMagick zu finden.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2