Introduction

It’s recommended to perform end-to-end testing of your Rover integration after completion of the initial installation and on an ongoing basis after making any changes in your app proximate to Rover.

Rover features two web-based apps that will be used by the marketers and publishers on your team to run their campaigns, namely, the Audience and Campaigns apps. We’ll be using them here to validate that Rover is working properly end-to-end.

Make sure you’ve completed all of the prior steps in the Getting Started guide. Experiences and Location/Proximity are optional.


Inspecting HTTP traffic with Charles

Many steps in the test procedure involve validating that the Rover SDK is successfully communicating with the Rover cloud services as expected and at the right times.

As such we prescribe using the Charles HTTP proxy app, which by standing between your app and the web as an HTTP proxy allows you to inspect HTTP traffic in manner similar to tools like the Network Tab of your favourite browser’s Web Inspector.

Setup

Charles is a paid shareware application, but the trial is suitable for getting started. You can find it at https://www.charlesproxy.com.

For our purposes you do not need to set up Charles as a proxy on your local worksation, so when it prompts you to automatically do so at first run you do not need to agree.

Set up Proxy on Device

Ensure your iPhone or iPad is on the same network, or can otherwise reach the machine running Charles. Once it is running, determine the local IP address of your workstation.

Then, enter your iPhone or iPad’s Settings, select “Wi-Fi”, select the Information icon on the right side next to your local Wi-Fi, select “Configure Proxy”, and finally select “Manual”.

Then, enter your workstation’s local IP and the port 8888, which is what Charles listens on by default.

Enable Charles CA

Charles will prompt you to allow connections coming from the device on the first connect request made by anything running on the device.

Trust Charles CA on Device

Then, the next step is to configure HTTPS proxying such that Charles will be appear to peer into the otherwise encrypted conversation the Rover SDK will have with the Rover web API.

Visit http://chls.pro/ssl on the device. You will be prompted to install a Certificate Authority.

After doing so, you will need to explicitly mark it as trusted in your Trust Settings.

Navigate back to Settings, select “General”, select “About”, and select “Certificate Trust Settings” all the way down at the bottom. Ensure the switch for your newly installed Charles CA is enabled.

Enable Charles CA

Enable SSL Proxying

Charles injects itself as a man-in-the-middle only for those HTTPS (SSL/TLS) connections that you configure it to do so for.

In Charles, under the Proxy menu, select “SSL Proxying Settings”. Add api.rover.io with port 443 in Charles.

Enable Charles CA

See Traffic Flowing

Launch your app on the test device, and you should presently see a request to the Rover API get captured:

Charles Example Traffic