Requestly
Search…
⌃K
Links

iOS interception

How to setup your iOS device for interception with Requestly
Setting up an iOS device requires the following one-time manual setup.
In case you forget, you can get these detailed steps inside the desktop app by navigating to Connect App -> iOS

Setup the proxy

  1. 1.
    Download the Requestly Desktop app, if you haven’t already.
  2. 2.
    Start the App and make sure that your iOS device and your computer are on the same network
  3. 3.
    Navigate to Settings -> Wi-Fi -> Select current Wi-Fi -> Configure Proxy
  4. 4.
    Set the proxy settings to Manual and then enter the IP address of the computer and the proxy port. You can find these on the top banner inside the Requestly desktop app
  5. 5.
    To ensure that the proxy has been set, visit https://amiusing.requestly.io. If the rendered page shows success as follows, means the proxy is now correctly configured
setting up proxy in iOS wifi settings

Download the SSL certificate as a custom profile

  1. 1.
    Now open Safari and go to https://requestly.io/ssl (remember to use HTTP, not HTTPS).
  2. 2.
    This should download a custom profile on your device which contains the Requestly CA certificate
a. alternatively you could download this certificate as follows from the Requestly desktop app
b. But make sure to transfer it to the device either using airdrop or by emailing it to yourself. Only then will the iOS device identify it as a custom profile
Download custom iOS profile

Install the custom profile

  1. 1.
    Now to install the downloaded custom profile go to Settings. You should see a new option at the top that says Profile Downloaded. Select that to install the profile
  2. 2.
    Click on Install. This will also ask you to enter your pin/passphrase. Once everything is complete, click Done on the top right to finish the installation and navigate out
Install the new custom iOS profile

Enable trust for SSL certificate

  1. 1.
    Finally, you need to enable trust for CA certificates that were installed along with this custom profile. Go to Settings -> General -> About -> Certificate Trust Settings
  2. 2.
    You should see a certificate by the name of RQProxyCA. Enable the trust for this certificate
enable trust for Requestly's certificate authority for intercepting HTTPs traffic

Reverting the setup

Remember to disable the HTTP Proxy in your Settings when you stop using Requestly, otherwise, you'll get confusing network failures in your applications!
You just need to set the network proxy the next time you want to debug with Requestly.