Proxy-Server-Tool (proxy.jar)

Der Proxyserver fungiert als Zwischenserver, der Anforderungen zwischen einem Client und einem Server weiterleitet. Der Proxyserver verfolgt alle Interaktionen zwischen Client und Server und gibt ein Protokoll der gesamten TCP-Kommunikation aus. Auf diese Weise können Sie genau überwachen, was passiert, ohne auf den Hauptserver zugreifen zu müssen.

Sie finden den Proxyserver im entsprechenden Installationsordner:

• <cq_install_path>/opt/helpers/proxy.jar
• <crx_install_path>/opt/helpers/proxy.jar

Sie können den Proxy-Server verwenden, um alle Interaktionen zwischen Client und Server unabhängig vom zugrunde liegenden Kommunikationsprotokoll zu überwachen. Sie können beispielsweise die folgenden Protokolle überwachen:

• HTTP für Webseiten
• HTTPS für sichere Webseiten
• SMTP für E-Mail-Nachrichten
• LDAP für die Benutzerverwaltung

Sie können beispielsweise den Proxyserver zwischen zwei Anwendungen positionieren, die über ein TCP/IP-Netzwerk kommunizieren, z. B. einem Webbrowser und AEM. Auf diese Weise können Sie genau überwachen, was bei der Anforderung einer AEM passiert.

Starten des Proxyserver-Tools

Das Tool befindet sich im Ordner /opt/helpers Ihrer AEM-Installation. Geben Sie Folgendes ein, um es zu starten:

java -jar proxy.jar <host> <remoteport> <localport> [options]

Optionen

• q (leiser Modus) Die Anforderungen werden nicht in das Konsolenfenster geschrieben. Verwenden Sie dies, wenn Sie die Verbindung nicht verlangsamen möchten oder die Ausgabe in einer Datei protokollieren (siehe Option -logfile ).
• b (binärer Modus) Wenn Sie nach bestimmten Byte-Kombinationen im Traffic suchen, aktivieren Sie den Binärmodus. Die Ausgabe enthält die hexadezimale und die Zeichenausgabe.
• t (Zeitstempelprotokolleinträge) Fügt jeder Protokollausgabe einen Zeitstempel hinzu. Der Zeitstempel wird in Sekunden angegeben, sodass er möglicherweise nicht für die Überprüfung einzelner Anforderungen geeignet ist. Verwenden Sie sie, um Ereignisse zu suchen, die zu einem bestimmten Zeitpunkt aufgetreten sind, wenn Sie den Proxyserver über einen längeren Zeitraum verwenden.
• logfile <filename> (In Protokolldatei schreiben): Verwenden Sie diese Option, um die Konversation zwischen Client und Server in eine Protokolldatei zu schreiben. Dieser Parameter funktioniert auch im stillen Modus.
• i <numindentions> (Einzug hinzufügen) Jede aktive Verbindung wird für eine bessere Lesbarkeit eingerückt. Der Standardwert beträgt 16 Ebenen. (Neu in proxy.jar Version 1.16).

Verwendung des Proxyserver-Tools

In den folgenden Szenarien werden ein paar Einsatzzwecke demonstriert, für die das Proxyserver-Tool eingesetzt werden können:

Suchen nach Cookies und ihren Werten

Das folgende Beispiel für einen Protokolleintrag zeigt alle Cookies und deren Werte, die vom Client bei der sechsten seit dem Proxy-Start geöffneten Verbindung gesendet werden:

C-6-#000635 -> [Cookie: cq3session=7e39bc51-ac72-3f48-88a9-ed80dbac0693; Show=ShowMode; JSESSIONID=68d78874-cabf-9444-84a4-538d43f5064d ]

Überprüfen von Kopfzeilen und ihren Werten Das folgende Beispiel für einen Protokolleintrag zeigt, dass der Server eine Keep-Alive-Verbindung herstellen kann und der Header für die Inhaltslänge ordnungsgemäß festgelegt wurde:

S-7-#000017 -> [Connection: Keep-Alive ]
...
S-7-#000107 -> [Content-Length: 124 ]

Überprüfen der Funktionsfähigkeit von Keep-Alive

Keep-Alive bedeutet, dass ein Client die Verbindung zum Server wiederverwendet, um mehrere Dateien (Seiten-Code, Bilder, Stylesheets usw.) zu transportieren. Ohne Keep-Alive muss der Client für jede Anfrage eine neue Verbindung aufbauen.

So überprüfen Sie, ob Keep-Alive funktioniert:

1. Starten Sie den Proxyserver.
2. Fragen Sie eine Seite an.

• Wenn Keep-Alive funktioniert, sollte der Verbindungszähler nie über 5 bis 10 Verbindungen hinausgehen.
• Wenn Keep-Alive nicht funktioniert, steigt der Verbindungszähler schnell.

Finden verlorener Anfragen

Wenn Sie Anforderungen in einer komplexen Servereinstellung verlieren, z. B. mit einer Firewall und einem Dispatcher, können Sie den Proxy-Server verwenden, um herauszufinden, wo die Anforderung verloren ging. Wenn eine Firewall vorhanden ist:

1. Proxy vor einer Firewall starten
2. Starten Sie einen weiteren Proxy nach einer Firewall.
3. Verwenden Sie die Proxys, um herauszufinden, wie weit die Anfragen kommen.

Hängende Anfragen

Gehen Sie wie folgt vor, wenn gelegentlich hängende Anfragen auftreten:

1. Starten Sie proxy.jar.
2. Warten oder schreiben Sie das Zugriffsprotokoll in eine Datei, wobei jeder Eintrag einen Zeitstempel aufweist.
3. Wenn die Anfrage beginnt zu hängen, können Sie sehen, wie viele Verbindungen geöffnet waren und welche Anfrage Probleme verursacht.

Das Format von Protokollmeldungen

Die von proxy.jar erstellten Protokolleinträge haben alle das folgende Format:

[timestamp (optional)] [<b>C</b>lient|<b>S</b>erver]-[ConnectionNumber]-[BytePosition] ->[Character Stream]

So kann eine Web-Seitenanfrage zum Beispiel wie folgt aussehen:

C-0-#000000 -> [GET /author/prox.html?CFC_cK=1102938422341 HTTP/1.1 ]

• „C“ gibt an, dass dieser Eintrag vom Client stammt (es handelt sich dabei um die Anfrage einer Web-Seite).
• 0 ist die Verbindungsnummer (der Verbindungszähler beginnt bei 0)
• #00000 ist der Versatz im Bytestream. Hierbei handelt es sich um den ersten Eintrag, weshalb der Versatz bei 0 ist.
• [GET <?>] ist der Inhalt der Anfrage, im Beispiel eine der HTTP-Kopfzeilen (URL).

Wenn eine Verbindung geschlossen wird, werden die folgenden Informationen protokolliert:

C-6-Finished: 758 bytes (1.0 kb/s)
S-6-Finished: 665 bytes (1.0 kb/s)

Dies zeigt die Anzahl der Bytes, die zwischen Client und Server bei der sechsten Verbindung und mit der durchschnittlichen Geschwindigkeit übergeben wurden.

Beispiel für eine Protokollausgabe

Überprüfen Sie eine einfache Vorlage, die bei Bedarf den folgenden Code erzeugt:

<html>
  <head>
    <title>Welcome</title>
  </head>
  <body>
    Welcome to Playground<br>
    <img src="/logo.gif">
  </body>
</html>

Wenn AEM auf localhost:4303 ausgeführt wird, starten Sie den Proxyserver wie folgt:

java -jar proxy.jar localhost 4303 4444 -logfile test.log

Sie können auf den Server zugreifen (localhost:4303) ohne den Proxy-Server, aber wenn Sie über darauf zugreifen localhost:4444, protokolliert der Proxyserver die Kommunikation. Öffnen Sie einen Browser und greifen Sie auf eine mit der obigen Vorlage erstellte Seite zu. Sehen Sie sich danach die Protokolldatei an.

Beim Start werden die folgenden Informationen in das Protokoll geschrieben:

starting proxy for localhost:4303 on port 4444
using logfile: C:\CQUnify355default\opt\helpers\test.log

Die folgenden Kopfzeilenfelder werden am Anfang der ersten Verbindung (0) aufgelistet, die die Hauptseite der HTML anfordert:

C-0-#000000 -> [GET /author/prox.html?CFC_cK=1102936796533 HTTP/1.1 ]
C-0-#000053 -> [Accept: image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, application/vnd.ms-powerpoint, application/vnd.ms-excel, application/msword, appl]
C-0-#000194 -> [ication/x-shockwave-flash, */* ]
C-0-#000227 -> [Accept-Language: de-ch ]
C-0-#000251 -> [Accept-Encoding: gzip, deflate ]
C-0-#000283 -> [User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0) ]
C-0-#000347 -> [Host: localhost:4444 ]

Der Client fordert eine Keep-Alive-Verbindung an, damit der Server mehrere Dateien über dieselbe Verbindung senden kann:

C-0-#000369 -> [Connection: Keep-Alive ]

Der Proxy-Server ist ein gutes Tool, um zu überprüfen, ob Cookies richtig gesetzt sind oder nicht. Hier sehen Sie Folgendes:

• von AEM generiertes cq3session -Cookie
• das vom CFC generierte Switch-Cookie für den Anzeigemodus
• ein Cookie mit dem Namen JSESSIONID; dieses wird automatisch von JSP erstellt, wenn es nicht explizit mit <%@ page session="false" %> deaktiviert wird:

