Share this page

# Record using a proxy

This topic describes working with a proxy server when recording scripts.

In this topic:

## About recording using a proxy server

VuGen allows you to record scripts using a proxy, to resolve situations where you cannot install VuGen on the client machine. This may be the case with certain Linux machines, Mac OS machines, and mobile devices.

When using this option, the VuGen machine acts as a proxy server capturing all the traffic from the client machine to the target server. After the business process has been recorded, VuGen creates a script.

The following diagram illustrates the basic workflow (for recording using a proxy on a Linux machine):

## Considerations for recording using a proxy

The following provides information and prerequisites for recording using a proxy:

Item | Description
--- | ---
Supported only for some protocols | Recording with a proxy is not available for all protocols. Partial list of supported protocols: Web - HTTP/HTML, Java over HTTP, Oracle NCA, and Oracle - Web
Allow proxy configurations | The client must allow proxy configurations, meaning, you must be able to specify the port and the address of the VuGen machine on the client device or machine. Some mobile native applications cannot be recorded in proxy mode. For example, the device might not support proxy, or the application simply ignores the device’s proxy. In these cases, other approaches might help, such as recording the traffic on the server side.
Same network | The client device or machine and the VuGen machine must be in the same network.
Delete browsing history | Make sure to delete the client machine's browsing history prior to recording the business process. This is because VuGen cannot bypass the browser's cache and history settings on the client machine. Deleting the browsing history enables VuGen to accurately record your business process using a proxy.
HTTP forwarding to multiple targets | If multiple target machines are present, the VuGen proxy can correctly forward data to the right target server according to the Host HTTP header.
Forwarding to target server via Internet proxy server | You can configure the VuGen machine to establish a connection with your organization's internet proxy by selecting the Remote Application via proxy mode in the Start Recording dialog box. For details, see Start Recording dialog box.
HTTPS (SSL/TLS) support for mobile devices | To record and decrypt HTTPS traffic, the proxy uses its own certificate to set up a secure connection with the mobile device, and uses the certificate of the actual server to establish a secure connection with the server. For the browser to work with the proxy over a secure connection, you need to either declare a security exception, or install a root certificate. For details on importing an SSL certificate, see Use case 3: Client uses SSL. Note: Some native mobile applications might reject the installed root certificate due to their own internal rules, and HTTPS traffic will fail to record. If this happens, contact your application’s developer for a workaround.

## Use cases for recording using a proxy

The following use cases describe various methods for recording a script using a proxy server. In all use cases, the client machine and VuGen machine are in the same network.

- Use case 1: VuGen not installed on client machine
- Use case 2: Record using proxy on mobile
- Use case 3: Client uses SSL
- Use case 4: VuGen and the application under test on the same machine

### Use case 1: VuGen not installed on client machine

You want to record a business process but you cannot install VuGen on the machine (or device) running the application.

1. Create a new Web - HTTP/HTML script.

2. Start recording.

   1. From the Start Recording dialog box, select Recording Mode > Record > Remote Application via Proxy. For details, see Start Recording dialog box.

   2. Specify the port on which the proxy will listen, by default, port 8888.
   3. Check the Display recording toolbar on client machine. This allows you to see and interact with the recording toolbar on the client machine.

   4. If the client machine requires a proxy to access the Internet, set the global proxy conditions. Search the Control Panel or System settings for proxy settings. Manually set the proxy with the server and port. You can also set the proxy setting per browser. Refer to your browser's documentation to learn how to configure its proxy server. Automatic configuration scripts are not supported.

   5. Click Start Recording.

3. On the client machine, delete the browser cache.

4. Configure the client machine browser settings to specify the VuGen machine as the proxy server. Use the VuGen's machine IP for the address, and specify the port on which the proxy will listen. Search the Control Panel or System settings for proxy settings.

5. Record the business process.

   1. Navigate to your application.

   2. Perform the steps of your business process you want to record.

6. Generate the script.

   Select Stop Recording from either the Recording Toolbar on the client machine or the Floating Recording Toolbar on the VuGen machine. VuGen generates the script.

   Note: It is common for business processes to use SSL communication even when not explicitly displaying a URL with HTTPS. In this case, a certificate may be required. Refer to Use case 3: Client uses SSL for more information on obtaining the certificate.

