Validation tools

To validate that your integration complies with INVIDI Pulse requirements, we run a series of tests and ensure that certain criteria have been met. Charles Proxy is a cross-platform HTTP debugging proxy server application that we recommend to conduct the Validation test cases because it has dependable tools to help map and throttle HTTP requests for apps. Charles Proxy is available for download here, where a free trial version is also available.

It is not mandatory to use Charles. If you choose to, you can use some predefined test scenarios that we have set up with rewrite rules presets. Using HTTP rewrites is recommended as it is a faster way to test the application because you do not have to modify, compile, and deploy the code.

We recommend that you follow the steps in this order, but it is not mandatory. The following examples are based on Charles Proxy version 4.5.6.

Set up SSL Proxying in Charles

The following steps explain how to add videoplaza.tv as a host name to the SSL Proxying list.

  1. Go to Proxy > SSL Proxy Settings
  2. Select Enable SSL Proxying
  3. Click Add
  4. Under Host, enter *videoplaza.tv
  5. Click OK

You will need to trust and install the Charles Root Certificate on your device before you can successfully use Charles as a proxy and see the network traffic. See SSL Certificates on the Charles Proxy website for instructions for trusting and installing the Charles Root Certificate depending on your device.

Configure Charles to use rewrite rules presets

The following steps explain how to add the Pulse rewrite rules that have been preset to reflect the Pulse validation process test cases.

  1. Download Pulse_charles_rewrite_rules.xml to your computer
  2. Go to Tools > Rewrite. A Rewrite Settings window pops up

    Charles rewrite settings window empty state

  3. Select Enable Rewrite
  4. Click Import. The folder window of your computer pops up.
  5. Select the file Pulse_charles_rewrite_rules.xml from where the file was downloaded. The Rewrite Settings window is now updated with the test sets

    Charles rewrite settings window

  6. Select the test case that you want to run. Only one test case should be selected at a time.
    Note: If multiple test cases are selected, they are applied in the order they appear in the list. This may result in an unintended scenario.
  7. Click OK

Configure Charles to use Pulse throttling presets

For general test case T-001 (Timeout during ad request to Pulse ==> Start content playback), you can use a Pulse preset in Charles. Follow the next steps to import the settings into Charles.

Note: Remember to turn throttling off when you are not testing the T-001 (Timeout during ad request to Pulse ==> Start content playback) test case.
  1. Download Pulse_Charles_Throttling.xml to your computer
  2. Go to Proxy > Throttle Settings. A Throttle Setting window pops up

    Charles throttle settings window

  3. Select Enable Throttling
  4. Click Import. The folder window of your computer pops up.
  5. Select the file Pulse_Charles_Throttling.xml from where the file was downloaded. The Throttle Settings window is now updated with the throttling preset:

    Charles throttle settings window

  6. Click OK

Filter logs in Charles

The following steps explain how to filter the logs to only see traffic going to and from videoplaza.tv. Content with ads needs to be playing in the background for Charles to start logging data.

  1. Go to View > Sequence

    Charles sequence window without filters

  2. Add filter distributor|tracker
  3. Click Settings
  4. Select Filter uses regex
  5. Click OK. Your logs now reflect only traffic going to and from videoplaza.tv.

    Charles sequence window with filters