quickstartproxy.md

In this demo you will

• Install Java 11
• Start locally HAM server
• Connect to it through proxy

Download the ham tar.gz from github releases and extract it

Ensure your application is calling -ONLY- http pages or it will not record the interactions content

Configure proxy

Should set the proxy to 127.0.0.1 And port 1080 for socks5 or 1081 for http/https

Click me for more explanations

• Chrome:

  • Install Proxy Switch Omega
  • Go to options
  • Add http and https proxy server with

    • Address: 127.0.0.1

    • Port 1081.

      
  • Select "proxy" from the extension menu and back to "direct" when you want to disconnect
  • 

• Firefox

  • Navigate to about:preferences

  • Search for "proxy"

  • Click on "Settings"

  • Go to "Manual proxy Configuration"

  • Select the socks5 proxy

    • Address: 127.0.0.1
    • Port 1080

  • Check the "Proxy DNS when using SOCKS v5" flag

  • Clean the settings when needed

    

Configure the application proxy

Here is configured for both http and https BUT only http traffic will be intercepted

On the application

• On Baeldung for java

Just add to the java command to start the application the following:

    -Dhttp.proxyHost=127.0.0.1  -Dhttp.proxyPort=1081
    -Dhttps.proxyHost=127.0.0.1 -Dhttps.proxyPort=1081

• Some C# suggestions

On HAM configuration

First ensure that all the ports called by your application are set on the file httpproxy.external.json in the "http" section. In the example here the http listen on 80, 8081 and 8082

  {
    "id": "http",
    "system": true,
    "active": true,
    "port": "80;8081;8082",
    "backlog": 50,
    "useCachedExecutor": true
  },

Run!!

Start the HAM application with the "httpproxy.run.bat/sh" Start your appplication

Record some interaction

You can now check ham application going on http://localhost

• You can create a recording on the recording page

• Once you create the recording you can start recording!

• Do some interaction on your application
• And stop the recording!
• Now you will se all the calls on the just created recording!

• "Download" the recording as "Sample.json"