iOS Simulator

How to install Proxyman Certificate to iOS Simulators

In order to capture the HTTP/HTTPS message from your iOS Simulator devices, please navigate to:

  • Certificate Menu -> Install Certificate on iOS -> Simulators

iOS Simulator Setup Guide

It works for iOS, iPadOS, tvOS and watchOS.

The following photo describes three steps:

  1. Install Root Proxyman Certificate on your machine: You can follow the macOS Guide.

  2. Install Proxyman Certificate to all available simulators, which you have opened at least one time.

  3. Reset the Simulator: Proxyman tries to reset all simulators, so it will load the new Certificate.

From Proxyman 2.19.0+, Proxyman uses the simctl command line to perform tasks.

simctl is a built-in on your installed Xcode, which is modern and reliable than the legacy approach (Use custom scripts). If simctl doesn't work, you can switch back to the legacy in Preference -> Advanced Tab -> Use the `simctl` for iOS Simulators.

This step only installs on Simulators, which you have open at least one time

For instance, if you would like to debug on iPhone X Simulator, please make sure to open the iPhone X Simulator first, then installing the Certificate in Step 2

Troubleshooting

1. I am still unable to see HTTPS Response and get SSL Error from my iOS Simulator

  • Opening the Setting app -> General -> About -> Certificate Trust Settings and verify that Proxyman Certificate is installed and trusted

Proxyman Certificate is installed and trusted properly

If it's not installed, please open the iOS Simulator Setup (Certificate Menu -> Install Certificate on iOS -> Simulator) and click on the 2nd button.

If it does not work again, please try using Legacy Code in Proxyman Preference -> Advanced -> Un-check `Use simctl for iOS Simulator` then trying again.

Alternative approach

If you could not install the certificate, you can manually do it:

  1. Export the Proxyman Certificate: Certificate Menu -> Export Proxyman Certificate -> Select Desktop folder and Save

  2. Open the Simulator and drag the certificate and drop it on the Simulator screen

  3. Quit the Simulator and re-open

SSL Proxying

After the installation, we can start capture and view HTTPS messages by following SSL Proxying Doc ‚Äč

Tutorial

See detailed steps to debug an application on iOS Simulator with Proxyman