HTTP/S Proxy Recorder
By using an HTTP/S Proxy Recorder, the HTTP/S traffic from Web browsers and technical Web clients can be recorded and easily converted into a HTTP Test Wizard session.
The HTTP Test Wizard session can then be debugged and post-processed. Finally, an executable test program can be generated from the recorded session.
An HTTP/S Proxy Recorder has two service ports:
- A Control Port that is addressed by the portal server.
- A Proxy Port that records the data traffic from a Web browser or from a technical Web client.
All data traffic that passes through the proxy port is first decrypted by the Proxy Recorder and then encrypted again before it is forwarded to the target Web server(s).
In order to record a Web surfing session by a Web browser you have to start two different Web browser products on your local machine. For example:
- A Chrome browser to operate the portal server (Web Browser 1), and
- A Firefox browser to record the Web surfing session (Web Browser 2)
We recommend to use always Firefox as Web Broser 2.
To be able to record a Web surfing session, you have to reconfigure Web Browser 2:
- Import the Proxy Server CA Root Certificate into the Web Browser 2.
- Configure the Network Settings of Web Browser 2 to use the Proxy Server.
Additional note: Before you start recording a Web surfing session in Web Browser 2, you must always clear the browser cache.
Once the recording is completed you should undo the configuration changes in Web Browser 2 (restore the original network settings and delete the Proxy Server CA Root Certificate).
Registering a Proxy Recorder at the Portal
After you have started a HTTP/S Proxy Recorder as a cloud instance or installed it on one of your systems, you have to register it at the Portal Server.
You can set any user name and password for Proxy Authentication. The Control API Authentication Token was defined/set by the person who started or installed the Proxy Recorder.
Once you have registered the Proxy Recorder you can try to ping it on the application level:
Then try to connect to the Control Port of the Proxy Recorder. If this works, the Proxy Recorder is now ready for use.
Configuring Web Browser 2 for Recording
Import the Proxy Server CA Root Certificate
Click at the certificate icon and store the certificate at any location.
Then open the Web browser settings and import the certificate.
Since there is a small bug in some versions of Firefox, you have to close and reopen the Certificate Manager to view the imported certificate.
Configure the Network Settings
Recording a Web Surfing Session
Navigate with Web Browser 1 to the Proxy Recorder control menu.
Then configure the “Hosts Recording Filter” and click on the “Start Recording” icon.
In Web Browser 2, first clear the browser cache and then enter the URL where you want the recording to start.
In Web Browser 1 you can now see the recording of the first page. Before navigating to the next page in Web Browser 2, first insert a “Page Break” in Web Browser 1 with a brief description of the next page.
Then naviagate to the next page in Web Browser 2.
In Web Browser 1 you can now see the recording of the next page.
Then continue as before. Insert a Page Break in Web Browser 1, navigate to a next page in Web Browser 2. and so on …
After you have done the recording click on the “Stop Recording” icon. Then convert the recording into an HTTP Test Wizard session.
Converting the Recorded Session
Here you can select different options. The HTTP Status Code Filter also supports * as a wildcard. An exclamation mark in the font of a value means “do not / exclude”.
The option Enable Parallel Execution of HTTP Requests should be enabled if you have recorded a session with a Web browser (as described above), but should be disabled if the recording was performed by a technical Web client.
Once you have clicked on the Convert button, the recorded session is converted and directly loaded into the HTTP Test Wizard.
After that debug the converted session in the HTTP Test Wizard and then save the HTTP Test Wizard session. Finally generate and execute the test.