DokumentationAEM 6.5Benutzerhandbuch

Beheben von Serialisierungsproblemen in AEM mitigating-serialization-issues-in-aem

Last update: Wed Apr 10 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Admin

Überblick overview

Das AEM-Team von Adobe hat eng mit dem Open-Source-Projekt NotSoSerial zusammengearbeitet, um die in CVE-2015-7501 beschriebenen Sicherheitsrisiken zu beheben. NotSoSerial ist unter der Apache 2-Lizenz lizenziert und beinhaltet ASM-Code, der unter der eigenen BSD-ähnlichen Lizenz lizenziert ist.

Bei der in diesem Paket enthaltenen Agent-JAR-Datei handelt es sich um die modifizierte NotSoSerial-Distribution von Adobe.

NotSoSerial ist eine Lösung auf Java™-Ebene für ein Problem auf Java™-Ebene und ist nicht AEM-spezifisch. Sie fügt einem Deserialisierungsversuch für ein Objekt eine Preflight-Prüfung hinzu. Diese Prüfung testet einen Klassennamen anhand einer Zulassungsliste im Firewall-Stil, einer Blockierungsliste oder beidem. Aufgrund der begrenzten Anzahl von Klassen in der Standard-Blockierungsliste hat dieser Test wahrscheinlich keinerlei Auswirkungen auf Ihre Systeme oder auf Ihren Code.

Standardmäßig führt der Agent eine Überprüfung der Blockierungsliste anhand der aktuellen bekannten anfälligen Klassen durch. Diese Blockierungsliste dient dazu, Sie vor der aktuellen Liste von Exploits zu schützen, die diese Art von Sicherheitsrisiko ausnutzen.

Eine Anleitung zum Konfigurieren der Blockierungsliste und der Zulassungsliste finden Sie im Abschnitt Konfigurieren des Agenten dieses Artikels.

Der Agent unterstützt Sie bei der Behandlung der neuesten bekannten Klassen mit Sicherheitsrisiko. Wenn Ihr Projekt nicht vertrauenswürdige Daten deserialisiert, kann es dennoch anfällig für Denial-of-Service(DoS)-Angriffe, Speicherangriffe und unbekannte zukünftige Deserialisierungs-Exploits sein.

Adobe unterstützt offiziell Java™ 6, 7 und 8. Adobe geht jedoch davon aus, dass NotSoSerial auch Java™ 5 unterstützt.

Installieren des Agenten installing-the-agent