C-0-#000393 -> [Cookie: Show=ShowMode; cq3session=3bce15cf-1575-1b4e-8ea6-0d1a0c64738e; JSESSIONID=4161a56b-f193-d748-88a5-e09c5ff7ef2a ]
C-0-#000514 -> [ ]
S-0-#000000 -> [HTTP/1.0 200 OK ]

Der Server schließt die Verbindung 0 nach der Anfrage. Keep-Alive ist nicht möglich, da die Anfrage ein Fragezeichen aufweist. Das bedeutet, dass der Server keine zwischengespeicherte Version zurückgeben kann und daher die Inhaltslänge zu diesem Zeitpunkt nicht ermitteln kann, was für eine Keep-Alive-Verbindung erforderlich ist.

S-0-#000017 -> [Connection: Close ]
S-0-#000036 -> [Server: Communique Servlet Engine/3.5.5 ]
S-0-#000077 -> [Content-Type: text/html;charset=iso-8859-1 ]
S-0-#000121 -> [Date: Tue, 14 Dec 2004 09:46:44 GMT ]
S-0-#000158 -> [Set-Cookie: JSESSIONID=4161a56b-f193-d8-88a5-e09c5ff7ef2a;Path=/author ]
S-0-#000232 -> [ ]

Hier beginnt der Server, den HTML-Code bei Verbindung 0 zu senden:

S-0-#000234 -> [<html> ]
S-0-#000242 -> [.<head> ]
S-0-#000251 -> [..<title>Welcome</title> ]
S-0-#000277 -> [.</head> ]
S-0-#000287 -> [.<body> ]
S-0-#000296 -> [..Welcome to Playground<br> ]
S-0-#000325 -> [..<img src="/author/logo.gif"> ]
S-0-#000357 -> [.</body> ]
S-0-#000367 -> [</html>]

Die Verbindung 0 wird unmittelbar nach dem Bereitstellen der HTML-Datei geschlossen:

C-0-Finished: 516 bytes (0.0 kb/s)
S-0-Finished: 374 bytes (0.0 kb/s)

Jetzt beginnt die Ausgabe für Verbindung 1, die das im HTML-Code enthaltene Bild herunterlädt:

C-1-#000000 -> [GET /author/logo.gif HTTP/1.1 ]
C-1-#000031 -> [Accept: */* ]
C-1-#000044 -> [Referer: http://localhost:4444/author/prox.html?CFC_cK=1102936796533 ]
C-1-#000114 -> [Accept-Language: de-ch ]
C-1-#000138 -> [Accept-Encoding: gzip, deflate ]
C-1-#000170 -> [User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0) ]
C-1-#000234 -> [Host: localhost:4444 ]

Der Client fordert erneut eine Keep-Alive-Verbindung an:

C-1-#000256 -> [Connection: Keep-Alive ]
C-1-#000280 -> [Cookie: Show=ShowMode; cq3session=3bce15cf-1575-1b4e-8ea6-0d1a0c64738e; JSESSIONID=4161a56b-f193-d748-88a5-e09c5ff7ef2a ]
C-1-#000401 -> [ ]
S-1-#000000 -> [HTTP/1.0 200 OK ]

Für Verbindung 1 kann der Server Keep-Alive-Funktion bereitstellen, da das Bild statisch ist und daher die Inhaltslänge bekannt ist.

S-1-#000017 -> [Connection: Keep-Alive ]
S-1-#000041 -> [Server: Communique Servlet Engine/3.5.5 ]
S-1-#000082 -> [Content-Type: image/gif ]

Der Server gibt die Inhaltslänge des Bildes für Verbindung 1 zurück:

S-1-#000107 -> [Content-Length: 124 ]
S-1-#000128 -> [Date: Tue, 14 Dec 2004 09:46:44 GMT ]
S-1-#000165 -> [ ]

Nachdem die Inhaltslänge festgelegt ist, sendet der Server die Bilddaten für Verbindung 1:

S-1-#000167 -> [GIF87a..........................,.......
...I....0.A..8......YDA.W...1..`i.`..6...Z...$@.F..)`..f..A.....iu.........$..;]

Nachdem der Keep-Alive-Timeout erreicht wurde, wird auch die Verbindung 1 geschlossen:

S-1-Finished: 291 bytes (0.0 kb/s)
C-1-Finished: 403 bytes (0.0 kb/s)

Das obige Beispiel ist vergleichsweise einfach, da die beiden Verbindungen nacheinander auftreten:

• zuerst gibt der Server den HTML-Code zurück.
• dann fordert der Browser das Bild an und öffnet eine neue Verbindung.

In der Praxis kann eine Seite viele parallele Anforderungen für Bilder, Stylesheets, JavaScript-Dateien usw. generieren. Dies bedeutet, dass die Protokolle überlappende Einträge von parallelen offenen Verbindungen aufweisen. In diesem Fall empfiehlt Adobe die Verwendung von Option -i, um die Lesbarkeit zu verbessern.