Debugging client.events

In some rare cases, in coordination with the TigerConnect support team, we may ask for a web debugging proxy application to be installed on test systems so that we can diagnose issues. Our preferred software to install in these situations is Charles Proxy, though other alternatives are also possible. The following instructions detail how to configure Charles Proxy for use with TigerConnect.

Installation Steps for Charles

  • Download and install Charles Proxy. Pick the latest release.
  • Open Charles
  • Visit Help menu -> SSL Proxying -> Install Charles Root Certificate
  • If you're using OS X, locate the Charles Proxy certificate in the Keychain Access program, right click, choose Get Info, expand the Trust section, and set When using this certificate to Always Trust
  • In Charles, visit Proxy menu -> SSL Proxying Settings. Click Enable SSL Proxying. Add the following locations to the Include section:
    • api.tigertext.me, port 443
    • uat-devapi.tigertext.me, port 443
    • If you want insight into any other domains, feel free to add them here as well
  • In Charles, visit Proxy menu and make sure that macOS Proxy has a checkmark next to it; if you don't see a checkmark, click on that menu item
  • Now when you restart your web browser and log into a website with the JS SDK embedded, you should see entries in Charles for the relevant api.tigertext.me or uat-devapi.tigertext.me domain; when expanded, you should see a call for /v5/events with some data.

Charles: Common Issues

  • If the domain has an <unknown> entry underneath, you may need to check your proxying settings and potentially restart Charles, the web browser, and/or your computer
  • If you don't see an entry for api.tigertext.me or uat-devapi.tigertext.me, then you might need to click on the Start Recording button and then log in again through the website containing your JS SDK integration.