Charles is a web proxy that helps you record data that is sent and received between your web browser and the server. It makes network debugging easier by capturing network logs.
Download Charles Proxy
Download the latest version of Charles Proxy from this location. Run Charles Proxy on your system. From the menu, select Proxy > Proxy Settings. Make sure that you have assigned a port (e.g., 8888) and selected the Enable transparent HTTP proxying option.
Install Charles root certificate
Install the Charles Root Certificate so that it is trusted by all applications.
On macOS
1. Navigate to the Help menu of Charles. Go to SSL Proxying and select Install Charles Root Certificate.
2. Keychain Access will open automatically. Locate the entry related to Charles Proxy and double-click it.
3. In the window that opens, expand the Trust section. Set the trust settings for the certificate to Always Trust from the When using this certificate pop-up menu.
Note: You will be prompted for your administrator password to update the system trust settings.
4. Close the certificate window. Then, restart the browser for a successful installation.
On Windows
1. Navigate to the Help menu of Charles. Go to SSL Proxying and select Install Charles Root Certificate.
2. A window appears warning you that the CA Root certificate is not trusted. Click the Install Certificate tab to launch the Certificate Import Wizard.
3. Leave the current user button selected, and click Next.
4. On the Certificate Store screen, select Place all certificates in the following store. Click the Browse button and select Trusted Root Certificate Authorities.
5. Import the certificate into the Trusted Root Certification Authorities, overriding certificate store selection, and click Next.
6. Click Finish on the Completing the Certificate Import Wizard screen.
7. Restart your open browsers to complete the installation.
Enable and set up SSL proxying
1. Open Charles and from the menu, navigate to Proxy > SSL Proxy Settings > SSL Proxying. Check the Enable SSL Proxying option.
2. In the Location section, select Add. In the pop-up window, enter * (a single asterisk) for the following hosts:
> *.adobe.io (COPS and ROBS are behind Adobe I/O)
> *.adobelogin.com (IMS login and token access)
> *.licenses.adobe.com (NGL workflow servers)
> or*.corp.adobe.com (Adobe federated identity servers, only needed for Type3 login or proxy problems)
3. Select OK to save this change. This action will enable SSL proxying for all these hosts.
4. By default, Charles will begin recording the session when you run it.
5. To ensure that Charles is recording the domains, open the Recording > Recording Settings dialog box and navigate to the Include tab. After this, open the SSL> SSL Proxying Settings dialog box and navigate to the SSL Proxying tab. This will show you a checked list of all domains. Click OK.
Proxy settings
Enable Charles to automatically turn proxying on when you start recording and turn it off when you stop recording.
> For Mac, go to the Proxy menu and ensure that macOS Proxy is checked.
> For Windows, go to the Proxy menu and ensure that Windows Proxy is checked.
Recording sessions in Charles
1. Charles automatically begins a new session upon launch. To turn recording off or on, click on the red Record button.
Note: When Charles launches, you can set your preferences not to record. This will leave it running without recording anything.
2. To save Charles's recordings, navigate to File > Save Session As. Give a name to the session and save it to your preferred location.
Credits:
Created with an image by KK Studio - "Surface Rainbow colorful flavored ice cream, Top view Food concept, Blank for design."Ashish Harrison