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:
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.
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.
After connecting to the VPN, open a Terminal window and run the
ifconfig
command.At the end of the
ifconfig
output, you will seeinet
. Your VPN IP address is to the right ofinet
. In the example output below, your IP address would be12.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)
- In Charles, click the Settings icon, and then Proxy Settings.
- Make note of the default port Charles uses, in this case, 8888.
Configure the Virtual Device
- Now, on your device, click the Settings Icon.
- Click Wi-Fi.
- Click the info icon.
- Click Configure Proxy.
- 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.
- You will receive a prompt from Charles notifying you of a connection attempt, click Allow.
- 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.
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!