Install Charles proxy for Boomi

Charles is an HTTP proxy / HTTP monitor / Reverse Proxy that enables a developer to view all of the HTTP and SSL / HTTPS traffic between their machine and the Internet. This includes requests, responses and the HTTP headers (which contain the cookies and caching information).

A proxy tool such as ‘Charles Proxy‘ offers a way for you to track information during your debugging. And it works with Boomi 🙂 This post documents how to install the Charles proxy software.

Installation example for Mac OSX

  1. Download a 30-day free trial. You can download versions for Windows-32, Windows-64, Mac OSX or Linux
  2. Open the .dmg file
  3. Press Agree to install the software
  4. Drag the App to the Applications folder
  5. Open Charles from the Applications folder or the launchpad
  6. You will now see the opening screen of the trial version (delay of 10 seconds)
  7. Press “Grant privileges” to automatically configure your network settings. Changes:
    • Firewall settings: allow incoming connections for Charles on port 8888
    • Proxy settings: reroute all http and https traffic to Charles
    • Please enter your OSX password to change these settings
  8. Please consult the Charles documentation for more information on how to use the tool

Note: the trial version runs for 30-days. It automatically stops running after 30 minutes. You can buy a licenses here. A single license costs $50. My conclusion: that’s a good investment for debugging integration processes 🙂

  1. Start Charles Proxy
  2. Go to menu
  3. On the Proxies tab, set HTTP Proxy port to 8888
  4. On the tab: Uncheck “Enable Windows Proxy” and uncheck “Enable Windows Proxy at startup”.
    • Depending on the OS your using, this tab is called Windows, Mac OSX or Linux
  5. Go to menu
  6. On SSL Proxying tab: Check “Enable SSL Proxying” and then add the domains for all the SSL Locations your Boomi processes connects to. Examples:
    • *.salesforce.com
    • *.myshopify.com
  7. Turn off your browser proxies