### Use case 2: Record using proxy on mobile

You want to record an application on a mobile device. This could be a web application, or native mobile applications that use HTTP and HTTPS as the transport.

1. If your app uses the Internet and your network requires a proxy to access the Internet, specify the proxy settings on your VuGen machine. For example, in Chrome, select Settings > System > Open your computer's proxy settings. In the Manual proxy setup section, enter your proxy information and click Save.

2. On the mobile device, clear the default browser's cache.

3. Configure your mobile device to use the VuGen machine's proxy. For example,

   - For an iOS device, select Settings > Wi-Fi > HTTP Proxy > Manual. In the Server field enter the IP of the VuGen machine, and in the Port field enter the port through which VuGen will listen.
   - For an Android device, select Settings > Wi-Fi >. Tap and hold the network name, or tap the More button to see additional settings (this may vary depending on your version of Android) . In the Proxy area add the proxy information—the IP and port of the VuGen machine.

4. Create a new Web - HTTP/HTML script.

5. Start recording.

   1. In VuGen, click Record > Record to open the Start Recording dialog box.
   2. In the Recording Mode dropdown, select Remote Application via Proxy . For details, see Start Recording dialog box.
   3. Specify the port on which the proxy will listen, by default, port 8888.
   4. Check the Display recording toolbar on client machine. This allows you to see and interact with the recording toolbar on the mobile browser.
   5. Click Start Recording.

6. Open the application under test from the browser on your mobile device and perform the steps of your business process you want to record. All web traffic will be recorded by VuGen. If VuGen records traffic that is not related to your application, you can remove it after the script is generated.

Note: If your web application uses SSL, you may need to install a certificate. For details, see Use case 3: Client uses SSL.

### Use case 3: Client uses SSL

Your application communicates uses SSL.

1. Prepare to import the SSL certificate to the client machine.

   Note: As an application developer, you can set certain policies on the server certificate when using SSL. However, only if the OpenText Professional Performance Engineering certificate conforms to the policy, can the client trust the server and the SSL connection be set.

2. Download the certificate, by navigating to:

   http://<computer name of VuGen machine>:port/proxyroot.cer

   or

   http://<ip address of VuGen machine>:port/proxyroot.cer

   Note: If you experience security restrictions, navigate to:

   http://<computer name VuGen machine>:port/proxyroot.dat

   or

   http://<ip address of VuGen machine>:port/proxyroot.dat

   After downloading the certificate, change the .dat extension back to .cer to import the certificate.

3. Import the SSL certificate. Refer to your browser's documentation on how to import a certificate.

Certain native mobile apps use custom rules to determine which certificates to accept. As a result, the certificate may be rejected. Consult with the application's developer to allow the certificate.

### Use case 4: VuGen and the application under test on the same machine

You want to do a proxy recording of a local application that uses the system proxy, where VuGen and the application under test are on the same machine:

1. Create a new Web - HTTP/HTML script.

2. Set the recording option.

   Open the recording options (Recording > Recording Options) and select the HTTP Properties > Advanced node. Enable the Use the Performance Engineering Proxy to record a local application.

3. Start recording.

   1. Open the Start Recording dialog box.

   2. In the Recording mode section, select Record: Web Browser.

4. Perform the business process.

   1. Navigate to your application.

   2. Perform the steps of your business process you want to record.

## After recording

After a proxy recording session, VuGen automatically resets the proxy back to its original setting. If the recording did not end in the normal way, for example, if your application crashed during recording, you may need to manually set the proxy back to its original value. Go to the Network and Internet settings for your machine, and disable the proxy.

For mobile devices, the Wi-Fi (WLAN) proxy setting will apply to all communication to and from the mobile device. This may result in recorded traffic that is not related to your application, such as your email client. You can manually remove these additions after the script is generated.

https://admhelp.microfocus.com VuGen,Professional Performance Engineering,Performance Engineering for Developers 8942
Tips to improve your search results... OpenText™ Virtual User Generator Help Center OpenText™ VuGen Help 26.1-26.3 All View Local Help Center View Online Help Center Version: