Skip to main content

Charles Proxy

Overview

In this guide, we'll be walking through how easy it is to set up Charles with your virtual Corellium device.

Following along with this guide has the following prerequisites:

  1. You must have Charles Proxy installed. If you don't have Charles, head over to the Charles Proxy website and download the latest version. For this demo, we're using Charles version 4.6.1 on a MacBook Pro with an iOS-based virtual device. If you haven't tried Charles before, be sure to check out the free 30-day trial.

  2. You must be connected to the Corellium VPN. If you haven't connected before, check out our Connect to the Corellium VPN article.

Confirm VPN Address and Port

The first thing you'll need to do is confirm the VPN address assigned to your local machine and the port that Charles is listening on.

  1. After connecting to the VPN, open a Terminal window and run the ifconfig command.

  2. At the end of the ifconfig output, you will see inet. Your VPN IP address is to the right of inet. In the example output below, your IP address would be 12.34.567.8.

ether 10:34:7a:4c:9b:4e
inet 12.34.567.8 netmask 0xfffffc00 broadcast 10.11.3.255
media: autoselect
status: active
open (pid 58642)
  1. In Charles, click the Settings icon, and then Proxy Settings.

Charles settings

  1. Make note of the default port Charles uses, in this case, 8888.

Charles port number

Configure the Virtual Device

  1. Now, on your device, click the Settings Icon.

settings icon

  1. Click Wi-Fi.

Click on WiFi

  1. Click the info icon.

Click i icon

  1. Click Configure Proxy.

config-proxy

  1. Check Manual, then enter the IP address from step 2 of the Confirm VPN Address and Port section next to Server (12.34.567.8) and the default port from step 4 of the Confirm VPN Address and Port section next to Port (8888). Then, click Save.

Configure the proxy manually

  1. You will receive a prompt from Charles notifying you of a connection attempt, click Allow.

Charles dialog

  1. Swipe up on the device screen to return to the home page and click the Safari icon. Then, search for something to validate we are intercepting traffic. You should see the website appear in Charles.

intercepting traffic with Charles

Troubleshooting

  • If you have set up your proxy and are not able to see traffic, try closing and restarting your VPN session. Ensure that you can ping the IP address from the virtual device console.
  • Remember, you may not be able to reach HTTPS websites without proper trust certificates installed.
  • If the issue persists, contact your network administrator to determine if any local network configurations may be blocking or interfering with the virtual device network.

Further Questions

We hope this demonstrates how simple it is to get Charles set up with your virtual device! Feel free to check out our community Slack as well as our online knowledge base if you have any additional questions along the way.

Happy Virtualizing!