NOTE
Falls Sie bereits das Serialisierungs-Hotfix für AEM 6.1 installiert haben, entfernen Sie die Startbefehle für den Agenten aus Ihrer Java™-Ausführungszeile.

  1. Installieren Sie das Bundle com.adobe.cq.cq-serialization-tester.

  2. Navigieren Sie zur Bundle-Web-Konsole (https://server:port/system/console/bundles).

  3. Suchen Sie nach dem Serialisierungs-Bundle und starten Sie es. Dadurch wird der NotSoSerial-Agent automatisch dynamisch geladen.

Installieren des Agenten auf Anwendungs-Servern installing-the-agent-on-application-servers

Der NotSoSerial-Agent ist nicht in der AEM-Standarddistribution für Anwendungs-Server enthalten. Sie können ihn jedoch aus der AEM-JAR-Distribution extrahieren und mit Ihrer Anwendungs-Server-Einrichtung verwenden:

  1. Laden Sie zuerst die AEM-Schnellstartdatei herunter und extrahieren Sie sie:

    code language-shell 
    java -jar aem-quickstart-6.2.0.jar -unpack

  2. Navigieren Sie zum Speicherort des gerade entpackten Schnellstarts und kopieren Sie den Ordner crx-quickstart/opt/notsoserial/ in den Ordner crx-quickstart der AEM-Anwendungs-Server-Installation.

  3. Legen Sie den Benutzer, der den Server betreibt, als Besitzer von /opt fest:

    code language-shell 
    chown -R opt <user running the server>

  4. Konfigurieren Sie den Agenten und vergewissern Sie sich, dass er ordnungsgemäß aktiviert wurde, wie in den folgenden Abschnitten dieses Artikels gezeigt.

Konfigurieren des Agenten configuring-the-agent

Die Standardkonfiguration ist für die meisten Installationen ausreichend. Diese Konfiguration umfasst eine Blockierungsliste bekannter anfälliger Remote-Klassen und eine Zulassungsliste von Paketen, in denen die Deserialisierung vertrauenswürdiger Daten sicher ist.

Die Firewall-Konfiguration ist dynamisch und kann jederzeit wie folgt geändert werden:

  1. Wechseln zur Web-Konsole unter https://server:port/system/console/configMgr

  2. Suchen Sie nach Deserialisierungs-Firewall-Konfiguration und klicken Sie darauf.

    note note
    NOTE
    Sie können die Konfigurationsseite auch direkt erreichen, indem Sie auf die URL zugreifen:
    • https://server:port/system/console/configMgr/com.adobe.cq.deserfw.impl.DeserializationFirewallImpl

Diese Konfiguration enthält die Zulassungsliste, die Blockierungsliste und die Deserialisierungs-Protokollierung.

Zulassungslisten

Für die Klassen oder Paketpräfixe im Zulassungslisten-Abschnitt wird die Deserialisierung zugelassen. Wenn Sie eigene Klassen deserialisieren, fügen Sie entweder die Klassen oder Pakete zu dieser Zulassungsliste hinzu.

Blockierungslisten

Der Abschnitt „Blockierungslisten“ enthält Klassen, für die in keinem Fall eine Deserialisierung zugelassen wird. Standardmäßig umfasst die Liste nur Klassen, die für Remoteausführungsangriffe anfällig sind. Die Blockierungsliste wird vor allen in der Zulassungsliste aufgeführten Einträgen angewendet.

Diagnoseprotokollierung

Im Abschnitt für die Diagnoseprotokollierung stehen verschiedene Protokollierungsoptionen für die Deserialisierung zur Verfügung. Diese werden nur bei der ersten Verwendung protokolliert. Bei erneuter Verwendung findet keine erneute Protokollierung statt.

Der Standardwert class-name-only gibt Aufschluss über die Klassen, die deserialisiert werden.

Sie können auch die Option full-stack festlegen. In diesem Fall wird ein Java™-Stack des ersten Deserialisierungsversuchs protokolliert, um Sie darüber zu informieren, wo Ihre Deserialisierung stattfindet. Diese Option ist nützlich, um eine Deserialisierung in Ihrer Verwendung zu finden und zu entfernen.

Überprüfen der Agenten-Aktivierung verifying-the-agent-s-activation

Die Konfiguration des Deserialisierungs-Agenten kann unter folgender URL geprüft werden:

  • https://server:port/system/console/healthcheck?tags=deserialization

Nachdem Sie auf die URL zugegriffen haben, wird eine Liste mit Integritätsprüfungen für den Agenten angezeigt. Sie können feststellen, ob der Agent ordnungsgemäß aktiviert ist, indem Sie überprüfen, ob die Konsistenzprüfungen erfolgreich sind. Wenn sie fehlschlagen, müssen Sie den Agenten manuell laden.

Weitere Informationen zum Behandeln von Problemen mit dem Agenten finden Sie weiter unten unter Behandeln von Fehlern beim dynamischen Laden des Agenten.

NOTE
Wenn Sie org.apache.commons.collections.functors auf die Zulassungsliste setzen, schlägt die Konsistenzprüfung immer fehl.

Behandeln von Fehlern beim dynamischen Laden des Agenten handling-errors-with-dynamic-agent-loading

Wenn das Protokoll Fehler enthält oder bei den Überprüfungsschritten ein Ladeproblem für den Agenten festgestellt wird, muss der Agent gegebenenfalls manuell geladen werden. Dieser Workflow wird auch empfohlen, wenn Sie JRE (Java™ Runtime Environment) anstelle eines JDK (Java™ Development Toolkit) verwenden, da die Tools für das dynamische Laden nicht verfügbar sind.

Gehen Sie wie folgt vor, um den Agenten manuell zu laden:

  1. Bearbeiten Sie die JVM-Startparameter der CQ-JAR-Datei und fügen Sie die folgende Option hinzu:

    code language-shell 
    -javaagent:<aem-installation-folder>/crx-quickstart/opt/notsoserial/notsoserial.jar
    note note
    NOTE
    Erfordert, dass Sie auch die Option -nofork CQ/AEM zusammen mit den entsprechenden JVM-Speichereinstellungen verwenden, da der Agent auf einer abgespalteten JVM nicht aktiviert ist.
    note note
    NOTE
    Die Adobe-Distribution der JAR-Datei des NotSoSerial-Agenten finden Sie im Ordner crx-quickstart/opt/notsoserial/ Ihrer AEM-Installation.

  2. Beenden Sie die JVM-Instanz und starten Sie sie neu.

  3. Überprüfen Sie mithilfe der unter Überprüfen der Agenten-Aktivierung beschriebenen Schritte erneut die Aktivierung des Agenten.

Weitere Überlegungen other-considerations

Lesen Sie bei Verwendung einer JVM von IBM die Dokumentation zur Unterstützung der Java Attach-API. Diese finden Sie hier.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2