Set up Charles to proxy an iOS device

Configure Charles

To configure Charles:

1. Open the Proxy > Proxy Settings… menu.
2. Click the Proxies tab, in the HTTP Proxy Port field and enter 8888.
   

   

3. Open the SSL Proxying Settings… menu.
4. On the SSL Proxying tab, select the Enable SSL Proxying checkbox.
   

   

   • By default, Charles will only perform SSL proxying for specific domains you include in the list.
   • Click Add, and enter *.* in the location list above.
   • If your app ceases to function correctly, it’s possible that the app is rejecting the self-signed certificate from Charles proxy. If this happens, disable the wildcard match, and list only the *.tealiumiq.com and *.tiqcdn.com Tealium domains.
5. Go to Help > SSL Proxying > Install Charles Root Certification a Mobile Device or Remote Browser…
   

   

6. Make note of the instructions, specifically the IP address and URL to get the certificate, for example: 10.0.2.158 and http://charlesproxy.com/getssl

Configure your iOS device

To configure your iOS device:

1. Go to Settings > Wi-Fi and connect to the same Wi-Fi network as your computer.
2. Select the active Wi-Fi network details, and in the HTTP Proxy section select the Manual mode.
3. In the Server and Port fields, enter the IP address and the port number (for example, 8888) from the steps above.
   

   

4. After you save your proxy settings on your iOS device, you will receive an alert from Charles on your computer asking you to allow the connection. Click Allow.
   

   

Install the Charles SSL certificate

To install the Charles SSL certificate on your iOS device:

1. On your iOS device, open Safari and navigate to http://www.charlesproxy.com/getssl.
2. Follow the instructions to install the certificate and allow the access.
   

   

For more information, see Using Charles SSL Certificates

Ensure the device trusts the certificate by going to Settings > General > About > Certificate Trust Settings. If the certificate is not trusted, SSL requests will fail in the proxy.