Setting up Apple Configurator and Charles to Proxy an Apple TV

Configurator is a tool used to add configuration profiles to Apple devices.

Prerequisites

• Apple Configurator to set up your profile.
• Charles Proxy version 3.10 or later.

Set up Charles Proxy

Configuring Charles Proxy

1. Navigate to the Proxy > Proxy Settings… menu.
2. On the Proxies tab in the HTTP Proxy Port field, enter 8888.
   

   

3. Navigate to the Proxy > SSL Proxying Settings… menu.
4. On the SSL Proxying tab, select the Enable SSL Proxying checkbox.
   

   

5. Navigate to Help > SSL Proxying > Install Charles Root Certification a Mobile Device or Remote Browser….

The IP address listed on the dialog will be used later in the Apple Configurator setup.

6. Navigate to https://charlesproxy.com/getssl to download the SSL certificate.

Note the download location of the certificate.

Export the Charles certificate

To export the Charles certificate:

1. Open Keychain Access.
2. Navigate to File > Add Keychain and select the certificate downloaded in step 6 above.
3. Select the Charles Proxy Custom Root Certificate checkbox.
4. Navigate to File > Export Items and export the certificate as a .cer file to a location on your local drive, noting the location.

Apple Configurator Setup

Create a configuration profile using Apple Configurator

To create a configuration profile using Apple Configurator:

1. Navigate to Open > New Profile.
2. Enter a name and unique identifier for this profile.
3. From the left menu, click Global HTTP Proxy.
4. Under Proxy Server and Port, enter the IP address and port from Configuring Charles Proxy step 5 above.

5. Select Certificates from the left menu and select the .cer file you previously exported via Keychain Access.
6. Select File > Save to save the profile to your Mac, noting the location of the file.

Set up Apple TV

Installing a configuration profile on Apple TV

1. Connect the Apple TV to your Mac via USB. The Apple TV will appear under All Devices in Configurator.
2. Select the Apple TV and click Add in the top menu.
3. Click Profiles and select the SSL certificate downloaded in Configuring Charles Proxy step 6 above. This will copy the configuration profile to the Apple TV.
4. Traffic from the Apple TV will now be proxied through Charles.

Removing a configuration profile from Apple TV

After debugging, you must remove the profile from the Apple TV to stop proxying. To do so:

1. In Configurator, double click the device.
2. From the left menu, click Profiles.
3. Select your configuration profile and select Edit > Delete.